Application Contentful
Contentful est une plateforme de gestion de contenu headless. MIA s'y connecte pour inventorier les membres d'une organisation, les inviter avec un rôle et révoquer leurs accès.
Type d'authentification et prérequis
Type d'authentification — Jeton d'accès personnel (Bearer)
Prérequis
- Disposer d'une organisation Contentful Enterprise sur un plan tarifaire actuel, avec la User Management API activée.
- Être propriétaire ou administrateur de l'organisation pour inviter ou supprimer des membres.
- Disposer d'un jeton d'accès personnel Contentful.
Créer un jeton d'accès personnel
- Connectez-vous à Contentful.
- Ouvrez Settings → CMA tokens depuis un espace de l'organisation.
- Cliquez sur Create personal access token, donnez-lui un nom puis générez-le.
- Dans la liste des jetons, vérifiez que son statut est Active. Si le bouton Authorize apparaît, cliquez dessus et autorisez explicitement le jeton sur l'organisation à connecter. Un jeton actif mais non autorisé ne peut pas accéder à cette organisation.
- Copiez immédiatement le jeton : Contentful ne l'affichera plus ensuite.
Sécurité
Le jeton hérite des droits du compte Contentful qui l'a créé. Utilisez un compte administrateur dédié, conservez le jeton comme un secret et révoquez-le s'il est compromis.
Connecter Contentful à MIA
- Dans MIA, ouvrez Applications → Ajouter une application.
- Sélectionnez Contentful.
- Renseignez le jeton administrateur puis validez.
- MIA récupère les organisations accessibles avec le jeton : sélectionnez celle à connecter.
- MIA importe les membres actifs de l'organisation choisie.
Dépannage
OrganizationAccessGrantRequired: le jeton est valide, mais il n'est pas autorisé sur l'organisation. Dans Settings → CMA tokens, cliquez sur Authorize en face du jeton.FeatureNotEnabled/'user_management_api' feature is not enabled: la User Management API n'est pas activée pour cette organisation. Cette API est réservée aux organisations Enterprise sur les plans tarifaires actuels ; contactez votre interlocuteur Contentful ou le support Contentful pour faire vérifier le contrat et l'activation de la fonctionnalité. MIA ne peut pas contourner cette restriction.
Fonctionnement des accès
- Lors d'un ajout, choisissez le rôle Contentful : membre, développeur, administrateur ou propriétaire. Contentful envoie une invitation par e-mail.
- Une suppression dans MIA révoque l'accès à l'organisation sans supprimer le compte Contentful personnel.
- Contentful interdit la suppression du dernier propriétaire de l'organisation.
- Les invitations Contentful sont encore exposées par un endpoint alpha ; leur comportement peut évoluer.
Pour les détails techniques, consultez la documentation officielle de la User Management API et la documentation des jetons d'accès personnels.