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

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

• Okta
• Microsoft Entra ID
• Google Workspace — 아래 필드의 하위 집합을 지원합니다: 이메일, 이름과 성, 부서, 부서 ID, 직원 ID, 직함, 전화번호

---

필드 요구 사항

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

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

스키마 유형

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

전화 속성 구문은 ID 공급자마다 다릅니다.

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

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

---

액세스 카드 자격 증명(Verkada Access 확장)

조직에서 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는 조직별로 고유해야 합니다. 디렉터리에서 중복 값을 확인하세요.