メインコンテンツへスキップ

開始する前に

必要なもの:
Auth0 CLI を使用すると、Advanced Customization for Universal Login (ACUL) の画面を実装およびテストできます。これにより、ログイン、サインアップ、パスワードレス、パスキー登録などの認証画面を、Web アプリケーションにぴったり合わせてカスタマイズできます。 次の手順に従って、Auth0 CLI を使用して ACUL プロジェクトとカスタム login_id 画面を作成します。

1. ACUL サンプルアプリケーションを初期化する

開発テナントを Auth0 CLI でまだ設定していない場合は、auth0 login コマンドを使用してテナントを設定してください。
プロジェクトを作成するディレクトリに移動し、次のコマンドを実行します。
auth0 acul init "Your_App_Name"
  1. React (with ACUL React SDK) を選択します。
  2. login-id 画面を選択します。
  3. Would you like to proceed with installing the required dependencies using ‘npm install’? と表示されたら、y を入力します。
Auth0 CLI は、指定したアプリケーション名で新しいプロジェクトディレクトリを作成します。
必要な依存関係のインストールを実行するよう求められた際に y を入力しなかった場合は、プロジェクトディレクトリに移動して npm install コマンドを実行してください。

2. (任意)プロジェクトに含める追加の画面を選択する

次のコマンドを実行して、プロジェクトで使用する追加の画面を選択します。
auth0 acul screen add SCREEN_NAME 

3. Universal Login Context Inspector を使って Login ID 画面を起動する

UL context inspector を使用して Login ID 画面を起動します。
  1. プロジェクトディレクトリに移動し、次のコマンドを実行します。
  auth0 acul dev
  1. プロジェクトディレクトリを確認します。
  2. ローカルアセットを共有するポートを選択します。デフォルトはポート 55444 です。
Universal Login Context Inspector が新しいブラウザーウィンドウで Login Id 画面を開きます。

4. サンプルの Login ID 画面を更新する

auth0 acul dev コマンドは ACUL の画面をビルドし、アセットをローカルでホストし、アセットディレクトリの更新を継続的に監視します。これにより、画面をローカルでテストできます。詳細については、Auth0 CLI acul コマンドのドキュメントを参照してください。
  1. プロジェクトディレクトリで /src/index.css ファイルを編集し、ロゴウィジェットを自分のロゴの URL に更新します:
--ul-theme-widget-logo-url: "Your-Logo-URL";
  1. 変更を保存します。
ローカルの開発サーバーは、最新の変更を自動的に反映して更新されます。

5. 認証画面用のコンテキストデータをカスタマイズする

Universal Login Context Inspector を使用すると、デフォルトのコンテキストデータをカスタマイズして、テナント固有の設定に対して認証画面をテストできます。
  1. プロジェクト内の特定の画面用に、モックコンテキストデータのローカル版を作成します。
Download JSON アイコンを選択して、モックコンテキストデータファイルをダウンロードします。
Auth0 Dashboard の ACUL ページ
  1. ダウンロードしたファイルの名前を変更して public/screens/{prompt}/{screen} に移動し、プロジェクトディレクトリ内の public/manifest.json ファイルに追加します。
たとえば、ダウンロードした login-id-login-id-context.json ファイルの名前を login-id.json に変更し、/public/screens/login-id/login-id.json に移動します。
  1. Universal Login Context Inspector の Data source から Local Development を選択して、その画面用のモックコンテキストのローカル版を読み込みます。
詳細については、Auth0 CLI ACUL のドキュメントを参照してください。