エラーメッセージを確認する

次のいずれかの場所に表示されているエラーメッセージを確認します:

  • ブラウザーとHTMLページの応答

  • 開発者ツールのネットワークとコンソールのタブ

  • 認証サーバーの応答

  • 非推奨エラー

ブラウザーエラーを確認する

HARファイルは、WebブラウザとWebサーバーのやり取りのJSON形式のログです。認証が期待どおりに機能しない場合は、HARファイルを生成して分析し、問題を特定できます。

ログイン画面を確認する

ロックログインウィジェットには、ユーザー名やパスワードが正しくないなどの特定の種類の問題に関するエラーメッセージが表示されます。Auth0の標準エラー ページを使用している場合は、詳細情報リンクを確認してください。

ログを確認する

Auth0は、ダッシュボード管理者のアクション、成功したユーザー認証と失敗したユーザー認証、パスワード変更要求などのログデータを保存します。Dashboardでログを表示できます。

一部の種類のエラーはログに表示されません。たとえば、リモートIDプロバイダーでエラーが発生し、認証が完了しず、ユーザーがAuth0に戻らない場合は、ログにエントリが記録されません。

Auth0ログをエクスポートして、自分で保存するか、外部ログサービスに自動的にプッシュすることができます。この機能は、データ保持要件とログ分析要件に役立ちます。Auth0拡張機能をインストールして構成し、Sumo LogicやLogglyなどの別のプロバイダーにログを自動的にエクスポートすることができます。詳細については、Auth0 Marketplaceのログストリーミングソリューションを参照してください。

また、Management APIを使用してログをエクスポートして保存することもできます。使用可能なエンドポイントは2つあり、それぞれがわずかに異なる情報を提供します。

すべてのログを検索する/get_logsエンドポイント

ログイベントを検索するエンドポイントは、指定した検索条件に一致するログエントリを取得します。検索条件を指定しない場合は、使用可能なすべてのエントリのリストが表示されます。

qパラメーターを使用して検索条件を指定し、fieldsパラメーターを使用して特定のフィールドを取得できます。

APIにアクセスするには、Management APIv2トークンが必要です。

このサンプル要求は、成功したログインのすべてのログを取得します（成功したログインのイベントの頭字語はsです）。ログエントリごとに取得するフィールドのリストは次のとおりです。date、description、client_id、およびlog_id。

使用できる検索条件の詳細とイベントの頭字語のリストについては、ログイベントの検索エンドポイントを参照してください。

単一のログエントリを取得する/get_logs_by_idエンドポイント

IDによるログイベントの取得エンドポイントは、指定されたIDに関連付けられたログエントリを取得します。

このサンプル要求は、ID 90020180129170850881585554625888895190928456277777449010のログエントリを1つ取得します。

ログで非推奨エラーを確認する

Auth0の機能が非推奨になると、テナントログにエラーまたは通知が表示され、アプリケーションが非推奨の機能を使用していることが示される場合があります。ログで、機能が非推奨になったことを示す可能性のある特定の非推奨エントリを検索できます。

レート制限とその他のエラー

Auth0は、レート制限を超えたときに報告されるエラーに対して一意のエラーコードを提供します。レート制限エラーを確認するためにログの自動スキャンを設定する必要があります。そうすることで、ユーザーに大きな問題を引き起こす前に、レート制限に達するアクティビティにプロアクティブに対処できます。Auth0は他の種類のエラーのエラーコードも公開しており、認証エラーやAuth0 Management API呼び出しのエラーのログをスキャンすると便利です（Management APIエラーコードは、Management API Explorerの各呼び出しの下に表示されます）。

ルール内からユーザープロファイル情報を取得するためにManagement APIを呼び出すことは、レート制限の発生の一般的な原因になります。なぜなら、そのようなAPIはすべてのログインと定期的なセッションチェックを呼び出すからです。

リアルタイムWebタスクログエラーコンソールを確認する

console.log()ステートメントをルール、フック、カスタム データベーススクリプト、およびWebタスクに配置できます。これらのステートメントからの出力は、リアルタイムWebログで表示できます。リアルタイムWebタスクログ拡張機能をインストールすると、ルール、フック、カスタムDBスクリプトエディターウィンドウの下にある［Debug（デバッグ）］ボタンから、またはWebタスクのWebタスクコンソールから、このログコンソールの表示を開始できます。

もっと詳しく