For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 :

  • 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., +14155552671) 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


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.

Mis à jour

Ce contenu vous a-t-il été utile ?