Class FRWebAuthnAbstract

Utility for integrating a web browser's WebAuthn API.

Example:

// Determine if a step is a WebAuthn step
const stepType = FRWebAuthn.getWebAuthnStepType(step);
if (stepType === WebAuthnStepType.Registration) {
  // Register a new device
  await FRWebAuthn.register(step);
} else if (stepType === WebAuthnStepType.Authentication) {
  // Authenticate with a registered device
  await FRWebAuthn.authenticate(step);
}

Constructors

constructor

Methods

getWebAuthnStepType authenticate register getCallbacks getMetadataCallback getOutcomeCallback getTextOutputCallback getAuthenticationCredential getAuthenticationOutcome getRegistrationCredential getRegistrationOutcome createAuthenticationPublicKey createRegistrationPublicKey

Constructors

constructor

Methods

Static getWebAuthnStepType

Static authenticate

  • authenticate(step): Promise<FRStep>

  • Populates the step with the necessary authentication outcome.

    Parameters

    • step: FRStep

      The step that contains WebAuthn authentication data

    Returns Promise<FRStep>

    The populated step

Static register

  • register<T>(step, deviceName?): Promise<FRStep>

  • Can make this generic const in Typescript 5.0 > and the name itself will be inferred from the type so typeof deviceName will not just return string but the actual name of the deviceName passed in as a generic.

    Type Parameters

    • T extends string = ""

    Parameters

    Returns Promise<FRStep>

Static getCallbacks

Static getMetadataCallback

  • getMetadataCallback(step): undefined | MetadataCallback

  • Returns the WebAuthn metadata callback containing data to pass to the browser Web Authentication API.

    Parameters

    • step: FRStep

      The step that contains WebAuthn callbacks

    Returns undefined | MetadataCallback

    The metadata callback

Static getOutcomeCallback

Static getTextOutputCallback

Static getAuthenticationCredential

  • getAuthenticationCredential(options): Promise<null | PublicKeyCredential>

  • Retrieves the credential from the browser Web Authentication API.

    Parameters

    • options: PublicKeyCredentialRequestOptions

      The public key options associated with the request

    Returns Promise<null | PublicKeyCredential>

    The credential

Static getAuthenticationOutcome

  • getAuthenticationOutcome(credential): `${string}::direct::${string}` | `${string}::indirect::${string}` | `${string}::none::${string}` | `${string}::direct::${string}::${string}` | `${string}::indirect::${string}::${string}` | `${string}::none::${string}::${string}`

  • Converts an authentication credential into the outcome expected by OpenAM.

    Parameters

    • credential: null | PublicKeyCredential

      The credential to convert

    Returns `${string}::direct::${string}` | `${string}::indirect::${string}` | `${string}::none::${string}` | `${string}::direct::${string}::${string}` | `${string}::indirect::${string}::${string}` | `${string}::none::${string}::${string}`

    The outcome string

Static getRegistrationCredential

  • getRegistrationCredential(options): Promise<null | PublicKeyCredential>

  • Retrieves the credential from the browser Web Authentication API.

    Parameters

    • options: PublicKeyCredentialCreationOptions

      The public key options associated with the request

    Returns Promise<null | PublicKeyCredential>

    The credential

Static getRegistrationOutcome

  • getRegistrationOutcome(credential): `${string}::direct::${string}` | `${string}::indirect::${string}` | `${string}::none::${string}`

  • Converts a registration credential into the outcome expected by OpenAM.

    Parameters

    • credential: null | PublicKeyCredential

      The credential to convert

    Returns `${string}::direct::${string}` | `${string}::indirect::${string}` | `${string}::none::${string}`

    The outcome string

Static createAuthenticationPublicKey

  • createAuthenticationPublicKey(metadata): PublicKeyCredentialRequestOptions

  • Converts authentication tree metadata into options required by the browser Web Authentication API.

    Parameters

    Returns PublicKeyCredentialRequestOptions

    The Web Authentication API request options

Static createRegistrationPublicKey

  • createRegistrationPublicKey(metadata): PublicKeyCredentialCreationOptions

  • Converts authentication tree metadata into options required by the browser Web Authentication API.

    Parameters

    Returns PublicKeyCredentialCreationOptions

    The Web Authentication API request options

Settings

Member Visibility

Theme

On This Page

constructorgetWebAuthnStepTypeauthenticateregistergetCallbacksgetMetadataCallbackgetOutcomeCallbackgetTextOutputCallbackgetAuthenticationCredentialgetAuthenticationOutcomegetRegistrationCredentialgetRegistrationOutcomecreateAuthenticationPublicKeycreateRegistrationPublicKey