Example
コンストラクター
MfaWebAuthnPlatformChallenge クラスの新しいインスタンスを初期化します。
グローバル universal_login_context から必要なコンテキスト(画面、トランザクションなど)を取得します。例外
Universal Login コンテキストが利用できない場合、またはコンテキスト内の画面名がMfaWebAuthnPlatformChallenge.screenIdentifier と一致しない場合にスローされます。プロパティ
branding
client
organization
prompt
screen
tenant
transaction
untrustedData
user
static
メソッド
getErrors
コンテキストからトランザクションのエラー配列を取得します。存在しない場合は空の配列を返します。トランザクションコンテキストからのエラーオブジェクトの配列。
WebAuthn の フォーム送信に失敗した場合(例: ネットワークの問題、無効な state)にエラーをスローします。
navigator.credentials.get() 操作中に発生したブラウザ側のエラーを報告します。
このメソッドは、WebAuthn API エラー(例: ユーザーによるキャンセル)が原因で verify() が失敗した場合に呼び出す必要があります。
エラーの詳細は特定の Action 形式でサーバーに送信されます。エラーレポートが正常に送信されると解決される Promise。Throws
ユーザーが WebAuthn プラットフォームチャレンジをスキップし、別の MFA(多要素認証)手段を選択できるようにします。
この Action は フォーム送信に失敗した場合(例: ネットワークエラー、無効な state)にエラーをスローします。
action: "pick-authenticator" を Auth0 に送信し、
ユーザーを MFA 要素選択画面へ遷移させます。pick-authenticator アクションが送信されると解決される Promise。Throws
WebAuthn プラットフォーム認証器チャレンジを開始します。
内部的には、このメソッドは
this.screen.publicKey からチャレンジオプションを取得し、
navigator.credentials.get()(getPasskeyCredentials ユーティリティ経由)を呼び出してから、
得られたクレデンシャルアサーションを Auth0 サーバーに送信します。クレデンシャルの送信が開始されると解決される Promise。
成功した場合、通常はサーバー側でのリダイレクトが行われます。Throws
this.screen.publicKey が利用できない場合(チャレンジオプションが欠落していることを示します)、
getPasskeyCredentials(ひいては navigator.credentials.get())が失敗した場合(例: ユーザーのキャンセル、
認証器が見つからない、ハードウェアエラー)、または Auth0 への最終的なフォーム送信が失敗した場合にエラーをスローします。
このメソッドからのエラーを捕捉することが重要です。NotAllowedError などの WebAuthn API エラーは、
可能であれば this.reportBrowserError() を使用して報告する必要があります。