MfaWebAuthnRoamingEnrollment

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

MfaWebAuthnRoamingEnrollment クラスは、mfa-webauthn-roaming-enrollment 画面の機能を提供します。この画面は、ユーザーが WebAuthn のローミング認証器 (たとえばセキュリティキー) を登録する必要がある場合に表示されます。

​

コンストラクター

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

Example

import MfaWebAuthnRoamingEnrollment from '@auth0/auth0-acul-js/mfa-webauthn-roaming-enrollment';

const mfaWebAuthnRoamingEnrollment = new MfaWebAuthnRoamingEnrollment();
await mfaWebAuthnRoamingEnrollment.enroll();

​

プロパティ

branding · BrandingMembers

ブランディングテーマや設定など、ブランディング関連の構成を提供します。

client · ClientMembers

mfa-webauthn-roaming-enrollment 画面向けに、id、name、logoUrl などのクライアント関連の構成を提供します。

organization · OrganizationMembers

id や name など、ユーザーの組織に関する情報を提供します。

prompt · PromptMembers

認証フロー内の現在のプロンプトに関するデータが含まれます。

screen · ScreenMembersOnMfaWebAuthnRoamingEnrollment

構成やコンテキストなど、mfa-webauthn-roaming-enrollment 画面に固有の詳細が含まれます。

tenant · TenantMembers

id や関連するメタデータなど、テナントに関するデータが含まれます。

transaction · TransactionMembers

有効な識別子やフローの状態など、mfa-webauthn-roaming-enrollment 画面に固有のトランザクションデータを提供します。

untrustedData · UntrustedDataMembers

MFA WebAuthn roaming enrollment 中のユーザー入力など、SDK に渡された信頼できないデータを扱います。

user · UserMembers

username、email、roles など、現在のユーザーの詳細が含まれます。

​

メソッド

changeLanguage · Promise<void>

このメソッドは、Universal Login ページの表示言語を変更します。

Example

import MfaWebAuthnRoamingEnrollment from '@auth0/auth0-acul-js/mfa-webauthn-roaming-enrollment';

const mfaWebAuthnRoamingEnrollment = new MfaWebAuthnRoamingEnrollment();
mfaWebAuthnRoamingEnrollment.changeLanguage({
  language: 'fr',
});

メソッドのパラメータ

表示 パラメータ

options

LanguageChangeOptions。

language · string · 必須

使用する言語のロケールコード (たとえば、'en'、'fr'、'es') 。

persist? · "session"

'session' に設定すると、選択した言語はセッションの間保持されます。

enroll · Promise<void>

このメソッドは、WebAuthn 資格情報の作成を開始し、その結果をサーバーに送信します。

Example

import MfaWebAuthnRoamingEnrollment from '@auth0/auth0-acul-js/mfa-webauthn-roaming-enrollment';

const mfaWebAuthnRoamingEnrollment = new MfaWebAuthnRoamingEnrollment();
await mfaWebAuthnRoamingEnrollment.enroll();

getErrors · Error []

このメソッドは、context からトランザクションエラーの配列を取得します。存在しない場合は空の配列を返します。

showError · Promise<void>

このメソッドは、WebAuthn のブラウザーエラーの詳細をサーバーに送信します。

Example

import MfaWebAuthnRoamingEnrollment from '@auth0/auth0-acul-js/mfa-webauthn-roaming-enrollment';

const mfaWebAuthnRoamingEnrollment = new MfaWebAuthnRoamingEnrollment();
await mfaWebAuthnRoamingEnrollment.showError({
  error: { name: 'NotAllowedError', message: 'The operation was not allowed.' },
});

メソッドのパラメータ

表示 パラメータ

options

CustomOptions。

error · WebAuthnErrorDetails · 必須

報告対象となる、WebAuthn API (navigator.credentials.create()) から返されるエラーオブジェクト。

name · string · 必須

エラー名 (例: 'NotAllowedError') 。

message · string · 必須

発生した問題の内容を示すエラーメッセージ。

tryAnotherMethod · Promise<void>

このメソッドを使用すると、ユーザーは別の MFA方式 を試すことができます。

Example

import MfaWebAuthnRoamingEnrollment from '@auth0/auth0-acul-js/mfa-webauthn-roaming-enrollment';

const mfaWebAuthnRoamingEnrollment = new MfaWebAuthnRoamingEnrollment();
await mfaWebAuthnRoamingEnrollment.tryAnotherMethod();