> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/command/fr/securite/identity-providers/user-provisioning-field-requirements-and-formatting-rules.md).

# 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](/command/fr/securite/identity-providers/okta.md#user-provisioning)
* [Microsoft Entra ID](/command/fr/securite/identity-providers/microsoft-entra-id.md#user-provisioning)
* [Google Workspace](/command/fr/securite/identity-providers/google-workspace.md#user-provisioning) — 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 <a href="#field-requirements" id="field-requirements"></a>

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.

<table><thead><tr><th width="169.14453125">Champ</th><th width="174.45703125">Attribut SCIM</th><th>Schéma</th><th width="114.83984375">Requis</th><th>Caractères autorisés</th></tr></thead><tbody><tr><td>Adresse e-mail (nom d’utilisateur)</td><td><code>userName</code></td><td>Noyau</td><td>Oui</td><td>Adresse e-mail valide. 255 caractères maximum.</td></tr><tr><td>Prénom</td><td><code>name.givenName</code></td><td>Noyau</td><td>Oui</td><td>Prend en charge les lettres, les chiffres, les espaces, <code>&#x26;</code> <code>'</code> <code>-</code> <code>.</code> <code>,</code> <code>(</code> <code>)</code> <code>/</code> <code>@</code>. 100 caractères maximum.</td></tr><tr><td>Nom de famille</td><td><code>name.familyName</code></td><td>Noyau</td><td>Oui</td><td>Prend en charge les lettres, les chiffres, les espaces, <code>&#x26;</code> <code>'</code> <code>-</code> <code>.</code> <code>,</code> <code>(</code> <code>)</code> <code>/</code> <code>@</code>. 100 caractères maximum.</td></tr><tr><td>Deuxième prénom</td><td><code>name.middleName</code></td><td>Noyau</td><td>Non</td><td>255 caractères maximum.</td></tr><tr><td>Téléphone professionnel*</td><td><code>phoneNumbers</code></td><td>Noyau</td><td>Non</td><td>Le format E.164 avec un indicatif de pays (par ex., +14155552671) est requis pour une vérification fiable. 32 caractères maximum.</td></tr><tr><td>ID externe</td><td><code>externalId</code></td><td>Verkada</td><td>Non</td><td>Prend en charge les lettres, les chiffres, <code>_</code> <code>@</code> <code>-</code> <code>.</code> <code>+</code>. 128 caractères maximum.</td></tr><tr><td>Intitulé du poste</td><td><code>title</code></td><td>Noyau</td><td>Non</td><td>255 caractères maximum.</td></tr><tr><td>Département</td><td><code>department</code></td><td>Entreprise</td><td>Non</td><td>255 caractères maximum.</td></tr><tr><td>Nom de l’entreprise</td><td><code>organization</code></td><td>Entreprise</td><td>Non</td><td>255 caractères maximum.</td></tr><tr><td>ID employé</td><td><code>employeeNumber</code></td><td>Entreprise</td><td>Non</td><td>255 caractères maximum.</td></tr><tr><td>ID du département</td><td><code>costCenter</code></td><td>Entreprise</td><td>Non</td><td>255 caractères maximum.</td></tr><tr><td>État d’activation</td><td><code>active</code></td><td>Noyau</td><td>Non</td><td>Prend en charge <code>true</code> ou <code>false</code></td></tr></tbody></table>

#### 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`

{% hint style="warning" %}
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.
{% endhint %}

***

## Identifiants de carte d’accès (extension Verkada Access) <a href="#access-card-credentials-verkada-access-extension" id="access-card-credentials-verkada-access-extension"></a>

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. |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.verkada.com/command/fr/securite/identity-providers/user-provisioning-field-requirements-and-formatting-rules.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.