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: FRStep): 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 extends string = "">(step: FRStep, deviceName?: T): 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

StaticgetOutcomeCallback

StaticgetTextOutputCallback

StaticgetAuthenticationCredential

  • getAuthenticationCredential(
        options: PublicKeyCredentialRequestOptions,
    ): 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: null | PublicKeyCredential,
    ):
        | `${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: PublicKeyCredentialCreationOptions,
    ): 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: null | PublicKeyCredential,
    ):
        | `${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: WebAuthnAuthenticationMetadata,
    ): 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: WebAuthnRegistrationMetadata,
    ): 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