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

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

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

---

필드 요구 사항

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

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

스키마 유형

코어: 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 Access	하드웨어가 지원하는 형식과 일치해야 합니다(예: "Standard 26-bit Wiegand", "HID 37-bit", 등)
카드 번호	cardNumber	Verkada Access	정수; 카드 형식에서 정의한 비트 범위 내에 들어와야 합니다.
카드 번호(16진수)	cardNumberHex	Verkada Access	16진수 문자열; 카드 형식에서 정의한 비트 범위 내에 들어와야 합니다.
시설 코드	facilityCode	Verkada Access	정수; 카드 형식에서 정의한 비트 범위 내에 들어와야 하며, 이를 사용하는 형식에만 필요합니다.
자격 증명 상태	credentialStatus	Verkada Access	active, 비활성화됨, 삭제됨

---

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

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