メインコンテンツへスキップ
Example
import MfaWebAuthnPlatformChallenge from "@auth0/auth0-acul-js/mfa-webauthn-platform-challenge";

const mfaWebAuthnPlatformChallengeManager = new MfaWebAuthnPlatformChallenge();

コンストラクター

MfaWebAuthnPlatformChallenge
Constructor
MfaWebAuthnPlatformChallenge クラスの新しいインスタンスを初期化します。 グローバル universal_login_context から必要なコンテキスト(画面、トランザクションなど)を取得します。

例外

Universal Login コンテキストが利用できない場合、またはコンテキスト内の画面名が MfaWebAuthnPlatformChallenge.screenIdentifier と一致しない場合にスローされます。

プロパティ

branding
client
organization
prompt
screen
tenant
transaction
untrustedData
user
screenIdentifier
string
static

メソッド

getErrors
コンテキストからトランザクションのエラー配列を取得します。存在しない場合は空の配列を返します。トランザクションコンテキストからのエラーオブジェクトの配列。
reportBrowserError
Promise<void>
WebAuthn の navigator.credentials.get() 操作中に発生したブラウザ側のエラーを報告します。 このメソッドは、WebAuthn API エラー(例: ユーザーによるキャンセル)が原因で verify() が失敗した場合に呼び出す必要があります。 エラーの詳細は特定の Action 形式でサーバーに送信されます。エラーレポートが正常に送信されると解決される Promise。

Throws

フォーム送信に失敗した場合(例: ネットワークの問題、無効な state)にエラーをスローします。
tryAnotherMethod
Promise<void>
ユーザーが WebAuthn プラットフォームチャレンジをスキップし、別の MFA(多要素認証)手段を選択できるようにします。 この Action は action: "pick-authenticator" を Auth0 に送信し、 ユーザーを MFA 要素選択画面へ遷移させます。pick-authenticator アクションが送信されると解決される Promise。

Throws

フォーム送信に失敗した場合(例: ネットワークエラー、無効な state)にエラーをスローします。
verify
Promise<void>
WebAuthn プラットフォーム認証器チャレンジを開始します。 内部的には、このメソッドは this.screen.publicKey からチャレンジオプションを取得し、 navigator.credentials.get()getPasskeyCredentials ユーティリティ経由)を呼び出してから、 得られたクレデンシャルアサーションを Auth0 サーバーに送信します。クレデンシャルの送信が開始されると解決される Promise。 成功した場合、通常はサーバー側でのリダイレクトが行われます。

Throws

this.screen.publicKey が利用できない場合(チャレンジオプションが欠落していることを示します)、 getPasskeyCredentials(ひいては navigator.credentials.get())が失敗した場合(例: ユーザーのキャンセル、 認証器が見つからない、ハードウェアエラー)、または Auth0 への最終的なフォーム送信が失敗した場合にエラーをスローします。 このメソッドからのエラーを捕捉することが重要です。NotAllowedError などの WebAuthn API エラーは、 可能であれば this.reportBrowserError() を使用して報告する必要があります。