Configurer Contentful pour l’approvisionnement automatique d’utilisateurs avec l’ID Microsoft Entra

Cet article décrit les étapes que vous devez effectuer dans Contentful et dans Microsoft Entra ID pour configurer le provisionnement automatique des utilisateurs. Une fois configuré, l’ID Microsoft Entra approvisionne et déprovisionne automatiquement les utilisateurs et les groupes vers Contentful à l’aide du service d’approvisionnement Microsoft Entra. Pour plus d’informations sur ce que fait ce service et son fonctionnement, et pour les questions fréquemment posées, consultez Automatiser l’approvisionnement et le déprovisionnement des utilisateurs sur les applications SaaS avec l’ID Microsoft Entra.

Fonctionnalités prises en charge

• Créer des utilisateurs dans Contentful
• Supprimer des utilisateurs dans Contentful lorsqu’ils n’ont plus besoin d’accès
• Conserver les attributs utilisateur synchronisés entre Microsoft Entra ID et Contentful.
• Provisionner des groupes et des appartenances aux groupes dans Contentful
• Authentification unique à Contentful (recommandé)

Conditions préalables

Le scénario décrit dans cet article suppose que vous disposez déjà des conditions préalables suivantes :

• Un locataire Microsoft Entra.
• L’un des rôles suivants : Administrateur d’application, Administrateur d’application cloud ou Propriétaire de l’application.
• Un compte d’organisation Contentful avec un abonnement qui prend en charge l’approvisionnement SCIM (System for Cross-domain Identity Management). Si vous avez des questions concernant l’abonnement de votre organisation, contactez le support technique de Contentful.

Planifier votre déploiement de l’approvisionnement

1. Découvrez comment fonctionne le service d’approvisionnement.
2. Déterminez qui est concerné par le provisionnement.
3. Déterminez les données à mapper entre Microsoft Entra ID et Contentful.

Configurer Contentful pour prendre en charge le provisionnement avec Microsoft Entra ID

1. Dans Contentful, créez un compte d’utilisateur de service . Toutes les autorisations d’approvisionnement pour Azure sont accordées par l’intermédiaire de ce compte. Nous vous recommandons de choisir Propriétaire comme rôle d’organisation pour ce compte.

2. Connectez-vous à Contentful en tant qu’utilisateur de service.

3. Dans le menu de gauche, sélectionnez Paramètres de l’organisation>Outils d’accès>Attribution d’utilisateurs.

   

4. Copiez et enregistrez l’URL SCIM. Vous entrez cette valeur dans le portail Azure, sous l’onglet Approvisionnement de votre application Contentful.

5. Sélectionnez Générer un jeton d’accès personnel.

   

6. Dans la fenêtre modale, entrez un nom pour votre jeton d’accès personnel, puis sélectionnez Générer.

7. L’URL SCIM et le jeton secret sont générés. Copiez et enregistrez ces valeurs. Vous allez entrer ces valeurs sous l’onglet Approvisionnement de votre application Contentful.

   

Si vous avez des questions lors de la configuration du provisionnement dans la console d’administration Contentful, contactez le support contentful.

Ajouter Contentful à partir de la galerie d'applications Microsoft Entra

Pour gérer le provisionnement vers Contentful, ajoutez Contentful à partir de la galerie d’applications Microsoft Entra. Si vous avez déjà configuré Contentful pour l’authentification unique, vous pouvez utiliser la même application. Toutefois, nous vous recommandons de créer une application distincte pour tester l’intégration dans un premier temps. Découvrez comment ajouter une application dans la galerie.

Définir qui est concerné par la configuration

Le service d’approvisionnement Microsoft Entra vous permet d’étendre l’étendue qui est approvisionnée en fonction de l’affectation à l’application, ou en fonction des attributs de l’utilisateur ou du groupe. Si vous choisissez de définir qui est approvisionné à votre application selon l'affectation, vous pouvez utiliser les étapes pour affecter des utilisateurs et des groupes à l'application. Si vous choisissez de définir l’étendue du provisionnement uniquement en fonction des attributs de l’utilisateur ou du groupe, vous pouvez utiliser un filtre d’étendue.

• Commencez petit. Testez avec un petit ensemble d’utilisateurs et de groupes avant de les déployer pour tout le monde. Lorsque l’étendue de l’approvisionnement est définie sur les utilisateurs et les groupes affectés, vous pouvez le contrôler en affectant un ou deux utilisateurs ou groupes à l’application. Lorsque l’étendue est définie sur tous les utilisateurs et groupes, vous pouvez spécifier un filtre d’étendue basé sur des attributs .

• Si vous avez besoin de rôles supplémentaires, vous pouvez mettre à jour le manifeste de l’application pour ajouter de nouveaux rôles.

