> 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/scim.md).

# SCIM 기본

### 개요

SCIM(도메인 간 ID 관리 시스템)은 ID를 관리하기 위한 표준화된 스키마와 프로토콜을 정의합니다. 각 SCIM 리소스에는 `schemas` 필드가 포함됩니다:

#### 예시

```json
{
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"]
}
```

### 스키마 URN

<table><thead><tr><th width="112">리소스</th><th>URN</th></tr></thead><tbody><tr><td>사용자</td><td><code>urn:ietf:params:scim:schemas:core:2.0:User</code></td></tr><tr><td>PatchOp</td><td><code>urn:ietf:params:scim:api:messages:2.0:PatchOp</code></td></tr><tr><td>오류</td><td><code>urn:ietf:params:scim:api:messages:2.0:Error</code></td></tr></tbody></table>

### 중요 참고 사항

* `schemas` 항상 존재해야 합니다
* 스키마가 유효하지 않거나 누락되면 `400 잘못된 요청`

### 공통 속성

이러한 속성은 SCIM 요청 및 응답에서 자주 사용됩니다:

<table><thead><tr><th width="128">속성</th><th width="113">유형</th><th>설명</th></tr></thead><tbody><tr><td>id</td><td>문자열</td><td>시스템에서 생성한 고유 식별자</td></tr><tr><td>externalId</td><td>문자열</td><td>외부 시스템(IdP)의 ID</td></tr><tr><td>userName</td><td>문자열</td><td>고유 사용자 이름</td></tr></tbody></table>

### 메타 속성

SCIM 응답에는 메타데이터가 포함됩니다:

```json
{
  "meta": {
    "resourceType": "사용자",
    "created": "2025-01-01T00:00:00Z",
    "lastModified": "2025-01-01T00:00:00Z"
  }
}
```

### 오류 형식

모든 오류는 표준 SCIM 형식을 따릅니다:

```json
{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:Error"],
  "status": "400",
  "detail": "잘못된 요청"
}
```

### 오류 코드

<table><thead><tr><th width="112">상태</th><th>의미</th></tr></thead><tbody><tr><td>400</td><td>잘못된 요청</td></tr><tr><td>401</td><td>인증되지 않음</td></tr><tr><td>404</td><td>리소스를 찾을 수 없음</td></tr><tr><td>500</td><td>내부 서버 오류</td></tr></tbody></table>