Skip to main content
認可エラーが発生したとき、コールバック URL が有効であれば、 は適切なエラーと state パラメーターをコールバック URL に返します。コールバック URL が無効な場合は、アプリケーションに デフォルトの Auth0 エラーページ が表示されます。 無効なコールバック URL 以外の理由でも、アプリケーションにデフォルトの Auth0 エラーページが表示されることがあります。たとえば、次のような場合です。
  • Auth0 Authentication API の ログイン エンドポイント を呼び出す際に、必須パラメーターが不足している。
  • ユーザーが有効期限の切れたパスワードリセットリンクを開く (Classic Login エクスペリエンスを使用している場合) 。
  • ユーザーがブックマークしたログインページを開き、Default Login Route が指定されていない。

​
パラメーター

カスタムエラーページを設定した場合、Authorization Server は、URL のクエリ文字列に付加されたパラメーターを返します。 返されるパラメーターはエラーの種類によって異なり、リクエストごとに異なります。たとえば、エラーの原因となったリクエストに client_id が含まれていなかった場合、Authorization Server は client_id パラメーターを返しません。

​
カスタムエラーページを表示する

カスタムエラーページを表示するには、2 つの方法があります。
  • Auth0 Dashboard または Auth0 Management API を使用して、ユーザーをカスタムエラーページにリダイレクトします。
  • Management API を使用して、Auth0 側でカスタムエラーページを表示するよう設定します。

​
Auth0 Dashboard を使用してユーザーをカスタムエラーページにリダイレクトする

Auth0 Dashboard を使用して、Auth0 がユーザーをカスタムエラーページにリダイレクトするよう設定します。
  1. Auth0 Dashboard > 設定 に移動します。
  2. General タブで、Error Pages セクションを探します。
  3. Default Error Page で、Custom を選択します。
  4. 表示される Custom error page URL フィールドに、ユーザーに表示するエラーページの URL を入力します。
  5. Save を選択します。

​
Management API を使用してユーザーをカスタムエラーページにリダイレクトする

の テナント設定を更新 エンドポイントを使用します。{mgmtApiAccessToken} プレースホルダーの値を Management API の に置き換え、JSON ボディ内の url フィールドの値を、エラーページの場所を指すように更新します。

​
カスタムエラーページを表示する

Classic Login ウィジェットの一部としてエラーが表示される場合 (期限切れのパスワードリセットリンクなど) は、設定されていても Auth0 でホストされるカスタムエラーページは表示されません。
Management API の テナント設定を更新 エンドポイントを使用します。{mgmtApiAccessToken} プレースホルダーの値を Management API のアクセストークンに置き換え、JSON ボディの html フィールドの値を、ページの HTML を含む文字列に更新します。 次の変数を含めるには、Liquid 構文を使用できます。
  • {client_id}
  • {connection}
  • {lang}
  • {error}
  • {error_description}
  • {tracking}
XSS の脆弱性を防ぐため、Liquid の escape フィルターと strip_html フィルターを使用して、カスタムテンプレートをサニタイズしてください。