> For the complete documentation index, see [llms.txt](https://docs.ggwp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ggwp.com/jp/idoyobiakusesuiam/apidokyumento-scim/jian-chu-api.md).

# 検出API

### 概要

SCIM Discovery API により、ID プロバイダー（IdP）はこの SCIM サービスの機能と構造を自動的に把握できます。

これらのエンドポイントは、IdP が次の内容を把握するのに役立ちます。

* サポートされている機能（例：PATCH）
* 利用可能なリソースタイプ（例：Users）
* スキーマ定義と属性

***

### Discovery API が重要な理由

Discovery API は **自動構成を** SCIM 連携に対して可能にします。

前提をハードコードする代わりに、IdP は次のことができます。

* サポートされている操作を動的に検出する
* リクエスト形式を検証する
* 実装固有の機能に適応する

***

### 利用可能なエンドポイント

GGWP の SCIM 実装は、次の Discovery エンドポイントをサポートしています。

<table><thead><tr><th width="250.5">エンドポイント</th><th>説明</th></tr></thead><tbody><tr><td><code>/ServiceProviderConfig</code></td><td>サポートされている SCIM 機能を返します</td></tr><tr><td><code>/ResourceTypes</code></td><td>利用可能なリソースタイプを一覧表示します</td></tr><tr><td><code>/Schemas</code></td><td>スキーマ定義を返します</td></tr></tbody></table>

### 共通の特性

* すべてのエンドポイントは `GET` メソッドを使用します
* レスポンスは SCIM 標準形式に従います
* 認証が必要です
* レスポンスには `schemas` 属性が含まれます

### 注意事項

* これらのエンドポイントは通常、 **初期の連携セットアップ時に呼び出されます**
* また、検証のために定期的に使用されることもあります
* 不正なレスポンスは IdP のプロビジョニングを壊す可能性があります