> ## Documentation Index
> Fetch the complete documentation index at: https://docs-staging.auth0-mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# ResetPasswordMfaWebAuthnRoamingChallengeMembers

ResetPasswordMfaWebAuthnRoamingChallengeMembers

```ts Example theme={null}
export interface ResetPasswordMfaWebAuthnRoamingChallengeMembers extends BaseMembers {

  /**
 * `reset-password-mfa-webauthn-roaming-challenge` 画面固有のプロパティとデータへのアクセスを提供します。
 * WebAuthn の `publicKey` チャレンジオプションと `showRememberDevice` フラグを含みます。
 * @type {ScreenMembersOnResetPasswordMfaWebAuthnRoamingChallenge}
 */
  screen: ScreenMembersOnResetPasswordMfaWebAuthnRoamingChallenge;

  /**
   * WebAuthn アサーションプロセス（セキュリティキーチャレンジ）を開始します。
   * このメソッドは内部的に、`screen.publicKey` で提供されたチャレンジを使用して
   * `navigator.credentials.get()` を呼び出します。
   * セキュリティキーとの対話が成功すると、結果として得られた
   * `PublicKeyCredential` を `action: "default"` とともに Auth0 に送信します。
   *
   * @param {UseSecurityKeyOptions} [options] - 省略可能。操作のパラメータ。
   * `rememberDevice`（`screen.showRememberDevice` が true の場合）やその他のカスタムオプションなどを指定できます。
   * `response` フィールド（WebAuthn 資格情報）は SDK が内部的に処理します。
   * @returns {Promise<void>} 検証の試行が送信されたときに解決される Promise。
   * 操作が成功した場合、通常は Auth0 によってリダイレクトが行われます。
   * @throws {Error} `screen.publicKey` が存在しない場合、`navigator.credentials.get()` が
   * 失敗した場合（例：ユーザーによるキャンセル、認証器が見つからない場合など）、または Auth0 へのフォーム送信が失敗した場合にエラーをスローします。
   * これらのエラーをキャッチし、WebAuthn API 固有の問題を報告するために `showError()` の使用を検討することを推奨します。
   */
  useSecurityKey(options?: UseSecurityKeyOptions): Promise<void>;

  /**
   * クライアントサイドの WebAuthn API エラー（`navigator.credentials.get()` からのもの）を Auth0 に報告します。
   * このメソッドは、`useSecurityKey()`（または手動での `navigator.credentials.get()` 呼び出し）が
   * ブラウザ側の WebAuthn の問題により失敗した場合に使用します（例：ユーザーがプロンプトをキャンセルした場合の `NotAllowedError`、
   * 一致する認証器が見つからない場合の `NotFoundError`、またはタイムアウトなど）。
   * エラーの詳細を `action: "showError::{errorDetailsJsonString}"` と空の `response` とともに送信します。
   *
   * @param {ShowErrorOptions} options - WebAuthn API の DOMException から取得した `name` と `message` を持つ `error` オブジェクト、
   * 省略可能な `rememberDevice` フラグ、およびその他のカスタムオプションを含みます。
   * @returns {Promise<void>} エラーレポートが送信されたときに解決される Promise。
   * Auth0 はエラー情報とともにページを再レンダリングするか、リダイレクトする場合があります。
   * @throws {Error} フォームの送信が失敗した場合（例：ネットワークエラー、invalid state）にエラーをスローします。
   */
  showError(options: ShowErrorOptions): Promise<void>;

  /**
   * ユーザーが WebAuthn ローミングチャレンジをオプトアウトし、別の MFA方式を選択できるようにします。
   * このアクションは `action: "pick-authenticator"` を Auth0 に送信し、
   * ユーザーを MFA 認証要素選択画面に遷移させます。
   *
   * @param {TryAnotherMethodOptions} [options] - 省略可能。操作のパラメータ。
   * `rememberDevice`（`screen.showRememberDevice` が true の場合）やその他のカスタムオプションなどを指定できます。
   * @returns {Promise<void>} 'pick-authenticator' アクションが送信されたときに解決される Promise。
   * @throws {Error} フォームの送信が失敗した場合にエラーをスローします。
   */
  tryAnotherMethod(options?: TryAnotherMethodOptions): Promise<void>;
}
```

