Exigences relatives aux champs et règles de formatage du provisionnement des utilisateurs

Cet article décrit les exigences de formatage pour chaque champ que Verkada accepte via SCIM et d'autres intégrations pour le provisionnement des utilisateurs. Utilisez-le pour vérifier que vos valeurs sont valides avant d'activer la synchronisation. Pour des instructions de mappage d'attributs étape par étape propres à votre fournisseur d’identité, voir :

• Okta
• Microsoft Entra ID
• Google Workspace — prend en charge un sous-ensemble des champs ci-dessous : e-mail, prénom et nom, département, ID de département, ID employé, intitulé du poste et numéro de téléphone

---

Exigences relatives aux champs

Le tableau ci-dessous couvre tous les champs que Verkada accepte. Les champs marqués Obligatoire doivent être présents dans chaque demande de création d’utilisateur.

Champ	Attribut SCIM	Schéma	Obligatoire	Caractères autorisés
Adresse e-mail (nom d’utilisateur)	userName	Core	Oui	Adresse e-mail valide. 255 caractères maximum.
Prénom	name.givenName	Core	Oui	Prend en charge les lettres, les chiffres, les espaces, & ' - . , ( ) /. 100 caractères maximum.
Nom	name.familyName	Core	Oui	Prend en charge les lettres, les chiffres, les espaces, & ' - . , ( ) /. 100 caractères maximum.
Deuxième prénom	name.middleName	Core	Non	255 caractères maximum.
Téléphone professionnel*	phoneNumbers	Core	Non	Le format E.164 avec un indicatif de pays (p. ex., [phone]) est requis pour une vérification fiable. 32 caractères maximum.
ID externe	externalId	Verkada	Non	Prend en charge les lettres, les chiffres, _ @ - . +. 128 caractères maximum.
Intitulé du poste	title	Core	Non	255 caractères maximum.
Département	department	Enterprise	Non	255 caractères maximum.
Nom de l’entreprise	organization	Enterprise	Non	255 caractères maximum.
ID employé	employeeNumber	Enterprise	Non	255 caractères maximum.
ID de département	costCenter	Enterprise	Non	255 caractères maximum.
Statut actif	active	Core	Non	Prend en charge true ou false

Types de schéma

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

Extension Verkada : urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User

Extension Entreprise : urn:ietf:params:scim:schemas:extension:enterprise:2.0:User

La syntaxe de l’attribut téléphone diffère selon le fournisseur d’identité.

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

Verkada accepte également un numéro de téléphone marqué primary: true comme téléphone professionnel, même si le type n’est pas défini explicitement.

---

Identifiants de carte d’accès (extension Verkada Access)

Si votre organisation utilise Verkada Access, vous pouvez provisionner des identifiants de carte d’accès via SCIM à l’aide de l’extension personnalisée extension d’accès Verkada : urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User

Champ	Attribut SCIM	Schéma	Remarques
Format de carte	cardFormat	Accès Verkada	Doit correspondre à un format pris en charge par votre matériel (p. ex., "Standard 26-bit Wiegand", "HID 37-bit", etc.)
Numéro de carte	cardNumber	Accès Verkada	Entier ; doit tenir dans la plage de bits définie par le format de carte
Numéro de carte (hexadécimal)	cardNumberHex	Accès Verkada	Chaîne hexadécimale ; doit tenir dans la plage de bits définie par le format de carte
Code d’établissement	facilityCode	Accès Verkada	Entier ; doit tenir dans la plage de bits définie par le format de carte ; requis uniquement pour les formats qui en utilisent un
Statut de l’identifiant	credentialStatus	Accès Verkada	active, désactivé, supprimé

---

Résoudre les erreurs courantes de provisionnement des utilisateurs

Message d’erreur	Cause	Correction
"L’utilisateur avec ce domaine e-mail ne peut pas être géré"	Le domaine e-mail de l’utilisateur ne figure pas dans la liste autorisée de votre fournisseur d’identité.	Ajoutez le domaine dans Command, sous Paramètres de l’organisation > Connexion et accès.
"Argument invalide : le nom ne respecte pas les contraintes de nom valides"	Le prénom ou le nom contient un caractère interdit.	Mettez à jour le nom dans votre annuaire, ou ajustez le mappage de vos attributs pour supprimer le caractère.
"Argument invalide : caractères non valides dans l’ID externe ; uniquement alphanumériques, @, -, + et ."	L’ID externe contient un espace ou un symbole non pris en charge.	Utilisez uniquement des lettres, des chiffres, _ @ - . +.
"Argument invalide : l’ID externe est trop long, la longueur maximale est de 128 caractères"	L’ID externe dépasse 128 caractères.	Raccourcissez la valeur ou utilisez un autre attribut.
"Numéro de téléphone invalide, trop long"	La chaîne du numéro de téléphone dépasse 32 caractères.	Supprimez les caractères de formatage ou raccourcissez la valeur dans votre mappage.
"Opérations non prises en charge sur les champs : [...]. Supprimez leur mappage dans votre fournisseur d’identité pour corriger cette erreur."	Votre fournisseur d’identité synchronise un champ que Verkada ne prend pas en charge.	Supprimez les champs indiqués du mappage d’attributs de votre fournisseur d’identité.
"L’utilisateur existe déjà : {email}"	Un utilisateur avec cet e-mail est déjà géré par ce fournisseur SCIM.	Aucune action requise.
"L’utilisateur ne peut pas être géré {email}"	L’utilisateur est géré par un autre fournisseur SCIM dans la même organisation.	Vérifiez si une autre intégration SCIM est active.
"L’utilisateur avec l’ID externe {id} existe déjà"	Un autre utilisateur de votre organisation possède déjà cet ID externe.	Les ID externes doivent être uniques par organisation. Vérifiez les valeurs en double dans votre annuaire.