Une organisation se pilote aussi par programme. Cinq outils existent, chacun avec sa clé et son adresse. Tous concernent un workspace d’équipe ; un workspace personnel n’en a aucun.
Quel outil pour quel besoinLien vers la section Quel outil pour quel besoin
| Besoin | Outil | Authentification |
|---|---|---|
| Gérer les membres, invitations, groupes, rôles, étiquettes, règles, modèles, licences et ressources ; lire l’utilisation et le journal | API d’administration | Clé d’administration moai_adm_… |
| Être prévenu quand un membre arrive ou part, qu’un lot de licences est plein, que les règles changent ou que le contrat approche de sa fin | Webhooks | Signature HMAC avec un secret whsec_… |
| Créer, suspendre et retirer les comptes depuis votre annuaire, et y tenir les groupes | SCIM 2.0 | Jeton moai_scim_… |
| Connecter les membres avec l’identifiant de votre organisation | Connexion unique | Application OpenID Connect de votre fournisseur d’identité |
| Utiliser le chat de Moon AI au nom d’un workspace | Clés de workspace | Clé moai_org_… |
L’annuaire SCIM n’ajoute que des adresses d’un domaine vérifié, et la connexion unique ne devient obligatoire qu’avec au moins un domaine vérifié. Pour appeler les modèles depuis vos propres programmes, avec un porte-monnaie et une facturation à l’usage, utilisez plutôt l’API développeur.
AdressesLien vers la section Adresses
| Service | Adresse |
|---|---|
| API d’administration et webhooks | https:// |
| Description OpenAPI de l’API d’administration | https:// |
| SCIM 2.0 | https:// |
| Adresse de redirection de la connexion unique | https:// |
| Chat avec une clé de workspace | https:// |
L’identifiant de l’organisation (org_id) figure dans l’administration › « API et clés », carte « Démarrage », dans l’exemple « Premier appel ».
Démarrer avec l’API d’administrationLien vers la section Démarrer avec l’API d’administration
- Créez une clé d’administration avec seulement les droits dont votre programme a besoin.
- Vérifiez-la avec
GET /me. - Appelez les routes du domaine voulu, par exemple lister les membres ou inviter des personnes.
- Abonnez votre serveur aux webhooks pour ne pas interroger l’API en boucle.
Sécurité communeLien vers la section Sécurité commune
- Chaque clé et chaque jeton n’agit que sur son organisation. Une requête vers une autre organisation reçoit la même réponse qu’une ressource inexistante.
- Une clé d’administration n’a jamais plus de droits que la personne qui l’a créée, et cesse de fonctionner quand cette personne quitte l’organisation.
- Les clés, jetons et secrets ne sont affichés qu’une fois, à leur création. Gardez-les comme des mots de passe, côté serveur seulement.
- Chaque action faite par une clé ou par l’annuaire est inscrite au journal d’audit de l’organisation, au nom de la clé ou de l’annuaire.
Dans cette section
API d’administration
- API d’administrationCréer une clé d’administration moai_adm_, l’envoyer, choisir ses portées, et les règles communes de l’API : pagination, erreurs, débit et idempotence.
- Organisation et réglagesLire la vue d’ensemble et la liste « À faire », modifier l’identité et les réglages de l’organisation, la durée de conservation et l’annuaire des membres.
- MembresLister et filtrer les membres, lire une fiche, suspendre, réactiver ou retirer, agir en masse, exporter et importer un fichier CSV avec l’API d’administration.
- Invitations et codes d’accèsInviter des personnes avec leurs groupes, rôles, étiquettes et licence, lire les limites d’invitation, renvoyer ou révoquer, et gérer les codes d’accès.
- Comptes des membres par l’APILire le compte d’un membre, le déconnecter, réinitialiser sa double authentification, le désactiver, gérer son départ et les exigences des comptes par l’API.
- GroupesCréer des groupes statiques ou dynamiques, écrire une règle d’étiquettes, ajouter des membres et nommer des gestionnaires avec l’API d’administration.
- RôlesCréer des rôles avec leurs permissions et les attribuer à des membres, des groupes ou des étiquettes par l’API d’administration, avec le catalogue des droits.
- ÉtiquettesCréer des étiquettes clé et valeur, les poser sur des membres, des groupes ou des ressources, et marquer une ressource sensible par l’API d’administration.
- RèglesLe format des règles de l’organisation, des rôles, des groupes et des exceptions, la façon dont elles se combinent, et les routes qui les lisent et écrivent.
- Modèles de l’organisationLister les modèles que les règles autorisent, créer des modèles de l’organisation avec prompt et bases de connaissances, et poser des consignes par modèle.
- Licences et contratLire les lots de licences, régler les règles d’attribution et le lot de repli, attribuer des licences à la main, et lire le contrat et les factures par l’API.
- RessourcesAjouter, tester et partager les serveurs MCP de l’organisation, configurer son stockage de fichiers et partager bases de connaissances et agents par l’API.
- DomainesAjouter et vérifier les domaines de l’organisation par un enregistrement DNS TXT, régler le rattachement automatique et inviter les comptes existants par l’API.
- Utilisation et journal d’audit par l’APILire l’utilisation par membre, par groupe et par modèle, l’exporter en CSV, puis lire, filtrer et exporter le journal d’audit de l’organisation par l’API.
- Webhooks de l’organisationRecevoir les événements de l’organisation dans une requête signée, vérifier la signature, gérer les nouveaux essais et piloter les webhooks par l’API.
Annuaire et connexion
- SCIM 2.0Le service SCIM 2.0 d’une organisation gérée : jeton de l’annuaire, ressources Users et Groups, filtres, opérations PATCH, limites et erreurs au format SCIM.
- Connexion unique (OpenID Connect)Ce que Moon AI attend de votre fournisseur OpenID Connect, le déroulé d’une connexion, les champs lus et les routes qui lisent ou enregistrent la configuration.