Universal Portals クイックスタート

Auth0 Dashboard、Auth0 CLI、または Auth0 Agent Skills を使って、最初の Universal Portal を作成しましょう。

動作するPortalを作成して、ブラウザーで開きます。以下のどのオプションを選んでも、Portal本体、その基盤となるアプリケーション、必要なAPIアクセスがまとめて作成されるため、すぐにテストを始められます。

セットアップでは次のリソースが作成されます。

• My Account APIとMy Organization API：Portalが呼び出すリソースサーバーです。まだ存在しない場合に作成されます。
• 通常のWebアプリケーション：Portalにリンクされるアプリケーションです。1つのPortalが使用するアプリケーションは必ず1つです。
• クライアントグラント：My Account APIとMy Organization APIへのスコープ付きアクセスです。
• Portal：デフォルトのテンプレートで作成されます。

​

前提条件

• Universal Portalsが有効になっているAuth0テナント

Portalsを最大限に活用するには、カスタムドメインを使用してください。カスタムコードなどの一部の機能はAuth0ドメインでは利用できません。また、Auth0ドメインでユーザーが登録したパスキーは、後からカスタムドメインに切り替えた場合、再登録が必要になります。

​

Portalを作成する

Auth0 Dashboard

1. Portalsを開く

   Auth0 Dashboard > Portalsに移動します。

2. Portalを作成する

   Create Portalを選択し、NameとSlugを入力して、Createを選択します。

   スラッグはポータルURLの一部になります。英小文字、数字、ハイフンを使用し、先頭は英字にしてください。

   Auth0によって、アプリケーションとクライアントグラント、そしてデフォルトのテンプレートが適用されたPortalが作成されます。

3. Portalをプレビューする

   上部バーにUnpublished changesと表示されている場合は、Publishを選択します。次にPreviewを選択すると、最後に公開されたバージョンのPortalが新しいタブで開きます。

Auth0 CLI

1. Auth0 CLIのBeta版をインストールする

   お使いのプラットフォームに応じたインストール手順に従ってインストールし、テナントにサインインします。

   Homebrewで安定版のauth0 CLIをインストールしている場合、そちらが優先され、Beta版のバイナリが使用されません。このガイドのコマンドを記載どおりに動作させるには、シェルの設定に次のエイリアスを追加してください。

   alias auth0-beta="$(brew --prefix auth0-beta)/bin/auth0"
   

   auth0-beta login
   
2. setupコマンドを実行する

   auth0-beta universal-portals setup
   

   エイリアスのauth0-beta up setupも使用できます。コマンドが完了すると、ポータルURLが表示されます。

Auth0 Agent Skills

1. Auth0 Agent Skillsをインストールする

   npx skills add auth0/agent-skills
   
2. AI agentにUniversal Portalsの設定を依頼する

   configure universal portals on my auth0 tenant
   

   エージェントの処理が完了すると、ポータルURLが表示されます。詳しくは、GitHubのAuth0 Agent Skillsを参照してください。

​

ポータルを確認する

ブラウザーでポータルの URL を開きます。

https://YOUR_DOMAIN/portals/{slug}

YOUR_DOMAIN はカスタムドメインです。カスタムドメインがない場合は Auth0 ドメインを使用します。{slug} は選択したスラッグです。

テストユーザーでサインインします。Portal のデフォルトページが開き、デフォルトテンプレートのコンポーネントが表示されます。

ポータル URL は Portal のデフォルトページを開くため、Portal にデフォルトページが設定されている場合にのみ機能します。デフォルトテンプレートには、デフォルトページがあらかじめ設定されています。「Page not found」と表示された場合は、デフォルトページを設定するか、https://YOUR_DOMAIN/portals/{slug}/pages/{pageSlug} でページを直接開いてください。設定方法については、Universal Portals を構成するを参照してください。

​

次のステップ

Universal Portalsを構成する

Portalにコンポーネント、Auth0 Forms、ナビゲーション、ブランディングを追加します。

Universal Portals用にアプリケーションを構成する

既存のアプリケーションをリンクするか、アプリケーションをご自身で構成します。

Portalにアクセスする

Webアプリケーションやネイティブアプリケーションからユーザーを Portal に誘導します。