isBindPasskeyUrl

Last updated on Aug 1, 2023

Validates that a URL is able to be used by the bindPasskey function.

Dependencies

The isBindPasskeyUrl function requires the Beyond Identity SDK.

JavaScript

yarn add @beyondidentity/bi-sdk-js

or

npm install @beyondidentity/bi-sdk-js

Kotlin

Gradle

To enable the retrieval of Cloudsmith hosted packages via Gradle, we need to add the Cloudsmith repository to the root/build.gradle file.

repositories {
    maven {
        url "https://packages.beyondidentity.com/public/bi-sdk-android/maven/"
    }
}

After the repository is added, we can specify the Beyond Identity dependencies.

dependencies {
    implementation 'com.beyondidentity.android.sdk:embedded:[version]'
}

Swift

Swift Package Manager

From Xcode

1. From the Xcode File menu, select Add Packages and add the following url:

https://github.com/gobeyondidentity/bi-sdk-swift

2. Select a version and hit Next.
3. Select a target matching the SDK you wish to use.

From Package.swift

1. With Swift Package Manager, add the following dependency to your Package.swift:

dependencies: [
    .package(url: "https://github.com/gobeyondidentity/bi-sdk-swift.git", from: [version])
]

2. Run swift build

Cocoapods

Add the pod to your Podfile:

pod 'BeyondIdentityEmbedded'

And then run:

pod install

After installing import with

import BeyondIdentityEmbedded

React Native

Using react-native init or an expo app.

react-native init

Install the SDK with yarn or npm:

yarn add @beyondidentity/bi-sdk-react-native

npm install @beyondidentity/bi-sdk-react-native

Update native requirements in your ios and android folders:

iOS

Make sure your ios/Podfile supports "minimum deployment target" 13.0 or later

ios/Podfile

platform :ios, '13.0'

Navigate to your ios folder and run:

cd ios && pod install

Android

Make sure your android/build.gradle supports minSdkVersion 26 or later

android/build.gradle

buildscript {
  ext {
    minSdkVersion = 26
  }
}

Add the following maven url to your repositories in your android/build.gradle

allprojects {
  repositories {
    maven {
      url "https://packages.beyondidentity.com/public/bi-sdk-android/maven/"
    }
  }
}

expo

info

This package requires custom native code and can be used with Development builds or prebuild and cannot be used with Expo Go.

npx expo install @beyondidentity/bi-sdk-react-native

Add the SDK config plugin to the plugins array of your app.{json,config.js,config.ts}:

{
  "expo": {
    "plugins": [["@beyondidentity/bi-sdk-react-native"]]
  }
}

The SDK requires certain minimum native versions. Set these requirments with expo-build-properties.

npx expo install expo-build-properties

{
  "expo": {
    "plugins": [
      ["@beyondidentity/bi-sdk-react-native"],
      [
        "expo-build-properties",
        {
          "android": {
            "minSdkVersion": 26
          },
          "ios": {
            "deploymentTarget": "13.0"
          }
        }
      ]
    ]
  }
}

Finally, rebuild your app as described in Expo's Adding custom native code guide.

Flutter

Pub.Dev

Add the Beyond Identity Embedded SDK to your dependencies

dependencies:
  bi_sdk_flutter: x.y.z

and run an implicit flutter pub get.

Update Android

Please make sure your android/build.gradle supports minSdkVersion 26 or later.

buildscript {
  ext {
    minSdkVersion = 26
  }
}

Update iOS

Please make sure your project supports "minimum deployment target" 13.0 or later. In your ios/Podfile set:

platform :ios, '13.0'

Prerequisites

Before making a call to isBindPasskeyUrl, you must complete the following prerequisite calls:

1. Import the required types and functions from the SDK.

   JavaScript

   import { Embedded } from '@beyondidentity/bi-sdk-js';

   Kotlin

   import com.beyondidentity.embedded.sdk.EmbeddedSdk

   Swift

   import BeyondIdentityEmbedded

   React Native

   import { Embedded } from '@beyondidentity/bi-sdk-react-native';

   Flutter

   import 'package:bi_sdk_flutter/embeddedsdk.dart';

