> ## 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のトラブルシューティング

> サインイン、Organization、コンポーネント、Forms、セッションに関する問題など、Universal Portalsでよくある問題の原因と解決方法を説明します。

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

各項目では、症状、考えられる原因、解決方法を説明しています。問題の多くはポータルアプリケーションの設定に起因します。設定を確認するには、[Universal Portals用にアプリケーションを構成する](https://auth0.com/docs/ja-jp/customize/portals/configure-portal-application.md)をお読みください。

まずはテナントの[ログ](https://auth0.com/docs/ja-jp/deploy-monitor/logs.md)を確認してください。多くのエラー、特に認証やポータルへのアクセスに関するエラーは、ログに記録されています。

## サインインとアクセス

ユーザーのサインインやアクセスに関する問題が発生した場合は、以下のトラブルシューティングのヒントを確認してください。

> [accordion] ポータルのセッション終了後にログインプロンプトが表示される
>
> **考えられる原因**：ポータルのセッションが終了しても、ユーザーのAuth0セッションが有効なままであれば、ユーザーは[シングルサインオン](https://auth0.com/docs/ja-jp/authenticate/single-sign-on)によってプロンプトなしで再サインインします。ログインページが表示されるのは、Auth0セッションも終了している場合に限られます。
>
> **対処法**：これは想定どおりの動作です。ユーザーがプロンプトなしで戻れる期間を延ばしたい場合は、テナントのセッション設定でAuth0セッションを延長してください。詳細については、「[セッションとトークンの有効期間](https://auth0.com/docs/ja-jp/customize/portals/architecture.md#sessions-and-token-lifetimes)」をお読みください。

> [accordion] セッション転送トークンが拒否され、ログインページが表示される
>
> **考えられる原因**：トークンが60秒の有効期限を過ぎている、すでに使用済みである、またはポータルアプリケーションが[セッション転送トークン](https://auth0.com/docs/ja-jp/authenticate/single-sign-on/native-to-web)を受け付けない設定になっている可能性があります。PortalをOrganizationのコンテキストで開いた場合は、`organization` の値がトークンのOrganizationと一致していないことも考えられます。
>
> **対処法**：アプリ内ブラウザーを開く直前に[リフレッシュトークン](https://auth0.com/docs/ja-jp/secure/tokens/refresh-tokens)を交換し、各トークンは一度だけ使用してください。また、ポータルアプリケーションの `session_transfer` 設定を確認し、テナントのログに「Single Sign-On failed」というメッセージが記録されていないかも確認してください。詳細については、「[ネイティブアプリケーションからPortalを開く](https://auth0.com/docs/ja-jp/customize/portals/access-portals.md#open-a-portal-from-a-native-application)」をお読みください。

> [accordion] ログアウト後にユーザーが予期しないページに移動する
>
> **考えられる原因**：ログアウト後、Auth0はアプリケーションの[\*\*Allowed Logout URLs (許可されているログアウトURL) \*\*](https://auth0.com/docs/ja-jp/get-started/applications/application-settings.md#application-uris)に登録された最初のURLにユーザーをリダイレクトします。
>
> **対処法**：ユーザーの移動先にしたいURL (アプリケーションなど) をリストの先頭に配置してください。

> [accordion] 有効な接続がないためユーザーがサインインできない
>
> **考えられる原因**：ポータルアプリケーションで有効になっている接続がありません。たとえば、リストを確認する際にすべての接続をオフにしてしまった場合などが該当します。
>
> **対処法**：Auth0 Dashboardでポータルアプリケーションを開き、[**［Connections (接続) ］**](https://auth0.com/docs/ja-jp/get-started/applications/set-up-database-connections.md)タブを選択します。ユーザーが必要とする接続を少なくとも1つオンにしてください。[Organizations](https://auth0.com/docs/ja-jp/manage-users/organizations.md)を使用している場合は、Organizationでそのユーザー向けの接続が有効になっていることも確認してください。詳細については、「[有効な接続を検証する](https://auth0.com/docs/ja-jp/customize/portals/configure-portal-application.md#validate-enabled-connections)」をお読みください。

## Organizations

ビジネス向けPortalで[Auth0 Organizations](https://auth0.com/docs/ja-jp/manage-users/organizations.md)を使用する場合は、以下のトラブルシューティングのヒントを参考にしてください。

> [accordion] Organizationのコンポーネントにエラーが表示される、またはデータが表示されない
>
> **考えられる原因**：ユーザーが`organization`パラメーターを指定せずにPortalを開いたため、セッションにOrganizationが含まれていません。[My Organization API](https://auth0.com/docs/ja-jp/manage-users/my-organization-api.md)はOrganizationを対象に動作します。
>
> **解決方法**：PortalのURLに`organization`を追加してください。詳しくは、「[OrganizationのコンテキストでPortalを開く](https://auth0.com/docs/ja-jp/customize/portals/access-portals.md#open-a-portal-in-an-organization-context)」を参照してください。

> [accordion] organizationパラメーターを指定するとユーザーがPortalにサインインできない
>
> **考えられる原因**：ユーザーがOrganizationのメンバーではない、Organizationでユーザーが利用できる接続が有効になっていない、またはPortalアプリケーションでOrganizationsが許可されていない可能性があります。
>
> **解決方法**：Organizationのメンバーと接続を確認してください。また、アプリケーションの`organization_usage`が`allow`に設定されていることを確認してください。詳しくは、「[Organizationのコンテキスト](https://auth0.com/docs/ja-jp/customize/portals/configure-portal-application.md#organization-context)」を参照してください。

> [accordion] ユーザーが変更を保存した後にOrganizationのコンポーネントにエラーが表示される
>
> **考えられる原因**：ユーザーにOrganizationへの書き込み権限がありません。Portalでは権限に応じてボタンが無効化されないため、ユーザーが送信した後にエラーが表示されます。
>
> **解決方法**：コンポーネントに必要なOrganizationの権限をユーザーに付与してください。詳しくは、「[My Organization API](https://auth0.com/docs/ja-jp/manage-users/my-organization-api.md)」を参照してください。

> [accordion] PortalにOrganizationのブランディングではなくテナントのブランディングが表示される
>
> **考えられる原因**：Organizationを指定せずにPortalが開かれたか、Auth0がOrganizationの[ブランディング](https://auth0.com/docs/ja-jp/manage-users/organizations/configure-organizations/create-organizations.md)を読み込めなかった可能性があります。
>
> **解決方法**：`organization`を指定してPortalを開いてください。また、Organizationにブランディングが設定されていることを確認してください。

## コンポーネントとAPI呼び出し

Universal PortalsのコンポーネントやAPI呼び出しで問題が発生した場合は、次のヒントを参考にしてください。

> [accordion] コンポーネントに「We couldn't load this information」と表示される
>
> **考えられる原因**：ポータルアプリケーションに、[リソースサーバー](https://auth0.com/docs/ja-jp/get-started/apis)またはコンポーネントに必要なスコープに対する[クライアントへの認可](https://auth0.com/docs/ja-jp/get-started/applications/application-access-to-apis-client-grants.md)や[リフレッシュトークン](https://auth0.com/docs/ja-jp/secure/tokens/refresh-tokens)ポリシーが設定されていません。
>
> **対処法**：コンポーネントに必要なスコープを指定して、[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)に対するクライアントへの認可とリフレッシュトークンポリシーを追加してください。必要なスコープについては、「[ポータルコンポーネントライブラリのリファレンス](https://auth0.com/docs/ja-jp/customize/portals/portal-components.md#universal-components)」をお読みください。

> [accordion] 通常の使用中にコンポーネントが断続的に失敗する
>
> **考えられる原因**：ポータルアプリケーションで[リフレッシュトークンのローテーション](https://auth0.com/docs/ja-jp/secure/tokens/refresh-tokens/refresh-token-rotation)が有効になっています。ポータルはこの機能をサポートしていません。
>
> **対処法**：ポータルアプリケーションでローテーションを無効にしてください。詳細については、「[変更してはいけない設定](https://auth0.com/docs/ja-jp/customize/portals/configure-portal-application.md#settings-you-must-not-change)」をお読みください。

> [accordion] リクエストが403エラー「This audience is not allowed」で失敗する
>
> **考えられる原因**：リクエストで、テナントの[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)以外のオーディエンスが要求されました。
>
> **対処法**：コンポーネントが呼び出すのはMy Account APIとMy Organization APIのみです。ポータルアプリケーションに[リソースサーバー](https://auth0.com/docs/ja-jp/get-started/apis)に対する[クライアントへの認可](https://auth0.com/docs/ja-jp/get-started/applications/application-access-to-apis-client-grants.md)が設定されていることを確認してください。詳細については、「[許可されたリソースサーバー](https://auth0.com/docs/ja-jp/customize/portals/architecture.md#allowed-resource-servers)」をお読みください。

> [accordion] ユーザーが鑑別工具を削除する際に多要素認証（MFA）のチャレンジが表示されない
>
> **考えられる原因**：チャレンジはポップアップで開きますが、ブラウザーによってブロックされています。
>
> **対処法**：Portalドメインのポップアップを許可してから、もう一度お試しください。詳細については、「[ステップアップ認証](https://auth0.com/docs/ja-jp/customize/portals/architecture.md#step-up-authentication)」をお読みください。

> [accordion] コンポーネントに「Too many requests」と表示される
>
> **考えられる原因**：ユーザーのリクエストに[My Account API](https://auth0.com/docs/ja-jp/manage-users/my-account-api.md)のレート制限が適用されています。
>
> **対処法**：しばらく待ってから、コンポーネントの再試行ボタンを選択してください。

## Forms

> [accordion] Formは保存されるが、ユーザーが更新されない
>
> **考えられる原因**：Formの[フロー](https://auth0.com/docs/ja-jp/customize/forms/flows.md)に[Forms vault](https://auth0.com/docs/ja-jp/customize/forms/vaults.md)接続が設定されていないか、接続先のアプリケーションにユーザーを更新するためのスコープが付与されていません。
>
> **対処法**：フローに必要なスコープを持つ[マシンツーマシンアプリケーション](https://auth0.com/docs/ja-jp/get-started/auth0-overview/create-applications/machine-to-machine-apps.md)を使用してvault接続を作成してください。詳しくは、[ユーザーを更新するForms](https://auth0.com/docs/ja-jp/customize/portals/configure-portal-application.md#forms-that-update-users)を参照してください。

## セッションとログアウト

> [accordion] ユーザーが別のアプリケーションからログアウトした後にコンポーネントが動作しなくなる
>
> **考えられる原因**：ログアウトするとユーザーのAuth0セッションが終了し、Portalがアクセストークンの発行に使用する[リフレッシュトークン](https://auth0.com/docs/ja-jp/secure/tokens/refresh-tokens)が無効になります。Portalのセッションクッキーは有効期限が切れるまで残るため、Portal自体は開いたままでも、そのコンポーネントが動作しなくなることがあります。
>
> **対処法**：ユーザーに一度Portalからログアウトしてもらい、改めて開き直すよう依頼してください。詳細については、「[セッションとトークンの有効期間](https://auth0.com/docs/ja-jp/customize/portals/architecture.md#sessions-and-token-lifetimes)」をお読みください。

> [accordion] カスタムドメインに切り替えた後にパスキーが機能しなくなる
>
> **考えられる原因**：[パスキー](https://auth0.com/docs/ja-jp/authenticate/database-connections/passkeys)は、ユーザーが登録したドメインに紐付けられています。
>
> **対処法**：ユーザーは新しいドメインでパスキーを登録し直す必要があります。これを避けるには、最初から[カスタムドメイン](https://auth0.com/docs/ja-jp/customize/custom-domains.md)を使用してください。

## レイアウト

> [accordion] hide パラメーターが機能しない
>
> **考えられる原因**: パラメーター名または値が間違っています。Portal で使用できるのは `hide_sidebar=true`、`hide_topbar=true`、`hide_user_menu=true` のみです。
>
> **対処法**: パラメーター名を正確に指定し、値には `true` を使用してください。詳しくは、[アプリ内ブラウザーでポータルのナビゲーションを非表示にする](https://auth0.com/docs/ja-jp/customize/portals/access-portals.md#hide-portal-navigation-for-in-app-browsers)を参照してください。

## エラーページ

Portalの読み込み前にリクエストが失敗すると、ブラウザーにHTTPステータスとメッセージを含むエラーページが表示されます。

| **ステータス** | **メッセージ** | **意味** | **対処法** |
| - | - | - | - |
| **401** | Unauthorized | リクエストに有効なポータルセッションがありません。 | ポータルのURLを開き直して、サインインしてください。 |
| **403** | Forbidden | Portalがリクエストを拒否しました。 | ポータルアプリケーションの設定を確認してください。詳細については、「[Universal Portals用にアプリケーションを設定する](https://auth0.com/docs/ja-jp/customize/portals/configure-portal-application.md)」をお読みください。 |
| **404** | Portal not found | このドメインには、該当するスラッグのPortalが存在しません。 | ポータルURLのスラッグとドメインを確認してください。 |
| **404** | Page not found | Portalに、該当するスラッグのページが存在しません。 | ページのスラッグと、Portalのデフォルトページを確認してください。 |
| **500** | Internal server error | Portalがリクエストを処理できませんでした。 | もう一度お試しください。問題が解決しない場合は、発生時刻とポータルのスラッグを添えてAuth0 Supportにお問い合わせください。 |

## 次のステップ

> [card] [Universal Portals向けにアプリケーションを構成する](https://auth0.com/docs/ja-jp/customize/portals/configure-portal-application.md)
>
> Portalで発生するエラーの主な原因となるアプリケーション設定を確認します。