Exigences de champs et règles de mise en forme pour le provisionnement des utilisateurs

Cet article décrit les exigences de mise en forme 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 détaillées de mappage des attributs spécifiques à 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 de famille, département, ID du 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 Requis doivent figurer dans chaque demande de création d’utilisateur.

Champ	Attribut SCIM	Schéma	Requis	Caractères autorisés
Adresse e-mail (nom d’utilisateur)	userName	Noyau	Oui	Adresse e-mail valide. 255 caractères maximum.
Prénom	name.givenName	Noyau	Oui	Prend en charge les lettres, les chiffres, les espaces, & ' - . , ( ) / @. 100 caractères maximum.
Nom de famille	name.familyName	Noyau	Oui	Prend en charge les lettres, les chiffres, les espaces, & ' - . , ( ) / @. 100 caractères maximum.
Deuxième prénom	name.middleName	Noyau	Non	255 caractères maximum.
Téléphone professionnel*	phoneNumbers	Noyau	Non	Le format E.164 avec un indicatif de pays (par 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	Noyau	Non	255 caractères maximum.
Département	department	Entreprise	Non	255 caractères maximum.
Nom de l’entreprise	organization	Entreprise	Non	255 caractères maximum.
ID employé	employeeNumber	Entreprise	Non	255 caractères maximum.
ID du département	costCenter	Entreprise	Non	255 caractères maximum.
État d’activation	active	Noyau	Non	Prend en charge true ou false

Types de schéma

Noyau : 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 de 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é principal: 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 (par 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 (hex)	cardNumberHex	accès Verkada	Chaîne hexadécimale ; doit tenir dans la plage de bits définie par le format de carte
Code d’installation	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
État des identifiants	credentialStatus	accès Verkada	active, deactivated, deleted

---

Résoudre les erreurs courantes de provisionnement des utilisateurs

Message d’erreur	Cause	Correction
"L’utilisateur avec ce domaine de messagerie ne peut pas être géré"	Le domaine de messagerie 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 non valide : le nom ne respecte pas les contraintes de nom valides"	Le prénom ou le nom contient un caractère non autorisé.	Mettez à jour le nom dans votre annuaire, ou ajustez le mappage de vos attributs pour supprimer le caractère.
"Argument non valide : caractères non valides dans l’ID externe, seuls les caractères alphanumériques, @, -, + et . sont autorisés"	L’ID externe contient un espace ou un symbole non pris en charge.	Utilisez uniquement des lettres, des chiffres, _ @ - . +.
"Argument non valide : 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 mise en forme 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 listés du mappage des 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 s’il existe des valeurs en double dans votre annuaire.