> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Provisionnement SCIM

> Automatisez la gestion du cycle de vie des utilisateurs et des groupes avec SCIM 2.0.

Truthlocks prend en charge SCIM 2.0 pour le provisionnement automatisé des utilisateurs et la gestion des groupes. Connectez votre fournisseur d'identité (Okta, Azure AD, OneLogin, etc.) pour créer, mettre à jour et désactiver automatiquement les utilisateurs dans votre locataire Truthlocks.

> [!NOTE]
>
> Le provisionnement SCIM est disponible avec le plan **Business** et les plans supérieurs.

## Comment ça marche

**1. Générer un jeton SCIM**

Dans la console, allez dans **Paramètres > SCIM** et générez un jeton de porteur.
Ce jeton authentifie les requêtes SCIM de votre IdP.

**2. Configurez votre IdP**

Dans votre fournisseur d'identité, définissez l'URL de base SCIM sur
`https://api.truthlocks.com/scim/v2` et collez le jeton du porteur.

**3. Synchroniser les utilisateurs et les groupes**

Votre IdP transmet les créations, mises à jour et désactivations d'utilisateurs à Truthlocks
automatiquement. Les changements d'appartenance à un groupe mettent à jour les attributions de rôles.

## URL de base SCIM

```text theme={null}
https://api.truthlocks.com/scim/v2
```

Toutes les requêtes SCIM doivent inclure le jeton bearer dans l'en-tête `Authorization` :

```bash theme={null}
curl -X GET https://api.truthlocks.com/scim/v2/Users \
  -H "Authorization: Bearer scim_your_token_here"
```

## Opérations prises en charge

### Utilisateurs

| Opération | Méthode | Chemin | Description |
| - | - | - | - |
| Liste | GET | `/scim/v2/Users` | Lister les utilisateurs avec filtre optionnel |
| Créer | POST | `/scim/v2/Users` | Provisionner un nouvel utilisateur |
| Obtenir | GET | `/scim/v2/Users/{id}` | Récupérer un utilisateur par ID SCIM |
| Remplacer | PUT | `/scim/v2/Users/{id}` | Remplacement complet de l'utilisateur |
| Patch | PATCH | `/scim/v2/Users/{id}` | Mise à jour partielle (par exemple, désactiver) |
| Supprimer | DELETE | `/scim/v2/Users/{id}` | Suspendre l'utilisateur |

### Groupes

| Opération | Méthode | Chemin | Description |
| - | - | - | - |
| Liste | GET | `/scim/v2/Groups` | Lister les groupes |
| Créer | POST | `/scim/v2/Groups` | Créer un mappage de groupe |
| Obtenir | GET | `/scim/v2/Groups/{id}` | Récupérer un groupe par ID SCIM |
| Remplacer | PUT | `/scim/v2/Groups/{id}` | Remplacer le groupe (re-mappe les liaisons de rôle) |
| Patch | PATCH | `/scim/v2/Groups/{id}` | Ajouter ou supprimer des membres |
| Supprimer | DELETE | `/scim/v2/Groups/{id}` | Supprimer le mappage de groupe |

### Découverte

| Méthode | Chemin | Description |
| - | - | - |
| GET | `/scim/v2/ServiceProviderConfig` | Capacités prises en charge |
| GET | `/scim/v2/Schemas` | Schémas de ressources |
| GET | `/scim/v2/ResourceTypes` | Types de ressources disponibles |

## Création d'un utilisateur

```bash theme={null}
curl -X POST https://api.truthlocks.com/scim/v2/Users \
  -H "Authorization: Bearer scim_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
    "userName": "jane@example.com",
    "name": { "givenName": "Jane", "familyName": "Smith" },
    "emails": [{ "value": "jane@example.com", "primary": true }],
    "active": true
  }'
```

## Désactivation d'un utilisateur

Les IdP comme Okta et Azure AD envoient une requête PATCH pour désactiver les utilisateurs :

```bash theme={null}
curl -X PATCH https://api.truthlocks.com/scim/v2/Users/{id} \
  -H "Authorization: Bearer scim_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [{ "op": "replace", "path": "active", "value": false }]
  }'
```

Les utilisateurs désactivés perdent l'accès immédiatement mais leurs données sont conservées.

## Gestion des jetons SCIM

Générer et gérer des jetons via l'API de gestion :

```bash theme={null}
# Generate a new token
curl -X POST https://api.truthlocks.com/v1/scim/tokens \
  -H "Authorization: Bearer <admin_token>" \
  -H "Content-Type: application/json" \
  -d '{ "label": "Okta SCIM" }'

# List tokens
curl -X GET https://api.truthlocks.com/v1/scim/tokens \
  -H "Authorization: Bearer <admin_token>"

# Revoke a token
curl -X DELETE https://api.truthlocks.com/v1/scim/tokens/<token_id> \
  -H "Authorization: Bearer <admin_token>"
```