Configurer l’attribution automatique d’utilisateurs pour Contentful

Cette section vous guide tout au long des étapes de configuration du service de provisionnement Microsoft Entra pour créer, mettre à jour et désactiver des utilisateurs et des groupes dans une application de test, selon les affectations d’utilisateurs ou de groupes dans Microsoft Entra ID.

Configurer le provisionnement automatique des utilisateurs pour Contentful dans Microsoft Entra ID

1. Connectez-vous au Centre d’administration Microsoft Entra en tant qu’administrateur d’application cloud au moins.

2. Accédez à Entra ID>applications d'entreprise.

   

3. Dans la liste des applications, sélectionnez Contentful.

   

4. Sélectionnez l’onglet Approvisionnement .

   

5. Définissez le mode d’approvisionnementsur Automatique.

   

6. Dans la section Informations d’identification de l’administrateur, entrez l’URL de votre espace Contentful et le jeton secret. Pour vous assurer que l’ID Microsoft Entra peut se connecter à Contentful, sélectionnez Tester la connexion. Si la connexion échoue, vérifiez que votre compte Contentful dispose d’autorisations d’administrateur, puis réessayez.

   

7. Dans e-mail de notification, entrez l’adresse e-mail d’une personne ou d’un groupe qui doit recevoir les notifications d’erreur d’approvisionnement, puis cochez la case Envoyer une notification par e-mail lorsqu’une défaillance se produit .

   

8. Sélectionnez Enregistrer.

9. Dans la section Mappages, sélectionnez Synchroniser les utilisateurs Microsoft Entra avec Contentful.

10. Dans la section Mappage d’attributs , passez en revue les attributs utilisateur synchronisés de Microsoft Entra ID vers Contentful. Les attributs sélectionnés en tant que propriétés correspondantes sont utilisés pour faire correspondre les comptes d’utilisateur dans Contentful pour les opérations de mise à jour. Si vous choisissez de modifier l’attribut cible correspondant, vous devez vous assurer que l’API Contentful prend en charge le filtrage des utilisateurs en fonction de cet attribut. Sélectionnez le bouton Enregistrer pour valider les modifications.

    Caractéristique	Type	Supporté pour le filtrage
    nom d’utilisateur	Chaîne	✓
    name.givenName	Chaîne
    name.familyName	Chaîne

11. Dans la section Mappages, sélectionnez Synchroniser les groupes Microsoft Entra avec Contentful.

12. Dans la section Mappages des attributs, passez en revue les attributs de groupe synchronisés entre Microsoft Entra ID et Contentful. Les attributs sélectionnés en tant que propriétés correspondantes sont utilisés pour faire correspondre les groupes dans Contentful pour les opérations de mise à jour. Sélectionnez le bouton Enregistrer pour valider les modifications.

    Caractéristique	Type	Supporté pour le filtrage
    displayName	Chaîne	✓
    membres	Référence

13. Pour configurer des filtres d’étendue, effectuez les étapes décrites dans l’article de filtre d’étendue.

14. Pour activer le service d’approvisionnement Microsoft Entra pour Contentful, dans la section Paramètres , pour l’état d’approvisionnement, sélectionnez Activé.

    Capture d’écran montrant l’état de provisionnement avec bascule activée et désactivée.

15. Pour définir les utilisateurs ou les groupes que vous souhaitez provisionner sur Contentful, dans la section Paramètres , pour étendue, sélectionnez l’option appropriée.

    

16. Lorsque vous êtes prêt à provisionner, sélectionnez Enregistrer.

    

Cette opération démarre le cycle de synchronisation initial de tous les utilisateurs et groupes définis dans l’étendue sous Paramètres. Le cycle initial prend plus de temps que les cycles suivants, qui se produisent environ toutes les 40 minutes tant que le service de provisionnement Microsoft Entra est en cours d’exécution.

Surveiller votre déploiement

Une fois l'attribution configurée, utilisez les ressources suivantes pour surveiller votre déploiement :

1. Utilisez les journaux d’approvisionnement pour déterminer quels utilisateurs sont provisionnés correctement ou sans succès
2. Vérifiez la barre de progression pour voir l’état du cycle d’approvisionnement et à quel point il est proche de l’achèvement.
3. Si la configuration d’approvisionnement semble être dans un état non sain, l’application passe en quarantaine. Pour en savoir plus sur les états de quarantaine, consultez l'article sur le statut de mise en quarantaine des applications.

Contenu connexe

• Découvrez comment passer en revue les journaux et obtenir des rapports sur l’activité d’approvisionnement
• Gérer l’approvisionnement de comptes d’utilisateur pour les applications d’entreprise
• Qu’est-ce que l’accès aux applications et l’authentification unique avec l’ID Microsoft Entra ?