사용자 프로비저닝 필드 요구 사항 및 형식 규칙
이 문서는 사용자 프로비저닝을 위해 Verkada가 SCIM 및 기타 통합을 통해 허용하는 각 필드의 서식 요구 사항을 설명합니다. 동기화를 활성화하기 전에 값이 유효한지 확인하는 데 사용하세요. ID 공급자에 맞춘 단계별 속성 매핑 지침은 다음을 참조하세요:
Google Workspace — 아래 필드의 하위 집합을 지원합니다: 이메일, 이름과 성, 부서, 부서 ID, 직원 ID, 직함, 전화번호
필드 요구 사항
아래 표에는 Verkada가 허용하는 모든 필드가 포함되어 있습니다. 다음으로 표시된 필드 필수 는 모든 사용자 생성 요청에 포함되어야 합니다.
이메일 주소(사용자 이름)
userName
코어
예
유효한 이메일 주소. 최대 255자.
이름
name.givenName
코어
예
문자, 숫자, 공백을 지원합니다. & ' - . , ( ) /최대 100자.
성
name.familyName
코어
예
문자, 숫자, 공백을 지원합니다. & ' - . , ( ) /최대 100자.
중간 이름
name.middleName
코어
아니요
최대 255자.
업무용 전화*
phoneNumbers
코어
아니요
안정적인 확인을 위해 국가 코드가 포함된 E.164 형식(예: +14155552671)이 필요합니다. 최대 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].valueEntra 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
카드 형식
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는 조직마다 고유해야 합니다. 디렉터리에서 중복 값을 확인하세요.
마지막 업데이트
도움이 되었나요?

