Auth0では、Auth0 Dashboard内で検索可能なフィールドに対するフィルター式を作成できる機能を提供し、テナントユーザーがアプリケーションをより直感的に検索できるようにしています。そのためテナントユーザーは、何百ものリソースが並ぶページ分割されたリストをスクロールしなくても、次のようなフィールドを対象にクエリを実行できます。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.
- アプリケーション名(Travel0-native)
- アプリケーションまたはユーザーのメタデータ(権限)
- アプリケーションタイプ(SPA)
仕組み
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文字以上」というメッセージが表示され、クエリは送信されません。 - 完全一致フィールド
- メタデータフィールド
- キーと値:キーと値を入力すると、そのキーが特定の値と一致するリソースを検索できます。たとえば、キーを
environment、値をproductionとすると、app_metadata.environmentがproductionと等しいリソースのみが返されます。値については前方一致がサポートされており、prodと入力すると、production、prod-eu、prod-usが一致します。- キーのみ:キーを入力し、値を指定せずにEnterキーを押します。これにより、そのメタデータキーが設定されているすべてのリソースが、その値に関係なく返されます。特定のキーを使用しているリソースをすべて見つけるのに便利です。
tier.bronze、値をtrueとすると、app_metadata.tier.bronzeがtrueと等しいリソースが返されます。
特定のキーと値の組み合わせに一致する結果を除外するには、値の前にNOTを付けます。たとえば、キーをcolor、値をNOT orangeとすると、 colorが orange以外に設定されているすべてのリソースが返されます。キーは完全一致でなければなりません。メタデータでは、Contains(部分一致)やends-with(後方一致)による検索はサポートされていません。値は最大64文字までインデックスされ、それを超える長い値は検索対象外となります。
- 列挙型フィールド
NativeとSPAを選択すると、NativeおよびSPAのすべてのアプリケーションが返されます。
- ブール型フィールド
trueまたはfalseを選択して、ファーストパーティクライアントを検索します。これを使用して、(同意画面のスキップが認可されている)ファーストパーティアプリケーションとサードパーティアプリケーションを区別できます。
検索可能なフィールド
アプリケーション
| フィールド | 説明 | 一致タイプ |
|---|---|---|
| 名前 | アプリケーション名 | 部分一致 |
クライアントID (client_id) | 一意のクライアントID | 完全一致 |
外部クライアントID (external_client_id) | アプリケーションの外部識別子 | 完全一致 |
| メタデータ | アプリケーションに保存されたカスタムのキーと値のメタデータ | 完全一致または前方一致 |
| アプリケーションタイプ | Native、SPA、通常のWebアプリ、マシンツーマシン | 列挙型選択 |
| ファーストパーティクライアント | アプリケーションがファーストパーティかサードパーティか | ブール型 |
制限事項
- 検索には最大5つのフィルターを適用できます。検索バーで6つ目のフィルターを追加することはできません。
- 検索結果には、直近の数秒間に行われた変更が反映されていない場合があります。これはインデックスが最終的整合性に基づいているためです。
- 通常の条件では、検索結果は2秒以内に返されます。クエリがタイムアウトした場合は、フィルターの数を減らすか、より具体的な検索条件を使用してください。
クエリの例
クライアントIDでのアプリケーションの検索
これはエラーログやサポートチケットからclient_idを取得しており、アプリケーションをすばやく特定する必要がある場合に使用します。
- **Auth0 Dashboard > アプリケーション > アプリケーション**に移動します。
- 検索バーをクリックし、クライアントIDを選択します。
client_idの完全な値を貼り付けます。一致するアプリケーションが直ちに表示されます。
メタデータを使用したアプリケーションの検索
アプリケーションに環境ラベル、プラン階層、外部IDなどのカスタムメタデータが保存されている場合、それらの値を使って検索できます。- **Auth0 Dashboard > アプリケーション > アプリケーション**に移動します。
- 検索バーをクリックし、メタデータを選択します。
- メタデータキー(例:
environment)を入力します。 - 値(例:
production)を入力します。metadata.environmentがproductionと等しいアプリケーションが結果に表示されます。前方一致で検索する場合は、prodのように部分的な値を入力します。