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

# Universal Portals

> Auth0 Universal Portalsについて説明します。Universal Portalsはホスト型のセルフサービスポータルで、エンドユーザーは自分のアカウントを、Organization 管理者は自分のOrganizationを管理できます。

> [!WARNING]
>
> **Auth0 Universal Portals機能は現在、です。**

Auth0 Universal Portalsは、Auth0がホストするセルフサービス型のポータルです。エンドユーザーは自分のアカウントを、Organization 管理者は自分のOrganizationを管理できるため、お客様がインターフェースを構築、ホスト、保守する必要はありません。

各ポータルは構築済みの[コンポーネント](https://auth0.com/docs/ja-jp/get-started/universal-components/universal-components-overview.md)を使って作成でき、Auth0がお客様のドメイン上のURLでポータルをホストします。

ユーザーがアプリケーションからポータルを開くと、ポータルは個人設定の管理には[My Account API](https://auth0.com/docs/ja-jp/manage-users/my-account-api.md)を、Organizationの管理には[My Organization API](https://auth0.com/docs/ja-jp/manage-users/my-organization-api.md)を呼び出します。両方を呼び出す場合もあります。

Componentsパネルを開いた状態のビジュアルエディター。Formコンポーネントをパネルからドラッグしてページにドロップすると、新しいブロック内に表示されます。

## ユースケース

Universal Portals は次のユースケースに対応しています。

### コンシューマーポータル

エンドユーザーが自分のアカウントを管理できるページを提供します。エンドユーザーはこのページで、プロファイルの更新、[多要素認証 (MFA) ](https://auth0.com/docs/ja-jp/secure/multi-factor-authentication.md)の認証要素やパスキーの登録、セキュリティ設定の確認を行えます。コンシューマーポータルは、本来なら自前で構築・ホストする必要がある**My Account**ページに代わるもので、[My Account API](https://auth0.com/docs/ja-jp/manage-users/my-account-api.md)を使用します。

![コンシューマーポータルの例](https://mintlify.s3.us-west-1.amazonaws.com/auth0/docs/images/customize/portals/universal-portal-b2c-example.png)

### ビジネスポータル

Organization 管理者に、自身の Organization を管理するためのページを提供します。管理者はこのページで Organization の詳細を編集したり、ドメインを検証したりできます。ビジネスポータルは、本来なら自社で構築・ホストする必要がある **My Organization** ページに代わるもので、[My Organization API](https://auth0.com/docs/ja-jp/manage-users/my-organization-api.md) を使用します。特定の Organization のビジネスポータルを開く方法については、[ポータルへのアクセス](https://auth0.com/docs/ja-jp/customize/portals/access-portals.md#open-a-portal-in-an-organization-context)をお読みください。

![ビジネスポータルの例](https://mintlify.s3.us-west-1.amazonaws.com/auth0/docs/images/customize/portals/universal-portal-b2b-example.png)

### 統合ポータル

ポータルでは、両方の種類のコンポーネントを組み合わせて提供することもできます。たとえば、1つのページでMFAの管理とOrganizationの詳細を並べて表示できます。ユーザーに必要なコンポーネントを追加し、各コンポーネントが呼び出すリソースサーバーへのアクセス権をポータルアプリケーションに付与してください。

## 主な機能

* ビジュアルビルダー：構築済みのコンポーネントを組み合わせてポータルページを作成できます。
  * アイデンティティコンポーネント：[Universal Components](https://auth0.com/docs/ja-jp/get-started/universal-components/universal-components-overview.md)を使用して、プロファイル管理、MFAとパスキーの登録、Organizationの詳細、検証済みドメインを扱えます。
  * [Auth0 Forms](https://auth0.com/docs/ja-jp/customize/forms.md)：プロファイルの更新、ポリシーへの同意、連絡設定など、エンドユーザーから情報を収集できます。
  * レイアウトコンポーネント：見出し、リッチテキスト、セクション、区切り線、画像を追加できます。
* ポータルごとに1つのアプリケーション：各ポータルには、それぞれAuth0の[通常のWebアプリケーション](https://auth0.com/docs/ja-jp/get-started/auth0-overview/create-applications/regular-web-apps.md)が紐づいています。詳細については、「[Universal Portals用にアプリケーションを構成する](https://auth0.com/docs/ja-jp/customize/portals/configure-portal-application.md)」をお読みください。
* ブランディングの継承：ポータルにはテナントのロゴ、色、フォントが適用されます。[Organization](https://auth0.com/docs/ja-jp/manage-users/organizations.md)のコンテキストでは、そのOrganizationのブランディングが適用されます。
* Auth0によるホスティング：導入、スケーリング、保守は一切不要です。
* 安全なトークン処理：アクセストークンとリフレッシュトークンはポータルサーバーが保持し、ブラウザーには安全なセッションクッキーのみが保存されます。
* 自動MFAステップアップ：テナントのポリシーとアクションに基づいて、Auth0がオペレーションにMFAを要求した場合、ポータルがチャレンジを提示し、ユーザーがそれを完了するとオペレーションを自動的に再試行します。

ポータルでサポートされているすべてのコンポーネントについては、「[ポータルコンポーネントライブラリリファレンス](https://auth0.com/docs/ja-jp/customize/portals/portal-components.md)」をお読みください。

## 仕組み

アプリケーションにサインイン済みのユーザーがポータルのURLを開くと、ポータルサーバーはログインプロンプトを表示せずに、シングルサインオン (シングルサインオン（SSO）：ユーザーが1つのアプリケーションにログインすると、他のアプリケーションにも自動的にログインさせるサービスです。シングルログアウトは、これと逆の流れで同様に機能します。)でユーザーをサインインさせます。Auth0がアクセストークン (アクセストークン：アプリケーションがAPIにアクセスするために使用できる認証情報です。トークンの所持者が、APIへのアクセスと、付与されたスコープで指定された特定のアクションの実行を認可されていることをAPIに伝えます。)とリフレッシュトークン (リフレッシュトークン：新しいアクセストークンを取得するために使用できる特別な種類のトークンです。ユーザーに再ログインを求めることなく、有効期限が近づいたアクセストークンを更新するのに役立ちます。)を発行し、ポータルサーバーがそれらを保存します。コンポーネントがデータを必要とする場合、ポータルサーバーはリフレッシュトークンを使ってそのAPI用のアクセストークンを取得し、ユーザーに代わってAPIを呼び出します。

```mermaid theme={null}
flowchart LR
    user("ユーザー") --> app["ご利用のアプリケーション"]
    app -- "Opens the portal" --> portal["ポータルサーバー"]
    portal -- "Sign-in and tokens" --> auth0["Auth0"]
    portal -- "Calls with access tokens" --> rs["リソースサーバー"]
```

ポータルのセッションの有効期間は最長1日で、無操作の状態が1時間続くと終了します。

詳しくは、[Universal Portalsのアーキテクチャ](https://auth0.com/docs/ja-jp/customize/portals/architecture.md)をご覧ください。

## サポートされるリソースと制限事項

ポータルは以下をサポートしています。

| 機能 | サポート内容 |
| - | - |
| リソースサーバー | Universal Componentsは[My Account API](https://auth0.com/docs/ja-jp/manage-users/my-account-api.md)と[My Organization API](https://auth0.com/docs/ja-jp/manage-users/my-organization-api.md)を呼び出します。Auth0 Formsはフローを通じて任意のAPIを呼び出せます。 |
| コンポーネント | MFA、[パスキー](https://auth0.com/docs/ja-jp/authenticate/database-connections/passkeys)、Organizationの詳細、検証済みドメイン用のUniversal Components、Auth0 Forms、見出し、リッチテキスト、セクション、区切り線、画像 |
| アプリケーション | Webアプリケーションとネイティブアプリケーション |
| Organizations | ポータルはOrganizationのコンテキストで開くことができます |
| ドメイン | カスタムドメインまたはAuth0ドメイン |

ポータルには以下の制限事項があります。

* ポータルがサポートしているのは、Universal Componentsの一部のみです。サポート対象については、[ポータルコンポーネントライブラリリファレンス](https://auth0.com/docs/ja-jp/customize/portals/portal-components.md)を参照してください。
* カスタムコードを使用するには、カスタムドメインが必要です。

## Universal PortalsとUniversal Components

Universal Portalsを使用すると、Auth0がホストするページにユーザーを誘導できます。

[Universal Components](https://auth0.com/docs/ja-jp/get-started/universal-components/universal-components-overview.md)を使用すると、ユーザーアカウントとOrganizationの管理機能をアプリケーションに埋め込むことができます。

| | **Universal Components (埋め込み型) **  | **Universal Portals (ホスト型) **  |
| - | - | - |
| お客様の責任範囲 | コンポーネントを組み込むアプリケーション | ページのコンテンツと設定 |
| 認証とトークン | Auth0 SDKを使用して、コンポーネントをAuth0と連携させます | ポータルが認証フローを処理し、トークンをバックエンドで安全に保管します |
| [ステップアップ認証](https://auth0.com/docs/ja-jp/secure/multi-factor-authentication/step-up-authentication.md#add-step-up-authentication) | Auth0 SDKを使用してMFAのステップアップフローを実装するため、体験を細部まで制御できます | ポータルがMFAのステップアップフローを標準で処理します |
| エンドユーザーのフロー | アプリケーション内で完結します | 別のポータルURLが開きます |
| 選択の目安 | リダイレクトを発生させずに、アプリケーション内の体験を細部まで制御したい場合 | より迅速にリリースし、ホスト型体験全体の保守とセキュリティのベストプラクティスへの対応をAuth0に任せたい場合 |

## 次のステップ

> [card] [Universal Portalsのクイックスタート](https://auth0.com/docs/ja-jp/customize/portals/quickstart.md)
>
> 数分で最初のポータルを作成できます。

> [card] [Universal Portalsのアーキテクチャ](https://auth0.com/docs/ja-jp/customize/portals/architecture.md)
>
> ポータルがユーザーをサインインさせ、ユーザーに代わってAPIを呼び出し、セッションを管理する仕組みについて説明します。

> [card] [Portalコンポーネントライブラリのリファレンス](https://auth0.com/docs/ja-jp/customize/portals/portal-components.md)
>
> 利用可能なコンポーネントと、それぞれのリソースサーバーおよびスコープを確認できます。