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 :

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.

    Capture d’écran du menu Paramètres de l’organisation dans Contentful, avec l’approvisionnement d’utilisateurs mis en surbrillance sous Access Tools.

  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.

    Capture d’écran montrant l’URL SCIM pour 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.

    Capture d’écran du volet Jeton d’accès personnel, avec C F P A T et le nom de l’espace réservé pour le jeton mis en surbrillance.

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

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.

    Capture d’écran montrant le menu Applications d’entreprise dans le portail Azure, avec toutes les applications mises en surbrillance.

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

    Capture d’écran montrant les 20 premiers résultats retournés dans la liste Applications.

  4. Sélectionnez l’onglet Approvisionnement .

    Capture d’écran de l’onglet Approvisionnement mis en surbrillance dans la section Gérer du menu de gauche.

  5. Sélectionnez + Nouvelle configuration.

    Capture d’écran de l’onglet Approvisionnement automatique.

  6. Dans le champ URL du locataire, entrez l’URL du locataire Contentful et le Jeton secret. Sélectionnez Test Connection pour vous assurer que les Microsoft Entra ID peuvent se connecter à Contentful. Si la connexion échoue, vérifiez que votre compte Contentful dispose des autorisations d’administrateur requises et réessayez.

    Capture d’écran de la connexion de test de provisioning.

  7. Sélectionnez Créer pour créer votre configuration.

  8. Sélectionnez Propriétés dans la page Vue d’ensemble .

  9. Dans le champ E-mail de notification, entrez l’adresse e-mail de la personne qui doit recevoir les notifications d’erreur de provisionnement et sélectionnez la case à cocher Envoyer une notification par e-mail en cas de défaillance.

    Capture d’écran des propriétés d’approvisionnement.

  10. Sélectionnez Mappage d’attributs dans le volet gauche et sélectionnez utilisateurs.

  11. Passez en revue les attributs utilisateur qui sont synchronisés entre Microsoft Entra ID et Contentful dans la section Attribute-Mapping. 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
  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, reportez-vous aux instructions fournies dans l’article de filtre d’étendue.

  14. Utilisez l’approvisionnement à la demande pour valider la synchronisation avec un petit nombre d’utilisateurs avant de déployer plus largement dans votre organisation.

  15. Lorsque vous êtes prêt à provisionner, sélectionnez Démarrer l’approvisionnement dans la page Vue d’ensemble .

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.