Configurer Playvox pour le provisionnement automatique d'utilisateurs avec Microsoft Entra ID

Cet article décrit les étapes à suivre dans Playvox et Microsoft Entra ID pour configurer l’approvisionnement automatique d’utilisateurs. Une fois configuré, l’ID Microsoft Entra approvisionne et déprovisionne automatiquement les utilisateurs ou les groupes dans Playvox à l’aide du service de provisionnement 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 Playvox.
  • Supprimer des utilisateurs dans Playvox lorsqu’ils n’ont plus besoin d’accès.
  • Conserver les attributs utilisateur synchronisés entre Microsoft Entra ID et Playvox.
  • La prise en charge de l'authentification par jeton de porteur de longue durée.

Conditions préalables

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

Étape 1 : Planifier votre déploiement d’approvisionnement

  1. Découvrez comment fonctionne le service d’approvisionnement.

  2. Déterminez qui est concerné par l'approvisionnement.

  3. Déterminez les données à mapper entre Microsoft Entra ID et Playvox.

Étape 2 : Configurer Playvox pour prendre en charge le provisionnement à l'aide de Microsoft Entra ID

  1. Connectez-vous à la console d’administration Playvox et accédez à Paramètres > Clés API.

  2. Sélectionnez Créer une clé API.

    Capture d’écran montrant l’emplacement du bouton Créer une clé API dans l’interface utilisateur Playvox.

  3. Entrez un nom explicite pour la clé API, puis sélectionnez Enregistrer. Une fois la clé API générée, sélectionnez Fermer.

  4. Sur la clé API que vous avez créée, sélectionnez l’icône Détails .

    Capture d’écran montrant l’emplacement de l’icône Détails, qui est une loupe, dans l’interface utilisateur Playvox.

  5. Copiez et enregistrez la valeur BASE64 KEY . Plus tard, dans le portail Azure, vous entrez cette valeur dans la zone de texte Jeton secret sous l’onglet Approvisionnement de votre application Playvox.

    Capture d'écran de la zone de message clé d'API Détails, avec la valeur BASE64 KEY mise en surbrillance.

Pour commencer à gérer l'approvisionnement vers Playvox, ajoutez Playvox à votre locataire Microsoft Entra à partir de la galerie d'applications. Pour en savoir plus, consultez Démarrage rapide : ajouter une application à votre locataire Microsoft Entra.

Si vous avez déjà configuré Playvox pour l’authentification unique (SSO), vous pouvez utiliser la même application. Toutefois, nous vous recommandons de créer une application distincte lors du test initial de l’intégration.

Étape 4 : Définir qui est concerné par l’approvisionnement

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 limiter la portée des utilisateurs provisionnés à votre application en fonction de l'affectation, vous pouvez utiliser les étapes pour affecter des utilisateurs et des groupes à l'application. Si vous choisissez de définir qui est approvisionné 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.

Étape 5 : Configurer l'approvisionnement automatique d'utilisateurs sur Playvox

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 ou des groupes, selon les affectations d'utilisateurs ou de groupes dans Microsoft Entra ID.

Pour configurer le provisionnement automatique d'utilisateurs pour Playvox 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.

    Screenshot du portail Azure avec des applications d’entreprise et tous les éléments d’applications mis en surbrillance.

  3. Dans la liste des applications, recherchez et sélectionnez Playvox.

    Capture d’écran partielle de la liste des applications, avec la zone de recherche d’application mise en surbrillance.

  4. Sélectionnez l’onglet Approvisionnement .

    Capture d’écran partielle montrant l’élément de menu Provisionnement.

  5. Sélectionnez + Nouvelle configuration.

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

  6. Dans le champ URL du locataire , entrez l’URL de votre locataire Playvox et le jeton secret. Sélectionnez Test Connection pour vous assurer que les Microsoft Entra ID peuvent se connecter à Playvox. Si la connexion échoue, vérifiez que votre compte Playvox 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. Sélectionnez le crayon pour modifier les propriétés. Activez les e-mails de notification et fournissez un e-mail pour recevoir des e-mails de quarantaine. Activer la prévention des suppressions accidentelles. Cliquez sur Appliquer pour enregistrer les modifications.

    Capture d’écran de la page Propriétés d’approvisionnement montrant les paramètres de notification et de suppression.

  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 Playvox dans la section Mappage des attributs . Les attributs sélectionnés en tant que propriétés correspondantes sont utilisés pour faire correspondre les comptes d’utilisateur dans Playvox pour les opérations de mise à jour. Si vous choisissez de modifier l’attribut cible correspondant, vérifiez que l’API Playvox prend en charge le filtrage des utilisateurs en fonction de cet attribut. Sélectionnez Enregistrer pour valider les modifications.

    Caractéristique Type Supporté pour le filtrage
    nom d’utilisateur Chaîne
    active Booléen
    displayName Chaîne
    e-mails[type eq « travail »].value Chaîne
    name.givenName Chaîne
    name.familyName Chaîne
    name.formatted Chaîne
    externalId Chaîne
  12. Pour configurer des filtres d’étendue, reportez-vous aux instructions suivantes fournies dans l’article intitulé "Filtre d’étendue".

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

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

Étape 6 : Surveiller votre déploiement

Une fois le provisionnement configuré, 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.

Ressources supplémentaires