Delen via

Zelfstudie: Bonusly configureren voor automatische inrichting van gebruikers

  • Artikel

Het doel van deze zelfstudie is om de stappen te laten zien die moeten worden uitgevoerd in Bonusly en Microsoft Entra ID om Microsoft Entra ID te configureren om gebruikers en/of groepen automatisch in te richten en de inrichting van gebruikers en/of groepen ongedaan te maken voor Bonusly.

Notitie

In deze zelfstudie wordt een connector beschreven die is gebouwd op de Microsoft Entra user Provisioning Service. Voor belangrijke informatie over wat deze service doet, hoe deze werkt en veelgestelde vragen, raadpleegt u Automate user provisioning and deprovisioning to SaaS applications with Microsoft Entra ID.

Vereisten

In het scenario dat in deze zelfstudie wordt beschreven, wordt ervan uitgegaan dat u al beschikt over het volgende:

  • Een Microsoft Entra-tenant
  • Een Bonusly-tenant
  • Een gebruikersaccount in Bonusly met beheerdersmachtigingen

Notitie

De integratie van Microsoft Entra-inrichting is afhankelijk van de Bonusly REST API, die beschikbaar is voor Bonusly-ontwikkelaars.

Voordat u Bonusly configureert voor automatische inrichting van gebruikers met Microsoft Entra-id, moet u Bonusly vanuit de Microsoft Entra-toepassingsgalerie toevoegen aan uw lijst met beheerde SaaS-toepassingen.

Voer de volgende stappen uit om Bonusly toe te voegen vanuit de Microsoft Entra-toepassingsgalerie:

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassing Beheer istrator.

  2. Blader naar Bedrijfstoepassingen voor identiteitstoepassingen>>>Nieuwe toepassing.

  3. Typ Bonusly in het zoekvak, selecteer Bonusly in het venster met resultaten en klik op Toevoegen om de toepassing toe te voegen.

    Bonusly in the results list

Gebruikers toewijzen aan Bonusly

Microsoft Entra ID maakt gebruik van een concept met de naam 'toewijzingen' om te bepalen welke gebruikers toegang moeten krijgen tot geselecteerde apps. In de context van automatische inrichting van gebruikers worden alleen de gebruikers en/of groepen gesynchroniseerd die aan een toepassing in Microsoft Entra-id zijn toegewezen.

Voordat u automatische inrichting van gebruikers configureert en inschakelt, moet u beslissen welke gebruikers en/of groepen in Microsoft Entra ID toegang nodig hebben tot Bonusly. Als u dit eenmaal hebt besloten, kunt u deze gebruikers en/of groepen aan Bonusly toewijzen door de instructies hier te volgen:

Belangrijke tips voor het toewijzen van gebruikers aan Bonusly

  • Het wordt aanbevolen om één Microsoft Entra-gebruiker toe te wijzen aan Bonusly om de configuratie van de automatische gebruikersinrichting te testen. Extra gebruikers en/of groepen kunnen later worden toegewezen.

  • Als u een gebruiker aan Bonusly toewijst, moet u een geldige toepassingsspecifieke rol (indien beschikbaar) selecteren in het toewijzingsdialoogvenster. Gebruikers met de rol Standaard toegang worden uitgesloten van het inrichten.

Automatische gebruikersinrichting voor Bonusly configureren

In deze sectie wordt u begeleid bij de stappen voor het configureren van de Microsoft Entra-inrichtingsservice om gebruikers en/of groepen in Bonusly te maken, bij te werken en uit te schakelen op basis van gebruikers- en/of groepstoewijzingen in Microsoft Entra-id.

Fooi

U kunt er ook voor kiezen om eenmalige aanmelding op basis van SAML in te schakelen voor Bonusly, waarvoor u de instructies in de zelfstudie Eenmalige aanmelding voor Bonusly moet volgen. Eenmalige aanmelding kan onafhankelijk van automatische inrichting van gebruikers worden geconfigureerd, maar deze twee functies vormen een aanvulling op elkaar.

Automatische gebruikersinrichting configureren voor Bonusly in Microsoft Entra ID:

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassing Beheer istrator.

  2. Blader naar Identity>Applications Enterprise-toepassingen>>Bonusly.

    Enterprise applications blade

  3. Selecteer Bonusly in de lijst met toepassingen.

    The Bonusly link in the Applications list

  4. Selecteer het tabblad Inrichten.

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

  5. Stel Inrichtingsmodus in op Automatisch.

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

  6. Voer in de sectie Beheerdersreferenties de Token voor geheim van uw Bonusly-account in, zoals wordt beschreven in stap 6.

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

  7. Het Token voor geheim voor uw Bonusly-account bevindt zich in Beheerder > Bedrijf > Integraties. Klik in de sectie Als u wilt coderen op API > Nieuw API-toegangstoken maken om een nieuw Token voor geheim te maken.

    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. Typ in het volgende scherm een naam voor het toegangstoken in het tekstvak en druk vervolgens op API-sleutel maken. Het nieuwe toegangstoken wordt een paar seconden weergegeven in een pop-up.

    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. Klik bij het invullen van de velden die worden weergegeven in stap 5 op Test Verbinding maken ion om ervoor te zorgen dat Microsoft Entra ID verbinding kan maken met Bonusly. Als de verbinding mislukt, moet u controleren of uw Bonusly-account beheerdersmachtigingen heeft. Probeer het daarna opnieuw.

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

  10. Voer in het veld E-mailadres voor meldingen het e-mailadres in van een persoon of groep die de inrichtingsfoutmeldingen zou moeten ontvangen en vink het vakje Een e-mailmelding verzenden als een fout optreedt aan.

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

  11. Klik op Opslaan.

  12. Selecteer in de sectie Toewijzingen Microsoft Entra-gebruikers synchroniseren met Bonusly.

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

  13. Controleer in de sectie Kenmerktoewijzing de gebruikerskenmerken die vanuit Microsoft Entra-id met Bonusly worden gesynchroniseerd. De kenmerken die als overeenkomende eigenschappen zijn geselecteerd, worden gebruikt om de gebruikersaccounts in Bonusly te vinden voor updatebewerkingen. Selecteer de knop Opslaan om eventuele wijzigingen door te voeren.

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

  14. Als u bereikfilters wilt configureren, raadpleegt u de volgende instructies in de zelfstudie Bereikfilter.

  15. Als u de Microsoft Entra-inrichtingsservice voor Bonusly wilt inschakelen, wijzigt u de inrichtingsstatus in Aan in de sectie Instellingen.

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

  16. Definieer de gebruikers en/of groepen die u aan Bonusly wilt toevoegen door de gewenste waarden te kiezen in Bereik in de sectie Instellingen.

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

  17. Wanneer u klaar bent om in te richten, klikt u op Opslaan.

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

Met deze bewerking wordt de eerste synchronisatie gestart van alle gebruikers en/of groepen die zijn gedefinieerd onder Bereik in de sectie Instellingen. De eerste synchronisatie duurt langer dan volgende synchronisaties, die ongeveer om de 40 minuten plaatsvinden zolang de Microsoft Entra-inrichtingsservice wordt uitgevoerd. U kunt de sectie Synchronisatiedetails gebruiken om de voortgang te controleren en koppelingen te volgen naar het activiteitenrapport van de inrichting, waarin alle acties worden beschreven die door de Microsoft Entra-inrichtingsservice op Bonusly worden uitgevoerd.

Zie Rapportage over automatische inrichting van gebruikersaccounts voor meer informatie over het lezen van de Microsoft Entra-inrichtingslogboeken.

Aanvullende bronnen

Volgende stappen