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 dans la liste des résultats

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.

    Panneau Applications d’entreprise

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

    Lien Bonusly dans la liste des applications

  4. Sélectionnez l’onglet Approvisionnement.

    Capture d’écran de Bonusly - onglet Approvisionnement. Sous Gérer, Approvisionnement est mis en surbrillance.

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

    Capture d’écran montrant une zone de liste du mode d’approvisionnement, avec Automatique sélectionné et mis en surbrillance.

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

    Capture d’écran de la section Informations d’identification de l’administrateur. La zone Jeton secret est vide, mais la zone est mise en surbrillance.

  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.

    Capture d’écran du menu Bonusly. Sous Admin, Company (Société) est mis en surbrillance. Sous Company (Société), Integrations (Intégrations) est mis en surbrillance.

    Capture d’écran de la section If you want to code (Si vous souhaitez programmer) du site Bonusly, avec API mis en surbrillance.

    Capture d’écran du site Bonusly. L’onglet Services est ouvert. Sous Your API access tokens (Vos jetons d’accès d’API), Create new API access token (Créer un jeton d’accès d’API) est mis en surbrillance.

  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.

    Capture d’écran de la page New access token (Nouveau jeton d’accès) du site Bonusly. Une zone sans étiquette contient My Token (Mon jeton), et le bouton Create API key (Créer une clé d’API) est mis en surbrillance.

    Capture d’écran du site Bonusly. Une notification indiquant qu’un nouveau jeton d’accès est créé s’affiche, suivi d’un jeton indéchiffrable.

  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.

    Capture d’écran de la section Informations d’identification de l’administrateur. Le bouton de connexion texte est en surbrillance.

  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.

    Capture d’écran montrant une boîte de messagerie de notification vide. Une option intitulée Envoyer une notification par e-mail en cas de défaillance s’affiche lorsqu’une défaillance se produit.

  11. Cliquez sur Enregistrer.

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

  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.

    Capture d’écran de la page Mappage d’attributs. Un tableau répertorie les attributs Microsoft Entra, les attributs Bonusly correspondants et l’état de la correspondance.

  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.

    Capture d’écran de la page Paramètres. Le bouton bascule État de la configuration est défini sur Désactivé.

  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.

    Capture d’écran montrant la zone de liste Étendue. Synchroniser uniquement les utilisateurs et groupes assignés est sélectionné dans la zone.

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

    Capture d’écran de Enregistrement de la configuration du provisionnement.

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