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

# MfaWebAuthnRoamingChallenge

> Universal Login の `mfa-webauthn-roaming-challenge` 画面をカスタマイズするために使用できる、すべてのプロパティとメソッドについて説明します。

MfaWebAuthnRoamingChallenge クラスは、`mfa-webauthn-roaming-challenge` 画面の機能を実装します。この画面は、セキュリティキーなどのローミング認証器を使用してユーザーが本人確認を行う必要がある場合に表示されます。

<Frame>
  <img style={{maxHeight:"400px"}} src="https://mintcdn.com/translations/xwVvTWJUElMm5YAK/docs/images/cdy7uua7fh8z/joy7T4RglZYOlWItGk5Xm/0a4b2477cba476281ce05f2605acfb12/Screenshot_2025-05-28_at_11.40.56.png?fit=max&auto=format&n=xwVvTWJUElMm5YAK&q=85&s=7308a6dc701b0824242d62be622ed441" alt="MfaWebAuthnRoamingChallenge" width="363" height="489" data-path="docs/images/cdy7uua7fh8z/joy7T4RglZYOlWItGk5Xm/0a4b2477cba476281ce05f2605acfb12/Screenshot_2025-05-28_at_11.40.56.png" />
</Frame>

<div id="constructors">
  ## コンストラクター
</div>

MFA WebAuthn Roaming Challenge 画面マネージャーのインスタンスを作成します：

```typescript Example theme={null}
import MfaWebAuthnRoamingChallenge from '@auth0/auth0-acul-js/mfa-webauthn-roaming-challenge';

const mfaWebAuthnRoamingChallenge = new MfaWebAuthnRoamingChallenge();
await mfaWebAuthnRoamingChallenge.verify();
```

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

<ParamField body="branding" type={<span><a href="/ja/docs/libraries/acul/js-sdk/Screens/interfaces/BrandingMembers">BrandingMembers</a></span>}>
  ブランディングテーマや設定など、ブランディングに関する構成を提供します。
</ParamField>

<ParamField body="client" type={<span><a href="/ja/docs/libraries/acul/js-sdk/Screens/interfaces/ClientMembers">ClientMembers</a></span>}>
  `mfa-webauthn-roaming-challenge` 画面用のクライアント関連の構成 (`id`、`name`、`logoUrl` など) を提供します。
</ParamField>

<ParamField body="organization" type={<span><a href="/ja/docs/libraries/acul/js-sdk/Screens/interfaces/OrganizationMembers">OrganizationMembers</a></span>}>
  `id` や `name` など、ユーザーの組織に関する情報を提供します。
</ParamField>

<ParamField body="prompt" type={<span><a href="/ja/docs/libraries/acul/js-sdk/Screens/interfaces/PromptMembers">PromptMembers</a></span>}>
  認証フローにおける現在のプロンプトに関するデータを含みます。
</ParamField>

<ParamField body="screen" type={<span><a href="/ja/docs/libraries/acul/js-sdk/Screens/interfaces/ScreenMembersOnMfaWebAuthnRoamingChallenge">ScreenMembersOnMfaWebAuthnRoamingChallenge</a></span>}>
  設定やコンテキストなど、`mfa-webauthn-roaming-challenge` 画面に固有の詳細を含みます。
</ParamField>

<ParamField body="tenant" type={<span><a href="/ja/docs/libraries/acul/js-sdk/Screens/interfaces/TenantMembers">TenantMembers</a></span>}>
  `id` や関連するメタデータなど、テナントに関するデータを含みます。
</ParamField>

<ParamField body="transaction" type={<span><a href="/ja/docs/libraries/acul/js-sdk/Screens/interfaces/TransactionMembers">TransactionMembers</a></span>}>
  アクティブな識別子やフローの状態など、`mfa-webauthn-roaming-challenge` 画面に固有のトランザクションデータを提供します。
</ParamField>

<ParamField body="untrustedData" type={<span><a href="/ja/docs/libraries/acul/js-sdk/Screens/interfaces/UntrustedDataMembers">UntrustedDataMembers</a></span>}>
  MFA の WebAuthn roaming challenge 中のユーザー入力など、SDK に渡される信頼できないデータを扱います。
</ParamField>

<ParamField body="user" type={<span><a href="/ja/docs/libraries/acul/js-sdk/Screens/interfaces/UserMembers">UserMembers</a></span>}>
  `username`、`email`、`roles` など、現在アクティブなユーザーの詳細です。
