> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/command/ko/security/identity-providers/user-provisioning-field-requirements-and-formatting-rules.md).

# 사용자 프로비저닝 필드 요구 사항 및 서식 규칙

이 문서는 사용자 프로비저닝을 위해 SCIM 및 기타 통합을 통해 Verkada가 허용하는 각 필드의 형식 요구 사항을 설명합니다. 동기화를 활성화하기 전에 값이 유효한지 확인하는 데 사용하세요. ID 공급자별 단계별 속성 매핑 지침은 다음을 참조하세요:

* [Okta](/command/ko/security/identity-providers/okta.md#user-provisioning)
* [Microsoft Entra ID](/command/ko/security/identity-providers/microsoft-entra-id.md#user-provisioning)
* [Google Workspace](/command/ko/security/identity-providers/google-workspace.md#user-provisioning) — 아래 필드의 하위 집합을 지원합니다: 이메일, 이름과 성, 부서, 부서 ID, 직원 ID, 직함, 전화번호

***

## 필드 요구 사항 <a href="#field-requirements" id="field-requirements"></a>

아래 표에는 Verkada가 허용하는 모든 필드가 포함되어 있습니다. 다음으로 표시된 필드 **필수** 는 모든 사용자 생성 요청에 포함되어 있어야 합니다.

<table><thead><tr><th width="169.14453125">필드</th><th width="174.45703125">SCIM 속성</th><th>스키마</th><th width="114.83984375">필수</th><th>허용되는 문자</th></tr></thead><tbody><tr><td>이메일 주소(사용자 이름)</td><td><code>userName</code></td><td>Core</td><td>예</td><td>유효한 이메일 주소. 최대 255자.</td></tr><tr><td>이름</td><td><code>name.givenName</code></td><td>Core</td><td>예</td><td>문자, 숫자, 공백을 지원합니다, <code>&#x26;</code> <code>'</code> <code>-</code> <code>.</code> <code>,</code> <code>(</code> <code>)</code> <code>/</code> <code>@</code>. 최대 100자.</td></tr><tr><td>성</td><td><code>name.familyName</code></td><td>Core</td><td>예</td><td>문자, 숫자, 공백을 지원합니다, <code>&#x26;</code> <code>'</code> <code>-</code> <code>.</code> <code>,</code> <code>(</code> <code>)</code> <code>/</code> <code>@</code>. 최대 100자.</td></tr><tr><td>중간 이름</td><td><code>name.middleName</code></td><td>Core</td><td>아니요</td><td>최대 255자.</td></tr><tr><td>업무 전화*</td><td><code>phoneNumbers</code></td><td>Core</td><td>아니요</td><td>신뢰할 수 있는 검증을 위해 국가 코드를 포함한 E.164 형식(예: +14155552671)이 필요합니다. 최대 32자.</td></tr><tr><td>외부 ID</td><td><code>externalId</code></td><td>Verkada</td><td>아니요</td><td>문자, 숫자, <code>_</code> <code>@</code> <code>-</code> <code>.</code> <code>+</code>. 최대 128자.</td></tr><tr><td>직함</td><td><code>title</code></td><td>Core</td><td>아니요</td><td>최대 255자.</td></tr><tr><td>부서</td><td><code>department</code></td><td>엔터프라이즈</td><td>아니요</td><td>최대 255자.</td></tr><tr><td>회사명</td><td><code>organization</code></td><td>엔터프라이즈</td><td>아니요</td><td>최대 255자.</td></tr><tr><td>직원 ID</td><td><code>employeeNumber</code></td><td>엔터프라이즈</td><td>아니요</td><td>최대 255자.</td></tr><tr><td>부서 ID</td><td><code>costCenter</code></td><td>엔터프라이즈</td><td>아니요</td><td>최대 255자.</td></tr><tr><td>활성 상태</td><td><code>active</code></td><td>Core</td><td>아니요</td><td>지원함 <code>true</code> 또는 <code>false</code></td></tr></tbody></table>

#### 스키마 유형

**Core:** `urn:ietf:params:scim:schemas:core:2.0:User`

**Verkada 확장:** `urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User`

**엔터프라이즈 확장:** `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`

{% hint style="warning" %}
전화 속성 구문은 ID 공급자마다 다릅니다.

* Okta: `phoneNumbers.^[type==work].value`
* Entra ID: `phoneNumbers[type eq "work"].value`

Verkada는 다음으로 표시된 전화번호도 허용합니다. `primary: true` 를 업무 전화로, 심지어 `type` 가 명시적으로 설정되지 않았더라도.
{% endhint %}

***

## 액세스 카드 자격 증명(Verkada Access 확장) <a href="#access-card-credentials-verkada-access-extension" id="access-card-credentials-verkada-access-extension"></a>

조직에서 Verkada Access를 사용하는 경우, 사용자 지정 **Verkada 액세스 확장:** `urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User`

| 필드          | SCIM 속성            | 스키마         | 참고                                                                         |
| ----------- | ------------------ | ----------- | -------------------------------------------------------------------------- |
| 카드 형식       | `cardFormat`       | Verkada 액세스 | 하드웨어가 지원하는 형식과 일치해야 합니다(예: `"Standard 26-bit Wiegand"`, `"HID 37-bit"`, 등) |
| 카드 번호       | `cardNumber`       | Verkada 액세스 | 정수; 카드 형식에서 정의한 비트 범위 내에 있어야 합니다                                           |
| 카드 번호(16진수) | `cardNumberHex`    | Verkada 액세스 | 16진수 문자열; 카드 형식에서 정의한 비트 범위 내에 있어야 합니다                                     |
| 시설 코드       | `facilityCode`     | Verkada 액세스 | 정수; 카드 형식에서 정의한 비트 범위 내에 있어야 하며, 이를 사용하는 형식에만 필요합니다                        |
| 자격 증명 상태    | `credentialStatus` | Verkada 액세스 | `active`, `비활성화됨`, `삭제됨`                                                   |

***

## 일반적인 사용자 프로비저닝 오류 해결

| 오류 메시지                                                        | 원인                                          | 해결 방법                                          |
| ------------------------------------------------------------- | ------------------------------------------- | ---------------------------------------------- |
| *"이 이메일 도메인을 가진 사용자는 관리할 수 없습니다"*                             | 사용자의 이메일 도메인이 ID 공급자의 허용 목록에 없습니다.          | Command의 조직 설정 > 로그인 및 액세스에서 도메인을 추가하세요.       |
| *"잘못된 인수: 이름이 유효한 이름 제약 조건을 따르지 않습니다"*                        | 이름 또는 성에 허용되지 않는 문자가 포함되어 있습니다.             | 디렉터리에서 이름을 업데이트하거나, 해당 문자를 제거하도록 속성 매핑을 조정하세요. |
| *"잘못된 인수: 외부 ID의 잘못된 문자, 영숫자, @, -, +, 및 .만 허용됨"*             | 외부 ID에 공백 또는 지원되지 않는 기호가 포함되어 있습니다.         | 문자, 숫자, `_` `@` `-` `.` `+`.                   |
| *"잘못된 인수: 외부 ID가 너무 깁니다. 최대 길이는 128자입니다"*                     | 외부 ID가 128자를 초과합니다.                         | 값을 줄이거나 다른 속성을 사용하세요.                          |
| *"유효하지 않은 전화번호, 너무 김"*                                        | 전화번호 문자열이 32자를 초과합니다.                       | 형식 지정 문자를 제거하거나 매핑에서 값을 줄이세요.                  |
| *"필드에서 지원되지 않는 작업: \[...]. 이 오류를 수정하려면 IdP에서 이들의 매핑을 해제하세요."* | ID 공급자가 Verkada가 지원하지 않는 필드를 동기화하고 있습니다.    | ID 공급자의 속성 매핑에서 나열된 필드를 제거하세요.                 |
| *"사용자가 이미 존재함: {email}"*                                      | 이 이메일을 가진 사용자는 이미 이 SCIM 공급자에 의해 관리되고 있습니다. | 별도의 조치는 필요하지 않습니다.                             |
| *"사용자를 관리할 수 없습니다 {email}"*                                   | 같은 조직의 다른 SCIM 공급자가 해당 사용자를 관리하고 있습니다.      | 다른 SCIM 통합이 활성화되어 있는지 확인하세요.                   |
| *"외부 ID {id}를 가진 사용자가 이미 존재합니다"*                              | 조직의 다른 사용자가 이미 이 외부 ID를 가지고 있습니다.           | 외부 ID는 조직별로 고유해야 합니다. 디렉터리에서 중복 값을 확인하세요.      |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.verkada.com/command/ko/security/identity-providers/user-provisioning-field-requirements-and-formatting-rules.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.