メインコンテンツへスキップ
各項目では、症状、考えられる原因、解決方法を説明しています。問題の多くはポータルアプリケーションの設定に起因します。設定を確認するには、Universal Portals用にアプリケーションを構成するをお読みください。
まずはテナントのログを確認してください。多くのエラー、特に認証やポータルへのアクセスに関するエラーは、ログに記録されています。

​
サインインとアクセス

ユーザーのサインインやアクセスに関する問題が発生した場合は、以下のトラブルシューティングのヒントを確認してください。
考えられる原因：ポータルのセッションが終了しても、ユーザーのAuth0セッションが有効なままであれば、ユーザーはシングルサインオンによってプロンプトなしで再サインインします。ログインページが表示されるのは、Auth0セッションも終了している場合に限られます。対処法：これは想定どおりの動作です。ユーザーがプロンプトなしで戻れる期間を延ばしたい場合は、テナントのセッション設定でAuth0セッションを延長してください。詳細については、「セッションとトークンの有効期間」をお読みください。
考えられる原因：トークンが60秒の有効期限を過ぎている、すでに使用済みである、またはポータルアプリケーションがセッション転送トークンを受け付けない設定になっている可能性があります。PortalをOrganizationのコンテキストで開いた場合は、organization の値がトークンのOrganizationと一致していないことも考えられます。対処法：アプリ内ブラウザーを開く直前にリフレッシュトークンを交換し、各トークンは一度だけ使用してください。また、ポータルアプリケーションの session_transfer 設定を確認し、テナントのログに「Single Sign-On failed」というメッセージが記録されていないかも確認してください。詳細については、「ネイティブアプリケーションからPortalを開く」をお読みください。
考えられる原因：ログアウト後、Auth0はアプリケーションのAllowed Logout URLs (許可されているログアウトURL) に登録された最初のURLにユーザーをリダイレクトします。対処法：ユーザーの移動先にしたいURL (アプリケーションなど) をリストの先頭に配置してください。
考えられる原因：ポータルアプリケーションで有効になっている接続がありません。たとえば、リストを確認する際にすべての接続をオフにしてしまった場合などが該当します。対処法：Auth0 Dashboardでポータルアプリケーションを開き、［Connections (接続) ］タブを選択します。ユーザーが必要とする接続を少なくとも1つオンにしてください。Organizationsを使用している場合は、Organizationでそのユーザー向けの接続が有効になっていることも確認してください。詳細については、「有効な接続を検証する」をお読みください。

​
Organizations

ビジネス向けPortalでAuth0 Organizationsを使用する場合は、以下のトラブルシューティングのヒントを参考にしてください。
考えられる原因：ユーザーがorganizationパラメーターを指定せずにPortalを開いたため、セッションにOrganizationが含まれていません。My Organization APIはOrganizationを対象に動作します。解決方法：PortalのURLにorganizationを追加してください。詳しくは、「OrganizationのコンテキストでPortalを開く」を参照してください。
考えられる原因：ユーザーがOrganizationのメンバーではない、Organizationでユーザーが利用できる接続が有効になっていない、またはPortalアプリケーションでOrganizationsが許可されていない可能性があります。解決方法：Organizationのメンバーと接続を確認してください。また、アプリケーションのorganization_usageがallowに設定されていることを確認してください。詳しくは、「Organizationのコンテキスト」を参照してください。
考えられる原因：ユーザーにOrganizationへの書き込み権限がありません。Portalでは権限に応じてボタンが無効化されないため、ユーザーが送信した後にエラーが表示されます。解決方法：コンポーネントに必要なOrganizationの権限をユーザーに付与してください。詳しくは、「My Organization API」を参照してください。
考えられる原因：Organizationを指定せずにPortalが開かれたか、Auth0がOrganizationのブランディングを読み込めなかった可能性があります。解決方法：organizationを指定してPortalを開いてください。また、Organizationにブランディングが設定されていることを確認してください。

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

Universal PortalsのコンポーネントやAPI呼び出しで問題が発生した場合は、次のヒントを参考にしてください。
考えられる原因：ポータルアプリケーションに、リソースサーバーまたはコンポーネントに必要なスコープに対するクライアントへの認可やリフレッシュトークンポリシーが設定されていません。対処法：コンポーネントに必要なスコープを指定して、My Account APIまたはMy Organization APIに対するクライアントへの認可とリフレッシュトークンポリシーを追加してください。必要なスコープについては、「ポータルコンポーネントライブラリのリファレンス」をお読みください。
考えられる原因：ポータルアプリケーションでリフレッシュトークンのローテーションが有効になっています。ポータルはこの機能をサポートしていません。対処法：ポータルアプリケーションでローテーションを無効にしてください。詳細については、「変更してはいけない設定」をお読みください。
考えられる原因：リクエストで、テナントのMy Account APIまたはMy Organization API以外のオーディエンスが要求されました。対処法：コンポーネントが呼び出すのはMy Account APIとMy Organization APIのみです。ポータルアプリケーションにリソースサーバーに対するクライアントへの認可が設定されていることを確認してください。詳細については、「許可されたリソースサーバー」をお読みください。
考えられる原因：チャレンジはポップアップで開きますが、ブラウザーによってブロックされています。対処法：Portalドメインのポップアップを許可してから、もう一度お試しください。詳細については、「ステップアップ認証」をお読みください。
考えられる原因：ユーザーのリクエストにMy Account APIのレート制限が適用されています。対処法：しばらく待ってから、コンポーネントの再試行ボタンを選択してください。

​
Forms

考えられる原因：FormのフローにForms vault接続が設定されていないか、接続先のアプリケーションにユーザーを更新するためのスコープが付与されていません。対処法：フローに必要なスコープを持つマシンツーマシンアプリケーションを使用してvault接続を作成してください。詳しくは、ユーザーを更新するFormsを参照してください。

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

考えられる原因：ログアウトするとユーザーのAuth0セッションが終了し、Portalがアクセストークンの発行に使用するリフレッシュトークンが無効になります。Portalのセッションクッキーは有効期限が切れるまで残るため、Portal自体は開いたままでも、そのコンポーネントが動作しなくなることがあります。対処法：ユーザーに一度Portalからログアウトしてもらい、改めて開き直すよう依頼してください。詳細については、「セッションとトークンの有効期間」をお読みください。
考えられる原因：パスキーは、ユーザーが登録したドメインに紐付けられています。対処法：ユーザーは新しいドメインでパスキーを登録し直す必要があります。これを避けるには、最初からカスタムドメインを使用してください。

​
レイアウト

考えられる原因: パラメーター名または値が間違っています。Portal で使用できるのは hide_sidebar=true、hide_topbar=true、hide_user_menu=true のみです。対処法: パラメーター名を正確に指定し、値には true を使用してください。詳しくは、アプリ内ブラウザーでポータルのナビゲーションを非表示にするを参照してください。

​
エラーページ

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

​
次のステップ

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

Portalで発生するエラーの主な原因となるアプリケーション設定を確認します。