</ParamField>

<div id="methods">
  ## メソッド
</div>

<ParamField body="changeLanguage" type="Promise<void>">
  このメソッドは、Universal Login ページの表示言語を変更します。

  ```typescript Example theme={null}
  import MfaWebAuthnRoamingChallenge from '@auth0/auth0-acul-js/mfa-webauthn-roaming-challenge';

  const mfaWebAuthnRoamingChallenge = new MfaWebAuthnRoamingChallenge();
  mfaWebAuthnRoamingChallenge.changeLanguage({
    language: 'fr',
  });
  ```

  **メソッドパラメーター**

  <Expandable title="パラメーター">
    <ParamField body="options">
      [LanguageChangeOptions](/ja/docs/libraries/acul/js-sdk/Screens/interfaces/LanguageChangeOptions)。
    </ParamField>

    <ParamField body="language" type="string" required>
      使用する言語のロケールコードです (例: `'en'`、`'fr'`、`'es'`) 。
    </ParamField>

    <ParamField body="persist?" type="&#x22;session&#x22;">
      `'session'` に設定すると、選択した言語はセッションの間保持されます。
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="getErrors" type={<span><a href="/ja/docs/libraries/acul/js-sdk/Screens/interfaces/Error">Error</a>[]</span>}>
  このメソッドは、コンテキストからトランザクションエラーの配列を取得します。エラーが存在しない場合は空の配列を返します。
</ParamField>

<ParamField body="reportWebAuthnError" type="Promise<void>">
  このメソッドは、`navigator.credentials.get()` の実行中に発生した WebAuthn API エラーを報告します。

  ```typescript Example theme={null}
  import MfaWebAuthnRoamingChallenge from '@auth0/auth0-acul-js/mfa-webauthn-roaming-challenge';

  const mfaWebAuthnRoamingChallenge = new MfaWebAuthnRoamingChallenge();
  await mfaWebAuthnRoamingChallenge.reportWebAuthnError({
    error: { name: 'NotAllowedError', message: 'The operation was not allowed.' },
  });
  ```

  **メソッドパラメーター**

  <Expandable title="パラメーター">
    <ParamField body="options">
      [MfaWebAuthnRoamingChallengeReportErrorOptions](/ja/docs/libraries/acul/js-sdk/Screens/interfaces/MfaWebAuthnRoamingChallengeReportErrorOptions)。
    </ParamField>

    <ParamField body="error" type={<span><a href="/ja/docs/libraries/acul/js-sdk/Screens/interfaces/WebAuthnErrorDetails">WebAuthnErrorDetails</a></span>} required>
      報告する WebAuthn API (`navigator.credentials.get()`) のエラーオブジェクトです。

      <ParamField body="name" type="string" required>
        エラー名です (例: `'NotAllowedError'`) 。
      </ParamField>

      <ParamField body="message" type="string" required>
        発生した問題を説明するエラーメッセージです。
      </ParamField>
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="tryAnotherMethod" type="Promise<void>">
  このメソッドを使用すると、ユーザーは別の MFA方式 を試すことができます。

  ```typescript Example theme={null}
  import MfaWebAuthnRoamingChallenge from '@auth0/auth0-acul-js/mfa-webauthn-roaming-challenge';

  const mfaWebAuthnRoamingChallenge = new MfaWebAuthnRoamingChallenge();
  await mfaWebAuthnRoamingChallenge.tryAnotherMethod();
  ```
</ParamField>

<ParamField body="verify" type="Promise<void>">
  このメソッドは、セキュリティキーを使用して WebAuthn チャレンジを開始します。

  ```typescript Example theme={null}
  import MfaWebAuthnRoamingChallenge from '@auth0/auth0-acul-js/mfa-webauthn-roaming-challenge';

  const mfaWebAuthnRoamingChallenge = new MfaWebAuthnRoamingChallenge();
  await mfaWebAuthnRoamingChallenge.verify();
  ```

  **メソッドパラメーター**

  <Expandable title="パラメーター">
    <ParamField body="options">
      [CustomOptions](/ja/docs/libraries/acul/js-sdk/Screens/interfaces/CustomOptions)。
    </ParamField>

    <ParamField body="rememberDevice?" type="boolean">
      `true` の場合、今後の MFAチャレンジのためにこのブラウザーを記憶します。これは `screen.showRememberDevice` が `true` の場合にのみ適用されます。
    </ParamField>
  </Expandable>
</ParamField>
