> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev-fix-docs-5528-php-updates.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Auth0 Dashboardでのフィールド指定の検索とフィルタリング

> Auth0 Dashboardで、名前、ID、タイプ、メタデータを使用してAuth0のリソースを検索・フィルタリングできます。

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "beta": "Beta",
    "ea": "Early Access"
  };
  const stageText = stageTextMap[stage] || "a product release stage";
  const prsLink = "/docs/troubleshoot/product-lifecycle/product-release-stages";
  const linkify = (text, url) => {
    return <a href={url} target="_blank" rel="noreferrer" class="link">{text}</a>;
  };
  const includeDetails = (plans, contact, terms) => {
    const hasDetails = terms || plans || contact;
    if (!hasDetails) return null;
    return <span data-as="p">
            {plans && <>This feature is available for {linkify(`${plans} plans`, "https://auth0.com/pricing")}. </>}
            {contact && "To participate, contact " + contact + ". "}
            {terms && <>By using this feature, you agree to the applicable Free Trial terms in Okta's {linkify("Master Subscription Agreement", "https://www.okta.com/legal")}.</>}
        </span>;
  };
  return <Warning>
            <span data-as="p">
                <strong>The {feature} feature is in {linkify(stageText, prsLink)}.</strong>
            </span>

            {includeDetails(plans, contact, terms)}
        </Warning>;
};

<ReleaseStageNotice feature="Auth0 Dashboard Search" stage="beta" contact="Auth0 Support" terms="true" />