2. Initialize the SDK.

   JavaScript

   // --- Initialize with required arguments
   try {
     const embedded = await Embedded.initialize();
     console.log("Initialization successful", embedded);
   } catch (error) {
     console.error("Initialization failed:", error);
   }
   
   // --- Initialize with required and optional arguments
   const config = {
     allowedDomains: ["example.com", "another-example.com"],
     logger: function (logType, message) {
       console.log(`[${logType}] ${message}`);
     },
   };
   
   try {
     const embedded = await Embedded.initialize(config);
     console.log("Initialization successful", embedded);
   } catch (error) {
     console.error("Initialization failed:", error);
   }

   Kotlin

   // --- Initialize with required arguments
   EmbeddedSdk.init(
     app = this,
     keyguardPrompt = { allowCallback ->
       // launch the keyguard service and then
       // call allowCallback with the result
     },
     logger = { logMessage ->
       Log.d("BeyondIdentityLog", logMessage)
     }
   )
   
   // --- Initialize with required and optional arguments
   EmbeddedSdk.init(
     app = this,
     keyguardPrompt = { allowCallback ->
       // launch the keyguard service and then
       // call allowCallback with the result
     },
     logger = { logMessage ->
       Log.d("BeyondIdentityLog", logMessage)
     },
     biometricAskPrompt = getString(R.string.embedded_export_biometric_prompt_title),
     allowedDomains = listOf("example.com", "another-example.com")
   )

   Swift

   // --- Initialize with required arguments
   Embedded.shared.initialize(
     biometricAskPrompt: "Please provide your biometric"
   ) { result in
     switch result {
     case .success():
       print("Initialization successful")
     case .failure(let error):
       print("Initialization failed: \(error)")
     }
   }
   
   // --- Initialize with required and optional arguments
   Embedded.shared.initialize(
     allowedDomains: ["example.com", "another-example.com"],
     biometricAskPrompt: "Please provide your biometric",
     logger: { (logType, message) in
       print("\(logType): \(message)")
     }
   ) { result in
     switch result {
     case .success():
       print("Initialization successful")
     case .failure(let error):
       print("Initialization failed: \(error)")
     }
   }

   React Native

   // --- Initialize with required arguments
   try {
     const response = await Embedded.initialize("Please provide your biometric");
     console.log(response);
   } catch (error) {
     console.error("Initialization failed:", error);
   }
   
   // --- Initialize with required and optional arguments
   try {
     const response = await Embedded.initialize(
       "Please provide your biometric", [
       ("example.com", "another-example.com"),
     ]);
     console.log(response);
   
     Embedded.logEventEmitter.addListener(
       "BeyondIdentityLogger",
       (message: string) => {
         console.log(message);
       }
     );
   } catch (error) {
     console.error("Initialization failed:", error);
   }

   Flutter

   // --- Initialize with required arguments
   EmbeddedSdk.initialize('Please provide your biometric');
   
   // --- Initialize with required and optional arguments
   EmbeddedSdk.initialize(
     'Please provide your biometric',
     allowedDomains: ["example.com", "another-example.com"],
     logger: EmbeddedSdk.enableLogger
   ).then(() {
     print('Initialization successful');
   }).catchError((error) {
     print('Initialization failed: $error');
   });

Parameters

JavaScript

Parameter	Type	Description
url	string	Required. Url to be validated as Beyond Identity passkey binding url.

Kotlin

Parameter	Type	Description
url	String	Required. Url to be validated as Beyond Identity passkey binding url.

Swift

Parameter	Type	Description
url	URL	Required. Url to be validated as Beyond Identity passkey binding url.

React Native

Parameter	Type	Description
url	string	Required. Url to be validated as Beyond Identity passkey binding url.

Flutter

Parameter	Type	Description
url	String	Required. Url to be validated as Beyond Identity passkey binding url.

Returns

Returns a boolean.

Examples

Example: Call bindPasskey after validating URL

JavaScript

const url = "credential-binding-url";

if (EmbeddedSdk.isBindPasskeyUrl(url)) {
  // The URL is valid for binding a passkey
  EmbeddedSdk.bindPasskey(url)
    .then(response => {
      console.log("Success:", response);
    })
    .catch(err => {
      console.error("Error:", err.message);
    });
} else {
  console.log("The URL is not a valid Bind Passkey URL");
}

Kotlin

import com.beyondidentity.embedded.sdk.EmbeddedSdk
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch
import kotlinx.coroutines.flow.collect

val url = "credential-binding-url"

CoroutineScope(Dispatchers.Main).launch {
  EmbeddedSdk.isBindPasskeyUrl(url, Dispatchers.IO).collect { isValid ->
    if (isValid) {
      // The URL is valid for binding a passkey
      EmbeddedSdk.bindPasskey(url, Dispatchers.IO).collect { result ->
        result.onSuccess {
          print("Success")
        }
        result.onFailure {
          print("Failure")
        }
      }
    } else {
      print("The URL is not a valid Bind Passkey URL")
    }
  }
}

Swift

let url = URL(string: "credential-binding-url")!

if Embedded.shared.isBindPasskeyUrl(url) {
  // The URL is valid for binding a passkey
  Embedded.shared.bindPasskey(url: url) { result in
    switch result {
    case .success(let bindPasskeyResponse):
      // Handle successful binding
      print("Successfully bound the passkey. Response: \(bindPasskeyResponse)")
    case .failure(let error):
      // Handle failure
      print("Failed to bind the passkey. Error: \(error.localizedDescription)")
    }
  }
} else {
  print("The URL is not a valid Bind Passkey URL.")
}

React Native

const url = "credential-binding-url";

Embedded.isBindPasskeyUrl(url)
  .then(isValid => {
    if (isValid) {
      // The URL is valid for binding a passkey
      return Embedded.bindPasskey(url);
    } else {
      throw new Error("The URL is not a valid Bind Passkey URL");
    }
  })
  .then(response => {
    console.log("Success:", response);
  })
  .catch(err => {
    console.error("Error:", err.message);
  });

Flutter

final url = "credential-binding-url";

bool isValid = await isBindPasskeyUrl(url);
if (isValid) {
  // The URL is valid for binding a passkey
  try {
    BindPasskeyResponse response = await bindPasskey(url);
    print("Successfully bound the passkey. Response: $response");
  } catch (e) {
    print("Error binding the passkey: $e");
  }
} else {
  print("The URL is not a valid Bind Passkey URL");
}