Partager via

Tutoriel : Configurer Bonusly pour l’attribution automatique d’utilisateurs

  • Article

L'objectif de ce tutoriel est de démontrer les étapes à effectuer dans Bonusly et Microsoft Entra ID pour configurer Microsoft Entra ID afin d’approvisionner et de désapprovisionner automatiquement les utilisateurs et/ou les groupes sur Bonusly.

Remarque

Ce didacticiel décrit un connecteur construit sur le service de provisionnement des utilisateurs Microsoft Entra. Pour découvrir les informations importantes sur ce que fait ce service, comment il fonctionne et consulter le forum aux questions, reportez-vous à l’article Automatiser l’approvisionnement et le désapprovisionnement d’utilisateurs dans les applications SaaS avec Microsoft Entra ID.

Prérequis

Le scénario décrit dans ce didacticiel part du principe que vous disposez des éléments suivants :

  • Un locataire Microsoft Entra
  • Un locataire Bonusly
  • Un compte d’utilisateur Bonusly avec des autorisations d’administrateur

Remarque

L’intégration de l’approvisionnement Microsoft Entra repose sur l’API REST Bonusly, qui est disponible pour les développeurs Bonusly.

Avant de configurer Bonusly pour l’attribution automatique d’utilisateurs avec Microsoft Entra ID, vous devez ajouter Bonusly à partir de la galerie d’applications Microsoft Entra à votre liste d’applications SaaS managées.

Pour ajouter Bonusly à partir de la galerie d'applications Microsoft Entra, effectuez les étapes suivantes :

  1. Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.

  2. Accédez à Identité>Applications>Applications d’entreprise>Nouvelle application.

  3. Dans la zone de recherche, tapez Bonusly, sélectionnez Bonusly dans le volet de résultats, puis cliquez sur le bouton Ajouter pour ajouter l’application.

    Bonusly in the results list

Attribution d’utilisateurs à Bonusly

Microsoft Entra ID utilise un concept appelé « affectations » pour déterminer les utilisateurs devant recevoir l’accès aux applications sélectionnées. Dans le cadre de l’approvisionnement automatique des utilisateurs, seuls les utilisateurs et/ou groupes qui ont été attribués à une application dans Microsoft Entra ID sont synchronisés.

Avant de configurer et d'activer l’approvisionnement automatique des utilisateurs, vous devez décider quels utilisateurs et/ou groupes dans Microsoft Entra ID ont besoin d'accéder à Bonusly. Une fois que vous avez choisi, vous pouvez attribuer ces utilisateurs et/ou groupes à votre application Bonusly en suivant les instructions fournies ici :

Conseils importants pour l’attribution d’utilisateurs dans Bonusly

  • Il est recommandé qu'un seul utilisateur Microsoft Entra soit attribué à Bonusly pour tester la configuration d’approvisionnement automatique des utilisateurs. Les autres utilisateurs et/ou groupes peuvent être affectés ultérieurement.

  • Quand vous attribuez un utilisateur à Bonusly, vous devez sélectionner un rôle valide propre à l’application (si disponible) dans la boîte de dialogue d’attribution. Les utilisateurs dont le rôle est Accès par défaut sont exclus de l’approvisionnement.

Configuration de l’attribution automatique d’utilisateurs dans Bonusly

Cette section vous guide à travers les étapes de configuration du service d’approvisionnement Microsoft Entra pour créer, mettre à jour et désactiver des utilisateurs et/ou des groupes dans Bonusly en fonction des attributions d'utilisateurs et/ou de groupes dans Microsoft Entra ID.

Conseil

Vous pouvez également choisir d’activer l’authentification unique basée sur SAML pour Bonusly en suivant les instructions fournies dans le tutoriel sur l’authentification unique Bonusly. L’authentification unique peut être configurée indépendamment de l’attribution automatique d’utilisateurs, bien que ces deux fonctionnalités se complètent.

