> 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/kr/id-iam/api-scim/api.md).

# 검색 API

### 개요

SCIM 디스커버리 API를 통해 아이덴티티 제공자(IdP)는 이 SCIM 서비스의 기능과 구조를 자동으로 이해할 수 있습니다.

이 엔드포인트는 IdP가 다음을 결정하는 데 도움이 됩니다:

* 지원되는 기능(예: PATCH)
* 사용 가능한 리소스 유형(예: Users)
* 스키마 정의 및 속성

***

### 디스커버리 API가 중요한 이유

디스커버리 API는 다음을 가능하게 합니다 **자동 구성** SCIM 통합의.

가정을 하드코딩하는 대신, IdP는 다음을 할 수 있습니다:

* 지원되는 작업을 동적으로 감지
* 요청 형식 검증
* 구현별 기능에 맞게 조정

***

### 사용 가능한 엔드포인트

GGWP SCIM 구현은 다음 디스커버리 엔드포인트를 지원합니다:

<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 프로비저닝을 중단시킬 수 있습니다