## Journal d'activité

Toutes les opérations SCIM sont enregistrées dans un journal d'activité. Affichez les événements de provisionnement récents :

```bash theme={null}
curl -X GET https://api.truthlocks.com/v1/scim/activity \
  -H "Authorization: Bearer <admin_token>"
```

Les types d'activité incluent `USER_CREATED`, `USER_DEACTIVATED`, `USER_PATCHED`, `GROUP_CREATED`, `GROUP_UPDATED`, et `GROUP_DELETED`.

## Application des sièges

La création d'utilisateurs respecte la limite de sièges de votre plan. Si la limite est dépassée, le point de terminaison SCIM renvoie HTTP `402` et l'utilisateur n'est pas créé. Mettez à niveau votre plan ou supprimez les utilisateurs inactifs pour libérer des sièges.

## Filtrage

Le paramètre de requête SCIM `filter` permet à votre fournisseur d'identité de restreindre les réponses de liste à des utilisateurs ou groupes spécifiques. Truthlocks prend en charge le filtrage sur des attributs SCIM spécifiques à l'aide des opérateurs ci-dessous.

### Attributs de filtre pris en charge

| Attribut | Ressource | Description |
| - | - | - |
| `userName` | Utilisateurs | L'identifiant de connexion de l'utilisateur (généralement une adresse e-mail) |
| `displayName` | Utilisateurs, Groupes | Le nom d'affichage de l'utilisateur ou du groupe |
| `externalId` | Utilisateurs, Groupes | L'identifiant unique attribué par votre fournisseur d'identité |
| `active` | Utilisateurs | Si le compte utilisateur est actif (`true` / `false`) |

### Opérateurs pris en charge

| Opérateur | Signification | Exemple |
| - | - | - |
| `eq` | Égal à | `userName eq "jane@example.com"` |
| `ne` | Différent de | `active ne false` |
| `co` | Contient | `userName co "example.com"` |
| `sw` | Commence par | `userName sw "jane"` |
| `ew` | Se termine par | `userName ew "@example.com"` |

Combinez les opérateurs en utilisant `and` / `or` pour des requêtes complexes :

```bash theme={null}
# Find active users whose username contains "example.com"
curl -G https://api.truthlocks.com/scim/v2/Users \
  -H "Authorization: Bearer scim_your_token_here" \
  --data-urlencode 'filter=active eq true and userName co "example.com"'

# Find users starting with "jane" or "john"
curl -G https://api.truthlocks.com/scim/v2/Users \
  -H "Authorization: Bearer scim_your_token_here" \
  --data-urlencode 'filter=userName sw "jane" or userName sw "john"'

# Look up a user by their IdP-assigned external ID
curl -G https://api.truthlocks.com/scim/v2/Users \
  -H "Authorization: Bearer scim_your_token_here" \
  --data-urlencode 'filter=externalId eq "00u1a2b3c4d5e6f7g8h9"'

# Find a user by display name
curl -G https://api.truthlocks.com/scim/v2/Users \
  -H "Authorization: Bearer scim_your_token_here" \
  --data-urlencode 'filter=displayName eq "Jane Smith"'
```

> [!NOTE]
>
> Les résultats filtrés sont limités à 200 éléments par réponse. Si votre IdP synchronise plus de 200 utilisateurs ou groupes, il doit paginer en utilisant les paramètres `startIndex` et `count` en plus du filtre.

### Modèles de filtre IdP courants

La plupart des fournisseurs d'identité envoient des filtres automatiquement pendant la synchronisation. Voici les modèles que Truthlocks gère :

| IdP | Filtre typique envoyé |
| - | - |
| Okta | `userName eq "user@example.com"` |
| Azure AD | `userName eq "user@example.com"`, `displayName co "Smith"`, ou `externalId eq "id"` |
| OneLogin | `userName sw "user"` ou `externalId eq "id"` |

Si votre IdP envoie un filtre utilisant l'un des attributs et opérateurs pris en charge listés ci-dessus, Truthlocks le traite correctement. Vous n'avez rien à configurer du côté de Truthlocks.

## Capacités prises en charge

| Capacité | Pris en charge |
| - | - |
| Patch | Oui |
| En vrac | Non |
| Filtre | Oui — `eq`, `ne`, `co`, `sw`, `ew` sur `userName`, `displayName`, `externalId`, `active` avec `and` / `or` (max 200 résultats) |
| Trier | Non |
| Changer le mot de passe | Non |
| ETag | Non |

## Lié

* [SAML SSO](https://docs.truthlocks.com/fr/security/saml-sso.md) — Authentifiez les utilisateurs via votre IdP.
* [RBAC et permissions](https://docs.truthlocks.com/fr/security/rbac.md) — Rôles attribués aux utilisateurs provisionnés.
* [Journaux d'audit](https://docs.truthlocks.com/fr/security/audit.md) — Suivez tous les événements d'accès et de provisionnement.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.