isAuthenticateUrl

Last updated on Aug 1, 2023

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

Dependencies

The isAuthenticateUrl 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 isAuthenticateUrl, 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 authentication url.

Kotlin

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

Swift

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

React Native

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

Flutter

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

Returns

Returns a boolean.

Examples

Example: Authenticate only if the provided url is valid

JavaScript

const url = "authenticate-url";

try {
  // Fetch all passkeys for this browser
  const passkeys = await embedded.getPasskeys();

  // Check if there are any passkeys available
  if (passkeys.length > 0) {
    // TODO: Instead of automatically selecting the first passkey, 
    // present a UI to the user to let them select the desired passkey.
    // For the purpose of this example, we're using the first passkey.
    const passkeyId = passkeys[0].passkeyId;

    if (embedded.isAuthenticateUrl(url)) {
      // The URL is valid for authenticating against a passkey
      const response = await embedded.authenticate(url, passkeyId);
      console.log(`Successfully authenticated against passkey bound to this browser. Response: ${JSON.stringify(response)}`);
    } else {
      console.log("The URL is not a valid Authenticate Passkey URL");
    }
  } else {
    console.log("No passkeys available for this browser");
  }
} catch (error) {
  console.error(`Error: ${error}`);
}

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 = "authenticate-url"

CoroutineScope(Dispatchers.Main).launch {
    // Fetch all passkeys for this device
    EmbeddedSdk.getPasskeys(Dispatchers.IO).collect { result ->
        result.onSuccess { passkeys ->
            // Check if there are any passkeys available
            if (passkeys.isNotEmpty()) {
                // TODO: Instead of automatically selecting the first passkey, 
                // present a UI to the user to let them select the desired passkey.
                // For the purpose of this example, we're using the first passkey.
                val passkeyId = passkeys.first().passkeyId

                EmbeddedSdk.isAuthenticateUrl(url, Dispatchers.IO).collect { isValid ->
                    if (isValid) {
                        // The URL is valid for authenticating against a passkey
                        EmbeddedSdk.authenticate(url, passkeyId, Dispatchers.IO).collect { authResult ->
                            authResult.onSuccess { response ->
                                print("Successfully authenticated against passkey bound to this device. Response: $response")
                            }
                            authResult.onFailure { e ->
                                print("Error authenticating against a passkey: $e")
                            }
                        }
                    } else {
                        print("The URL is not a valid Authenticate Passkey URL")
                    }
                }
            } else {
                print("No passkeys available for this device")
            }
        }
        result.onFailure { e ->
            print("Error fetching passkeys: $e")
        }
    }
}

Swift

let url = URL(string: "authenticate-url")!

// Fetch all passkeys for this device
Embedded.shared.getPasskeys { result in
    switch result {
    case .success(let passkeys):
        // Check if there are any passkeys available
        if !passkeys.isEmpty {
            // TODO: Instead of automatically selecting the first passkey, 
            // present a UI to the user to let them select the desired passkey.
            // For the purpose of this example, we're using the first passkey.
            let passkeyId = passkeys.first!.id

            if Embedded.shared.isAuthenticateUrl(url) {
                // The URL is valid for authenticating against a passkey
                Embedded.shared.authenticate(url: url, id: passkeyId) { authResult in
                    switch authResult {
                    case .success(let response):
                        print("Successfully authenticated against passkey bound to this device. Response: \(response)")
                    case .failure(let error):
                        print("Error authenticating against a passkey: \(error.localizedDescription)")
                    }
                }
            } else {
                print("The URL is not a valid Authenticate Passkey URL")
            }
        } else {
            print("No passkeys available for this device")
        }
    case .failure(let error):
        print("Error fetching passkeys: \(error.localizedDescription)")
    }
}

React Native

const url = "authenticate-url";

try {
  // Fetch all passkeys for this device
  const passkeys = await Embedded.getPasskeys();

  // Check if there are any passkeys available
  if (passkeys.length > 0) {
    // TODO: Instead of automatically selecting the first passkey, 
    // present a UI to the user to let them select the desired passkey.
    // For the purpose of this example, we're using the first passkey.
    const passkeyId = passkeys[0].passkeyId;

    const isValid = await Embedded.isAuthenticateUrl(url);
    if (isValid) {
      // The URL is valid for authenticating against a passkey
      try {
        const response = await Embedded.authenticate(url, passkeyId);
        console.log("Successfully authenticated against passkey bound to this device. Response:", response);
      } catch (e) {
        console.error("Error authenticating against a passkey:", e);
      }
    } else {
      console.log("The URL is not a valid Authenticate Passkey URL");
    }
  } else {
    console.log("No passkeys available for this device");
  }
} catch (error) {
  console.error("Error fetching passkeys:", error);
}

Flutter

final url = "authenticate-url";

// Fetch all passkeys for this device
List<Passkey> passkeys = await EmbeddedSdk.getPasskeys();

// Check if there are any passkeys available
if (passkeys.isNotEmpty) {
  // TODO: Instead of automatically selecting the first passkey, 
  // present a UI to the user to let them select the desired passkey.
  // For the purpose of this example, we're using the first passkey.
  String passkeyId = passkeys.first.passkeyId;

  bool isValid = await EmbeddedSdk.isAuthenticateUrl(url);
  if (isValid) {
    // The URL is valid for authenticating against a passkey
    try {
      AuthenticateResponse response = await EmbeddedSdk.authenticate(url, passkeyId);
      print("Successfully authenticated against passkey bound to this device. Response: $response");
    } catch (e) {
      print("Error authenticating against a passkey: $e");
    }
  } else {
    print("The URL is not a valid Authenticate Passkey URL");
  }
} else {
  print("No passkeys available for this device");
}