<h2 id="properties">
  プロパティ
</h2>

<ParamField body="branding" type={<span><a href="/docs/ja-jp/libraries/acul/js-sdk/Screens/interfaces/BrandingMembers">BrandingMembers</a></span>} />

<ParamField body="client" type={<span><a href="/docs/ja-jp/libraries/acul/js-sdk/Screens/interfaces/ClientMembers">ClientMembers</a></span>} />

<ParamField body="organization" type={<span><a href="/docs/ja-jp/libraries/acul/js-sdk/Screens/interfaces/OrganizationMembers">OrganizationMembers</a></span>} />

<ParamField body="prompt" type={<span><a href="/docs/ja-jp/libraries/acul/js-sdk/Screens/interfaces/PromptMembers">PromptMembers</a></span>} />

<ParamField body="screen" type={<span><a href="/docs/ja-jp/libraries/acul/js-sdk/Screens/interfaces/ScreenMembersOnResetPasswordMfaWebAuthnRoamingChallenge">ScreenMembersOnResetPasswordMfaWebAuthnRoamingChallenge</a></span>}>
  `reset-password-mfa-webauthn-roaming-challenge` 画面固有のプロパティとデータにアクセスできます。
  これには、WebAuthn の `publicKey` チャレンジ オプションと `showRememberDevice` フラグが含まれます。
</ParamField>

<ParamField body="tenant" type={<span><a href="/docs/ja-jp/libraries/acul/js-sdk/Screens/interfaces/TenantMembers">TenantMembers</a></span>} />

<ParamField body="transaction" type={<span><a href="/docs/ja-jp/libraries/acul/js-sdk/Screens/interfaces/TransactionMembers">TransactionMembers</a></span>} />

<ParamField body="untrustedData" type={<span><a href="/docs/ja-jp/libraries/acul/js-sdk/Screens/interfaces/UntrustedDataMembers">UntrustedDataMembers</a></span>} />

<ParamField body="user" type={<span><a href="/docs/ja-jp/libraries/acul/js-sdk/Screens/interfaces/UserMembers">UserMembers</a></span>} />

<h2 id="methods">
  メソッド
</h2>

