Example
プロパティ
reset-password-mfa-webauthn-roaming-challenge 画面固有のプロパティとデータにアクセスできます。
これには、WebAuthn の publicKey チャレンジ オプションと showRememberDevice フラグが含まれます。メソッド
Promise<void>
client-side の WebAuthn API エラー (
navigator.credentials.get() からのエラー) を Auth0 に報告します。
このメソッドは、useSecurityKey() (または手動の navigator.credentials.get() 呼び出し) が
ブラウザー側の WebAuthn の問題 (たとえば、ユーザーがプロンプトをキャンセルした場合の NotAllowedError、
一致する認証器が見つからない場合の NotFoundError、またはタイムアウト) によって失敗したときに使用します。
エラーの詳細は、action: "showError::{errorDetailsJsonString}" と空の response とともに送信されます。エラー報告の送信完了時に解決される promise です。
Auth0 は、エラー情報を表示してページを再レンダリングするか、リダイレクトすることがあります。例外
フォーム送信に失敗した場合 (たとえば、network error や invalid state) にエラーをスローします。Promise<void>
ユーザーが WebAuthn roaming チャレンジ を中止し、別の MFA方式 を選択できるようにします。
この action は
action: "pick-authenticator" を Auth0 に送信し、これにより
ユーザーは MFA認証要素選択画面に移動します。'pick-authenticator' action の送信完了時に解決される promise です。例外
フォーム送信が失敗した場合にエラーをスローします。Promise<void>
WebAuthn アサーションプロセス (security key チャレンジ) を開始します。
このメソッドは、
screen.publicKey で提供される チャレンジ を使用して、
内部的に navigator.credentials.get() を呼び出します。
security key とのやり取りに成功すると、生成された
PublicKeyCredential を action: "default" とともに Auth0 に送信します。検証試行の送信完了時に解決される promise です。
通常、操作が成功すると Auth0 によってリダイレクトされます。例外
screen.publicKey が存在しない場合、navigator.credentials.get()
が失敗した場合 (たとえば、ユーザーによるキャンセルや一致する認証器が見つからない場合) 、または Auth0 へのフォーム送信が失敗した場合にエラーをスローします。
これらのエラーは catch し、必要に応じて showError() を使って WebAuthn API 固有の問題を報告することを推奨します。