Auth0では、Auth0 Dashboard内で検索可能なフィールドに対するフィルター式を作成できる機能を提供し、テナントユーザーが[アプリケーション](https://manage.auth0.com/#/applications)をより直感的に検索できるようにしています。そのためテナントユーザーは、何百ものリソースが並ぶページ分割されたリストをスクロールしなくても、次のようなフィールドを対象にクエリを実行できます。

* アプリケーション名（Travel0-native）
* アプリケーションまたはユーザーのメタデータ（権限）
* アプリケーションタイプ（SPA）

Auth0 Dashboardは、登録された全リソースを対象に、リアルタイムで一致する検索結果を返します。

## 仕組み

Auth0 Dashboardの[アプリケーション](https://manage.auth0.com/#/applications)セクションにある検索バーは、ガイド付きのフィルターインターフェイスとブール検索を使用しています。この検索バーは、フィルター可能なフィールドを一覧表示するドロップダウンメニューとして機能します。フィールドを選択して値を入力すると、その条件が結果の上部に削除可能なタグとして追加されます。フィルターは最大5つまで同時に組み合わせることができます。

各フィルターを追加するごとに、検索結果はさらに絞り込まれます。結果を指定するには、異なるフィールド間で`AND/OR`のロジックを組み合わせます。フィルターの内容はURLにクエリパラメータとして反映されます。URLをコピーしてチームメンバーと共有したり、ブックマークして後で同じフィルター済みビューを再表示することもできます。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  **ブール検索の例**

  **アプリケーションタイプ**を`Native`または`SPA`でフィルターし、さらに**ファーストパーティクライアント**を`true`に設定すると、結果にはNativeまたはSPAのいずれかのファーストパーティアプリケーションのみが表示されます。通常のWebアプリやサードパーティアプリは除外されます。
</Callout>

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

Auth0 Dashboardの検索は、フィールドタイプに基づいて一致する結果を返します。

* **文字列フィールド**（名前、ID）：部分一致に対応しています。`payments`と入力すると、「Payments-application」、「Corp Payments Service」などが見つかります。単語の順序は関係ありません。特定の語句に一致する結果を除外するには、その語の前に`NOT`、`-`、`No`などを付けます。たとえば、名前フィールドに`NOT test`と入力すると、名前に"test"を含まないすべてのリソースが返されます。ワイルドカード検索には少なくとも3文字が必要で、それ未満を入力すると「3文字以上」というメッセージが表示され、クエリは送信されません。

* **完全一致フィールド**

完全なID値を入力する必要があります。IDの一部を入力しても結果は返されません。ログやサポートチケットなどで特定のクライアントIDがわかっている場合に、このフィールドを使用してください。

* **メタデータフィールド**

メタデータは、キーと値、またはキーのみで検索できます。

* **キーと値**：キーと値を入力すると、そのキーが特定の値と一致するリソースを検索できます。たとえば、キーを`environment`、値を`production` とすると、`app_metadata.environment`が`production`と等しいリソースのみが返されます。値については前方一致がサポートされており、`prod`と入力すると、`production`、`prod-eu`、`prod-us`が一致します。
  * **キーのみ**：キーを入力し、値を指定せずに**Enter**キーを押します。これにより、そのメタデータキーが設定されているすべてのリソースが、その値に関係なく返されます。特定のキーを使用しているリソースをすべて見つけるのに便利です。

ドット表記法を使用して、最大2階層までのネストされたメタデータキーも検索できます。たとえば、キーを`tier.bronze`、値を`true`とすると、`app_metadata.tier.bronze`が`true`と等しいリソースが返されます。

特定のキーと値の組み合わせに一致する結果を除外するには、値の前に`NOT`を付けます。たとえば、キーを`color`、値を`NOT orange`とすると、 `color`が `orange`以外に設定されているすべてのリソースが返されます。キーは完全一致でなければなりません。メタデータでは、Contains（部分一致）やends-with（後方一致）による検索はサポートされていません。値は最大64文字までインデックスされ、それを超える長い値は検索対象外となります。

* **列挙型フィールド**

あらかじめ定義されたリストから、1つ以上のアプリケーションタイプを選択します。同一フィルター内で複数選択した場合はORロジックが適用されます。たとえば、`Native`と`SPA`を選択すると、NativeおよびSPAのすべてのアプリケーションが返されます。

* **ブール型フィールド**

`true`または`false`を選択して、ファーストパーティクライアントを検索します。これを使用して、（同意画面のスキップが認可されている）ファーストパーティアプリケーションとサードパーティアプリケーションを区別できます。

### 検索可能なフィールド

#### アプリケーション

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

### 制限事項

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

## クエリの例

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

これはエラーログやサポートチケットから`client_id`を取得しており、アプリケーションをすばやく特定する必要がある場合に使用します。

1. \*\*[Auth0 Dashboard > アプリケーション > アプリケーション](https://manage.auth0.com/#/applications)\*\*に移動します。
2. 検索バーをクリックし、**クライアントID**を選択します。
3. `client_id`の完全な値を貼り付けます。一致するアプリケーションが直ちに表示されます。

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

アプリケーションに環境ラベル、プラン階層、外部IDなどのカスタムメタデータが保存されている場合、それらの値を使って検索できます。

1. \*\*[Auth0 Dashboard > アプリケーション > アプリケーション](https://manage.auth0.com/#/applications)\*\*に移動します。
2. 検索バーをクリックし、**メタデータ**を選択します。
3. メタデータキー（例：`environment`）を入力します。
4. 値（例：`production`）を入力します。`metadata.environment`が`production` と等しいアプリケーションが結果に表示されます。前方一致で検索する場合は、`prod`のように部分的な値を入力します。

## トラブルシューティング

**結果が見つかりません**

フィルターの値のスペルが正しいことを確認してください。文字列フィールドの場合は、より短い、またはより一般的な用語をお試しください。メタデータフィールドの場合は、正確なキー名であることを確認してください。キーは大文字・小文字を区別し、完全一致である必要があります。メタデータではContains（部分一致）形式の一致はサポートされていないため、前方一致を使用してください。アプリケーションIDなどの完全一致フィールドでは、必ず完全なID値が貼り付けられていることを確認してください。

**結果が古い可能性があります**

検索結果は最終的整合性に基づいているため、直近の数秒の変更が反映されていない場合があります。リソースを最近作成または更新した場合は、数秒待ってから検索を再度お試しください。

**検索がタイムアウトしました**

アクティブなフィルターの数を減らすか、より具体的な検索語を使用してください。問題が解決しない場合は、[Auth0サポート](https://support.auth0.com)にお問い合わせください。