Pour configurer l’approvisionnement automatique d’utilisateurs pour Bonusly dans Microsoft Entra ID :

  1. Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.

  2. Accédez à Identité>Applications>Applications d’entreprise>Bonusly.

    Enterprise applications blade

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

    The Bonusly link in the Applications list

  4. Sélectionnez l’onglet Approvisionnement.

    Screenshot of the Bonusly - Provisioning tab. Under Manage, Provisioning is highlighted.

  5. Définissez le Mode d’approvisionnement sur Automatique.

    Screenshot showing a Provisioning Mode list box, with Automatic selected and highlighted.

  6. Sous la section Informations d’identification de l’administrateur, entrez le jeton secret de votre compte Bonusly, comme expliqué à l’étape 6.

    Screenshot of the Admin credentials section. The Secret token box is empty, but the box is highlighted.

  7. Le jeton secret de votre compte Bonusly se trouve dans Admin (Administrateur) > Company (Entreprise) > Integrations (Intégrations). Dans la section If you want to code (Si vous souhaitez programmer), cliquez sur API > Create New API Access Token (Créer un jeton d’accès d’API) pour créer un jeton secret.

    Screenshot of the Bonusly menu. Under Admin, Company is highlighted. Under Company, Integrations is highlighted.

    Screenshot of the If you want to code section of the Bonusly site, with A P I highlighted.

    Screenshot of the Bonusly site. The Services tab is open. Under Your A P I access tokens, Create new A P I access token is highlighted.

  8. Dans l’écran suivant, tapez un nom pour le jeton d’accès dans la zone de texte fournie, puis appuyez sur Create Api Key (Créer la clé d’API). Le nouveau jeton d’accès s’affiche pendant quelques secondes dans une fenêtre contextuelle.

    Screenshot of the New access token page of the Bonusly site. An unlabeled box contains My Token, and the Create A P I key button is highlighted.

    Screenshot of the Bonusly site. A notification is visible that displays New access token created, followed by an indecipherable token.

  9. Après avoir renseigné les champs indiqués à l’étape 5, cliquez sur Tester la connexion pour vérifier que Microsoft Entra ID peut se connecter à Bonusly. Si la connexion échoue, vérifiez que votre compte Bonusly dispose des autorisations d’administrateur, puis réessayez.

    Screenshot of the Admin Credentials section. The Text connection button is highlighted.

  10. Dans le champ 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 en cas de défaillance.

    Screenshot showing an empty Notification email box. An option is visible that is labeled Send an email notification when a failure occurs.

  11. Cliquez sur Enregistrer.

  12. Dans la section Mappages, sélectionnez Synchroniser les utilisateurs Microsoft Entra avec Bonusly.

    Screenshot of the Mappings section. Under Name, Synchronize Microsoft Entra users to Bonusly is highlighted.

  13. Passez en revue les attributs utilisateur synchronisés de Microsoft Entra ID vers Bonusly dans la section Mappage d'attributs. Les attributs sélectionnés en tant que propriétés de Correspondance sont utilisés pour établir une correspondance avec les comptes d’utilisateur Bonusly en vue de mises à jour ultérieures. Cliquez sur le bouton Enregistrer pour valider les modifications.

    Screenshot of the Attribute Mappings page. A table lists Microsoft Entra attributes, corresponding Bonusly attributes, and the matching status.

  14. Pour configurer des filtres d’étendue, reportez-vous aux instructions suivantes fournies dans Approvisionnement d’applications basé sur les attributs avec filtres d’étendue.

  15. Pour activer le service d’approvisionnement Microsoft Entra pour Bonusly, modifiez l'état d’approvisionnement sur Activé dans la section Paramètres.

    Screenshot of the Settings section. The Provisioning status toggle is set to Off.

  16. Définissez les utilisateurs et/ou groupes que vous souhaitez attribuer à Bonusly en choisissant les valeurs souhaitées dans Étendue, dans la section Paramètres.

    Screenshot showing the Scope list box. Sync only assigned users and groups is selected in the box.

  17. Lorsque vous êtes prêt à effectuer l’approvisionnement, cliquez sur Enregistrer.

    Screenshot of the Bonusly - Provisioning page, with the Save button highlighted.

Cette opération démarre la synchronisation initiale de tous les utilisateurs et/ou groupes définis dans Étendue dans la section Paramètres. La synchronisation initiale prend plus de temps que les synchronisations suivantes, qui se produisent environ toutes les 40 minutes tant que le service d’approvisionnement Microsoft Entra est en cours d’exécution. Vous pouvez utiliser la section Détails de synchronisation pour superviser la progression et suivre les liens vers le rapport d'activité d’approvisionnement, qui décrit toutes les actions effectuées par le service d’approvisionnement Microsoft Entra sur Bonusly.

Pour plus d’informations sur la façon de lire les journaux d’approvisionnement Microsoft Entra, voir Rapports sur le provisionnement automatique des comptes d’utilisateur.

Ressources supplémentaires

Étapes suivantes