# Synchronisation avec l’annuaire (SCIM)

> Relier l’annuaire de votre organisation à Moon AI par SCIM 2.0 pour que les arrivées, les départs et les groupes suivent sans intervention dans la console.

Avec SCIM 2.0, votre annuaire crée les comptes des personnes qui arrivent, suspend celles qui partent et tient les groupes à jour. Tout annuaire qui envoie ses comptes en SCIM 2.0 convient, par exemple Microsoft Entra ID.

## Avant de commencer

- L’organisation doit être une organisation gérée, avec au moins un [domaine vérifié](https://realmoon.ai/documentation/organisations/sso/#domaines) : l’annuaire ne crée que des comptes dont l’adresse est dans un domaine vérifié.
- L’annuaire ne crée pas de membres dans un workspace payé par carte : chaque membre ajouterait un siège facturé. Dans ce cas, invitez les personnes. Une organisation sous contrat n’a pas cette limite.
- Le jeton se crée avec la permission « Gérer la sécurité » (propriétaire, administrateurs).

## Relier l’annuaire

1. Administration › « Connexion » › carte « Synchronisation avec l’annuaire (SCIM) » › « Créer un jeton ».
2. Copiez le jeton tout de suite : il commence par `moai_scim_` et ne sera plus affiché.
3. Dans votre annuaire, créez une application SCIM 2.0 et donnez-lui : - l’« Adresse du service SCIM » affichée par Moon AI : `https://chat.realmoon.ai/api/v1/orgs/scim/v2` ; - le jeton comme « jeton secret » (authentification par jeton porteur).
4. Lancez une première synchronisation depuis l’annuaire.

La carte affiche ensuite la date de création du jeton, qui l’a créé et sa dernière utilisation.

## Ce que fait l’annuaire

| Dans l’annuaire | Dans Moon AI |
| --- | --- |
| Une personne est assignée à l’application | Son compte est créé s’il n’existe pas, ou son compte existant est rattaché, et elle devient membre. Un compte créé ainsi est un compte géré par l’organisation. |
| Une personne est désactivée | Elle est suspendue dans l’organisation et ses sessions sont fermées. Son siège est libéré. |
| Une personne est réactivée | Sa suspension est levée, si c’est l’annuaire qui l’avait suspendue. Une suspension faite dans l’administration reste. |
| Une personne est retirée | Elle quitte l’organisation. Son compte reste, sauf s’il a été créé par l’annuaire et n’a jamais servi : il est alors supprimé. |
| Un groupe est poussé | Il devient un groupe de l’organisation, marqué « Depuis l’annuaire », dont les membres suivent l’annuaire. |

Les groupes créés par l’annuaire ne se modifient que depuis l’annuaire. Ils ne peuvent pas donner le rôle d’administrateur.

## Ce que l’annuaire ne fait pas

- Il ne suspend ni ne retire le propriétaire ou les administrateurs de l’organisation.
- Il ne change pas l’adresse e-mail d’un compte.
- Il ne change le nom que des comptes qu’il a créés ou qui sont dans un domaine vérifié.
- Il ne crée pas de membre quand tous les sièges sont pris : Moon AI répond « Tous les sièges de l’organisation sont occupés. », que votre annuaire affiche dans ses journaux de synchronisation.

## Remplacer ou révoquer le jeton

- « Remplacer le jeton » : le jeton actuel cesse de fonctionner tout de suite. Collez le nouveau dans votre annuaire juste après.
- « Révoquer » : votre annuaire ne peut plus créer, modifier ni retirer de membres. Les membres déjà présents restent.

Une organisation n’a qu’un jeton SCIM à la fois. Le détail des requêtes acceptées est dans [SCIM dans l’API des organisations](https://realmoon.ai/documentation/api-organisations/scim/).

---

Documentation Moon AI › Workspaces et organisations › Annuaire SCIM. Page : https://realmoon.ai/documentation/organisations/scim/. Modifiée le 5 novembre 2026.

© 2026 Stellarr Studio SAS. Tous droits réservés. Moon AI, Moon Blur et Stellarr Studio sont des marques déposées à l’INPI.