Requisitos de campos y reglas de formato para el aprovisionamiento de usuarios

Este artículo describe los requisitos de formato para cada campo que Verkada acepta a través de SCIM y otras integraciones para el aprovisionamiento de usuarios. Úselo para verificar que sus valores sean válidos antes de habilitar la sincronización. Para obtener instrucciones paso a paso sobre la asignación de atributos específicas de su proveedor de identidades, consulte:

• Okta
• Microsoft Entra ID
• Google Workspace — admite un subconjunto de los campos siguientes: correo electrónico, nombre y apellido, departamento, ID de departamento, ID de empleado, cargo del empleado y número de teléfono

---

Requisitos de los campos

La tabla a continuación cubre todos los campos que acepta Verkada. Los campos marcados Required deben estar presentes en cada solicitud de creación de usuario.

Campo	Atributo SCIM	Esquema	Required	Caracteres permitidos
Dirección de correo electrónico (nombre de usuario)	userName	Core	Sí	Dirección de correo electrónico válida. Máximo 255 caracteres.
Nombre	name.givenName	Core	Sí	Admite letras, números, espacios, & ' - . , ( ) /. Máximo 100 caracteres.
Apellido	name.familyName	Core	Sí	Admite letras, números, espacios, & ' - . , ( ) /. Máximo 100 caracteres.
Segundo nombre	name.middleName	Core	No	Máximo 255 caracteres.
Teléfono del trabajo*	phoneNumbers	Core	No	Se requiere el formato E.164 con un código de país (p. ej., [phone]) para una verificación fiable. Máximo 32 caracteres.
ID externo	externalId	Verkada	No	Admite letras, números, _ @ - . +. Máximo 128 caracteres.
Cargo del empleado	title	Core	No	Máximo 255 caracteres.
Departamento	department	Enterprise	No	Máximo 255 caracteres.
Nombre de la empresa	organization	Enterprise	No	Máximo 255 caracteres.
ID de empleado	employeeNumber	Enterprise	No	Máximo 255 caracteres.
ID de departamento	costCenter	Enterprise	No	Máximo 255 caracteres.
Estado activo	active	Core	No	Admite true o false

Tipos de esquema

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

Extensión de Verkada: urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User

Extensión Enterprise: urn:ietf:params:scim:schemas:extension:enterprise:2.0:User

La sintaxis del atributo de teléfono difiere según el proveedor de identidades.

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

Verkada también acepta un número de teléfono marcado primary: true como teléfono del trabajo, incluso si el type no está definido explícitamente.

---

Credenciales de tarjeta de acceso (extensión de Verkada Access)

Si su organización usa Verkada Access, puede aprovisionar credenciales de tarjeta de acceso mediante SCIM usando la extensión personalizada extensión de acceso de Verkada: urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User

Campo	Atributo SCIM	Esquema	Notas
Formato de tarjeta	cardFormat	Verkada Access	Debe coincidir con un formato compatible con su hardware (p. ej., "Wiegand estándar de 26 bits", "HID de 37 bits", etc.)
Número de tarjeta	cardNumber	Verkada Access	Entero; debe caber dentro del rango de bits definido por el formato de tarjeta
Número de tarjeta (hexadecimal)	cardNumberHex	Verkada Access	Cadena hexadecimal; debe caber dentro del rango de bits definido por el formato de tarjeta
Código de instalación	facilityCode	Verkada Access	Entero; debe caber dentro del rango de bits definido por el formato de tarjeta; solo se requiere para los formatos que lo usan
Estado de la credencial	credentialStatus	Verkada Access	active, desactivada, eliminada

---

Resolver errores comunes de aprovisionamiento de usuarios

Mensaje de error	Causa	Solución
"El usuario con este dominio de correo electrónico no puede administrarse"	El dominio de correo electrónico del usuario no está en la lista permitida de su proveedor de identidades.	Agregue el dominio en Command, en Configuración de la organización > Inicio de sesión y acceso.
"Argumento no válido: el nombre no se ajusta a las restricciones válidas de nombre"	El nombre o apellido contiene un carácter no permitido.	Actualice el nombre en su directorio o ajuste la asignación de atributos para eliminar el carácter.
"Argumento no válido: caracteres no válidos en el ID externo; solo alfanuméricos, @, -, + y ."	El ID externo contiene un espacio o un símbolo no compatible.	Use solo letras, números, _ @ - . +.
"Argumento no válido: el ID externo es demasiado largo; la longitud máxima es de 128 caracteres"	El ID externo supera los 128 caracteres.	Acorte el valor o use otro atributo.
"Número de teléfono no válido, demasiado largo"	La cadena del número de teléfono supera los 32 caracteres.	Elimine los caracteres de formato o acorte el valor en su asignación.
"Operaciones no compatibles en los campos: [...]. Desasígnelos en su proveedor de identidades para corregir este error."	Su proveedor de identidades está sincronizando un campo que Verkada no admite.	Elimine los campos enumerados de la asignación de atributos de su proveedor de identidades.
"El usuario ya existe: {email}"	Un usuario con este correo electrónico ya está administrado por este proveedor SCIM.	No se requiere ninguna acción.
"El usuario no puede administrarse {email}"	El usuario está administrado por otro proveedor SCIM en la misma organización.	Compruebe si hay otra integración SCIM activa.
"Ya existe un usuario con el ID externo {id}"	Otro usuario de su organización ya tiene este ID externo.	Los ID externos deben ser únicos por organización. Busque valores duplicados en su directorio.