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

StaticgetWebAuthnStepType

Staticauthenticate

  • 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

Staticregister

  • 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>

StaticgetCallbacks

StaticgetMetadataCallback

  • 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

StaticgetOutcomeCallback

StaticgetTextOutputCallback

StaticgetAuthenticationCredential

  • 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

StaticgetAuthenticationOutcome

  • 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

StaticgetRegistrationCredential

  • 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

StaticgetRegistrationOutcome

  • 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

StaticcreateAuthenticationPublicKey

  • 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

StaticcreateRegistrationPublicKey

  • 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

On This Page

Constructors
Methods