<ParamField body="showError" type="Promise<void>">
  client-side の WebAuthn API エラー (`navigator.credentials.get()` からのエラー) を Auth0 に報告します。
  このメソッドは、`useSecurityKey()` (または手動の `navigator.credentials.get()` 呼び出し) が
  ブラウザー側の WebAuthn の問題 (たとえば、ユーザーがプロンプトをキャンセルした場合の `NotAllowedError`、
  一致する認証器が見つからない場合の `NotFoundError`、またはタイムアウト) によって失敗したときに使用します。
  エラーの詳細は、`action: "showError::{errorDetailsJsonString}"` と空の `response` とともに送信されます。

  エラー報告の送信完了時に解決される promise です。
  Auth0 は、エラー情報を表示してページを再レンダリングするか、リダイレクトすることがあります。

  <h4 id="throws">
    例外
  </h4>

  フォーム送信に失敗した場合 (たとえば、network error や invalid state) にエラーをスローします。

  <Expandable title="パラメータ">
    <ParamField body="options" type={<span><a href="/docs/ja-jp/libraries/acul/js-sdk/Screens/interfaces/ResetPasswordMfaWebAuthnRoamingChallengeShowErrorOptions">ResetPasswordMfaWebAuthnRoamingChallengeShowErrorOptions</a></span>}>
      WebAuthn API の DOMException から取得した `name` と `message` を含む `error` object、
      省略可能な `rememberDevice` flag、およびその他のカスタムオプションを含みます。

      **プロパティ**

      <ParamField body="error" type={<span><a href="/docs/ja-jp/libraries/acul/js-sdk/Screens/interfaces/WebAuthnErrorDetails">WebAuthnErrorDetails</a></span>}>
        WebAuthn API (`navigator.credentials.get()`) から返される error object で、
        DOMException の `name` と `message` を含みます。
      </ParamField>

      <ParamField body="rememberDevice?" type="boolean">
        省略可能です。`true` で、かつ `screen.showRememberDevice` も `true` の場合、
        SDK はフォーム送信に `rememberBrowser=true` を含めます。
      </ParamField>
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="tryAnotherMethod" type="Promise<void>">
  ユーザーが WebAuthn roaming チャレンジ を中止し、別の MFA方式 を選択できるようにします。
  この action は `action: "pick-authenticator"` を Auth0 に送信し、これにより
  ユーザーは MFA認証要素選択画面に移動します。

  `'pick-authenticator'` action の送信完了時に解決される promise です。

  <h4 id="throws-2">
    例外
  </h4>

  フォーム送信が失敗した場合にエラーをスローします。

  <Expandable title="パラメータ">
    <ParamField body="options?" type={<span><a href="/docs/ja-jp/libraries/acul/js-sdk/Screens/interfaces/ResetPasswordMfaWebAuthnRoamingChallengeTryAnotherMethodOptions">ResetPasswordMfaWebAuthnRoamingChallengeTryAnotherMethodOptions</a></span>}>
      省略可能です。`rememberDevice` (`screen.showRememberDevice` が true の場合) や
      その他のカスタムオプションなど、この操作のパラメータです。

      **プロパティ**

      <ParamField body="rememberDevice?" type="boolean">
        省略可能です。`true` で、かつ `screen.showRememberDevice` も `true` の場合、
        SDK はフォーム送信に `rememberBrowser=true` を含めます。
      </ParamField>
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="useSecurityKey" type="Promise<void>">
  WebAuthn アサーションプロセス (security key チャレンジ) を開始します。
  このメソッドは、`screen.publicKey` で提供される チャレンジ を使用して、
  内部的に `navigator.credentials.get()` を呼び出します。
  security key とのやり取りに成功すると、生成された
  `PublicKeyCredential` を `action: "default"` とともに Auth0 に送信します。

  検証試行の送信完了時に解決される promise です。
  通常、操作が成功すると Auth0 によってリダイレクトされます。

  <h4 id="throws-3">
    例外
  </h4>

  `screen.publicKey` が存在しない場合、`navigator.credentials.get()`
  が失敗した場合 (たとえば、ユーザーによるキャンセルや一致する認証器が見つからない場合) 、または Auth0 へのフォーム送信が失敗した場合にエラーをスローします。
  これらのエラーは catch し、必要に応じて `showError()` を使って WebAuthn API 固有の問題を報告することを推奨します。

  <Expandable title="パラメータ">
    <ParamField body="options?" type={<span><a href="/docs/ja-jp/libraries/acul/js-sdk/Screens/interfaces/ResetPasswordMfaWebAuthnRoamingChallengeUseSecurityKeyOptions">ResetPasswordMfaWebAuthnRoamingChallengeUseSecurityKeyOptions</a></span>}>
      省略可能です。`rememberDevice` (`screen.showRememberDevice` が true の場合) や
      その他のカスタムオプションなど、この操作のパラメータです。
      `response` field (WebAuthn credential) は SDK によって内部的に処理されます。

      **プロパティ**

      <ParamField body="rememberDevice?" type="boolean">
        省略可能です。`true` で、かつ `screen.showRememberDevice` も `true` の場合、
        SDK はフォーム送信に `rememberBrowser=true` を含め、ユーザーが
        このデバイスを記憶する選択をしたことを示します。
      </ParamField>
    </ParamField>
  </Expandable>
</ParamField>