メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs-staging.auth0-mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Auth0では、Auth0 Dashboard内で検索可能なフィールドに対するフィルター式を作成できる機能を提供し、テナントユーザーがアプリケーションをより直感的に検索できるようにしています。そのためテナントユーザーは、何百ものリソースが並ぶページ分割されたリストをスクロールしなくても、次のようなフィールドを対象にクエリを実行できます。
  • アプリケーション名(Travel0-native)
  • アプリケーションまたはユーザーのメタデータ(権限)
  • アプリケーションタイプ(SPA)
Auth0 Dashboardは、登録された全リソースを対象に、リアルタイムで一致する検索結果を返します。

仕組み

Auth0 Dashboardのアプリケーションセクションにある検索バーは、ガイド付きのフィルターインターフェイスとブール検索を使用しています。この検索バーは、フィルター可能なフィールドを一覧表示するドロップダウンメニューとして機能します。フィールドを選択して値を入力すると、その条件が結果の上部に削除可能なタグとして追加されます。フィルターは最大5つまで同時に組み合わせることができます。 各フィルターを追加するごとに、検索結果はさらに絞り込まれます。結果を指定するには、異なるフィールド間でAND/ORのロジックを組み合わせます。フィルターの内容はURLにクエリパラメータとして反映されます。URLをコピーしてチームメンバーと共有したり、ブックマークして後で同じフィルター済みビューを再表示することもできます。
ブール検索の例アプリケーションタイプNativeまたはSPAでフィルターし、さらにファーストパーティクライアントtrueに設定すると、結果にはNativeまたはSPAのいずれかのファーストパーティアプリケーションのみが表示されます。通常のWebアプリやサードパーティアプリは除外されます。

フィールドタイプ別の検索動作

Auth0 Dashboardの検索は、フィールドタイプに基づいて一致する結果を返します。
  • 文字列フィールド(名前、ID):部分一致に対応しています。paymentsと入力すると、「Payments-application」、「Corp Payments Service」などが見つかります。単語の順序は関係ありません。特定の語句に一致する結果を除外するには、その語の前にNOT-Noなどを付けます。たとえば、名前フィールドにNOT testと入力すると、名前に”test”を含まないすべてのリソースが返されます。ワイルドカード検索には少なくとも3文字が必要で、それ未満を入力すると「3文字以上」というメッセージが表示され、クエリは送信されません。
  • 完全一致フィールド
完全なID値を入力する必要があります。IDの一部を入力しても結果は返されません。ログやサポートチケットなどで特定のクライアントIDがわかっている場合に、このフィールドを使用してください。
  • メタデータフィールド
メタデータは、キーと値、またはキーのみで検索できます。
  • キーと値:キーと値を入力すると、そのキーが特定の値と一致するリソースを検索できます。たとえば、キーをenvironment、値をproduction とすると、app_metadata.environmentproductionと等しいリソースのみが返されます。値については前方一致がサポートされており、prodと入力すると、productionprod-euprod-usが一致します。
    • キーのみ:キーを入力し、値を指定せずにEnterキーを押します。これにより、そのメタデータキーが設定されているすべてのリソースが、その値に関係なく返されます。特定のキーを使用しているリソースをすべて見つけるのに便利です。
ドット表記法を使用して、最大2階層までのネストされたメタデータキーも検索できます。たとえば、キーをtier.bronze、値をtrueとすると、app_metadata.tier.bronzetrueと等しいリソースが返されます。 特定のキーと値の組み合わせに一致する結果を除外するには、値の前にNOTを付けます。たとえば、キーをcolor、値をNOT orangeとすると、 colororange以外に設定されているすべてのリソースが返されます。キーは完全一致でなければなりません。メタデータでは、Contains(部分一致)やends-with(後方一致)による検索はサポートされていません。値は最大64文字までインデックスされ、それを超える長い値は検索対象外となります。
  • 列挙型フィールド
あらかじめ定義されたリストから、1つ以上のアプリケーションタイプを選択します。同一フィルター内で複数選択した場合はORロジックが適用されます。たとえば、NativeSPAを選択すると、NativeおよびSPAのすべてのアプリケーションが返されます。
  • ブール型フィールド
trueまたはfalseを選択して、ファーストパーティクライアントを検索します。これを使用して、(同意画面のスキップが認可されている)ファーストパーティアプリケーションとサードパーティアプリケーションを区別できます。

検索可能なフィールド

アプリケーション

フィールド説明一致タイプ
名前アプリケーション名部分一致
クライアントID (client_id)一意のクライアントID完全一致
外部クライアントID (external_client_id)アプリケーションの外部識別子完全一致
メタデータアプリケーションに保存されたカスタムのキーと値のメタデータ完全一致または前方一致
アプリケーションタイプNative、SPA、通常のWebアプリ、マシンツーマシン列挙型選択
ファーストパーティクライアントアプリケーションがファーストパーティかサードパーティかブール型

制限事項

  • 検索には最大5つのフィルターを適用できます。検索バーで6つ目のフィルターを追加することはできません。
  • 検索結果には、直近の数秒間に行われた変更が反映されていない場合があります。これはインデックスが最終的整合性に基づいているためです。
  • 通常の条件では、検索結果は2秒以内に返されます。クエリがタイムアウトした場合は、フィルターの数を減らすか、より具体的な検索条件を使用してください。

クエリの例

クライアントIDでのアプリケーションの検索

これはエラーログやサポートチケットからclient_idを取得しており、アプリケーションをすばやく特定する必要がある場合に使用します。
  1. **Auth0 Dashboard > アプリケーション > アプリケーション**に移動します。
  2. 検索バーをクリックし、クライアントIDを選択します。
  3. client_idの完全な値を貼り付けます。一致するアプリケーションが直ちに表示されます。

メタデータを使用したアプリケーションの検索

アプリケーションに環境ラベル、プラン階層、外部IDなどのカスタムメタデータが保存されている場合、それらの値を使って検索できます。
  1. **Auth0 Dashboard > アプリケーション > アプリケーション**に移動します。
  2. 検索バーをクリックし、メタデータを選択します。
  3. メタデータキー(例:environment)を入力します。
  4. 値(例:production)を入力します。metadata.environmentproduction と等しいアプリケーションが結果に表示されます。前方一致で検索する場合は、prodのように部分的な値を入力します。

トラブルシューティング

結果が見つかりません フィルターの値のスペルが正しいことを確認してください。文字列フィールドの場合は、より短い、またはより一般的な用語をお試しください。メタデータフィールドの場合は、正確なキー名であることを確認してください。キーは大文字・小文字を区別し、完全一致である必要があります。メタデータではContains(部分一致)形式の一致はサポートされていないため、前方一致を使用してください。アプリケーションIDなどの完全一致フィールドでは、必ず完全なID値が貼り付けられていることを確認してください。 結果が古い可能性があります 検索結果は最終的整合性に基づいているため、直近の数秒の変更が反映されていない場合があります。リソースを最近作成または更新した場合は、数秒待ってから検索を再度お試しください。 検索がタイムアウトしました アクティブなフィルターの数を減らすか、より具体的な検索語を使用してください。問題が解決しない場合は、Auth0サポートにお問い合わせください。