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. Úsalo para verificar que tus valores sean válidos antes de habilitar la sincronización. Para ver instrucciones paso a paso de asignación de atributos específicas de tu proveedor de identidades, consulta:

• 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 Verkada acepta. Los campos marcados como Obligatorio deben estar presentes en cada solicitud de creación de usuario.

Campo	Atributo SCIM	Esquema	Obligatorio	Caracteres permitidos
Dirección de correo electrónico (nombre de usuario)	userName	Núcleo	Sí	Dirección de correo electrónico válida. Máximo 255 caracteres.
Nombre	name.givenName	Núcleo	Sí	Admite letras, números, espacios, & ' - . , ( ) / @. Máximo 100 caracteres.
Apellido	name.familyName	Núcleo	Sí	Admite letras, números, espacios, & ' - . , ( ) / @. Máximo 100 caracteres.
Segundo nombre	name.middleName	Núcleo	No	Máximo 255 caracteres.
Teléfono del trabajo*	phoneNumbers	Núcleo	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	Núcleo	No	Máximo 255 caracteres.
Departamento	department	Empresarial	No	Máximo 255 caracteres.
Nombre de la empresa	organization	Empresarial	No	Máximo 255 caracteres.
ID de empleado	employeeNumber	Empresarial	No	Máximo 255 caracteres.
ID de departamento	costCenter	Empresarial	No	Máximo 255 caracteres.
Estado activo	active	Núcleo	No	Admite true o false

Tipos de esquema

Núcleo: 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 empresarial: urn:ietf:params:scim:schemas:extension:enterprise:2.0:User

La sintaxis del atributo del 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á establecido explícitamente.

---

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

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

Campo	Atributo SCIM	Esquema	Notas
Formato de tarjeta	cardFormat	acceso de Verkada	Debe coincidir con un formato compatible con tu hardware (p. ej., "Standard 26-bit Wiegand", "HID 37-bit", etc.)
Número de tarjeta	cardNumber	acceso de Verkada	Entero; debe ajustarse al rango de bits definido por el formato de la tarjeta
Número de tarjeta (hex)	cardNumberHex	acceso de Verkada	Cadena hexadecimal; debe ajustarse al rango de bits definido por el formato de la tarjeta
Código de instalación	facilityCode	acceso de Verkada	Entero; debe ajustarse al rango de bits definido por el formato de la tarjeta; requerido solo para los formatos que usan uno
Estado de la credencial	credentialStatus	acceso de Verkada	active, deactivated, deleted

---

Resolver errores comunes de aprovisionamiento de usuarios

Mensaje de error	Causa	Solución
"No se puede administrar un usuario con este dominio de correo electrónico"	El dominio de correo electrónico del usuario no está en la lista permitida de tu proveedor de identidades.	Agrega el dominio en Command, en Configuración de la organización > Inicio de sesión y acceso.
"Argumento no válido: el nombre no cumple con las restricciones válidas para el nombre"	El nombre o el apellido contiene un carácter no permitido.	Actualiza el nombre en tu directorio o ajusta la asignación de atributos para eliminar el carácter.
"Argumento no válido: caracteres no válidos en el ID externo, solo se permiten caracteres alfanuméricos, @, -, + y ."	El ID externo contiene un espacio o un símbolo no admitido.	Usa 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.	Acorta el valor o usa un atributo diferente.
"Número de teléfono no válido, demasiado largo"	La cadena del número de teléfono supera los 32 caracteres.	Elimina los caracteres de formato o acorta el valor en tu asignación.
"Operaciones no admitidas en los campos: [...]. Desasigna estos campos en tu IdP para corregir este error."	Tu proveedor de identidades está sincronizando un campo que Verkada no admite.	Elimina los campos enumerados de la asignación de atributos de tu IdP.
"El usuario ya existe: {email}"	Un usuario con este correo electrónico ya está administrado por este proveedor SCIM.	No se necesita ninguna acción.
"El usuario no puede administrarse {email}"	El usuario está administrado por otro proveedor SCIM en la misma organización.	Comprueba si otra integración SCIM está activa.
"Ya existe un usuario con el ID externo {id}"	Otro usuario de tu organización ya tiene este ID externo.	Los ID externos deben ser únicos por organización. Busca valores duplicados en tu directorio.