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 als cloudtoepassingsbeheerder aan bij het Microsoft Entra-beheercentrum.

  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 de lijst met resultaten

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.

Tip

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 als cloudtoepassingsbeheerder aan bij het Microsoft Entra-beheercentrum.

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

    De blade Bedrijfstoepassingen

  3. Selecteer Bonusly in de lijst met toepassingen.

    De koppeling voor Bonusly in de lijst met toepassingen

  4. Selecteer het tabblad Inrichten.

    Schermopname van het tabblad Bonusly - Inrichten. Onder Beheren is Inrichten gemarkeerd.

  5. Stel Inrichtingsmodus in op Automatisch.

    Schermopname van het lijstvak Inrichtingsmodus, met Automatisch geselecteerd en gemarkeerd.

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

    Schermopname van de sectie Referenties voor beheerder. Het tokenvak Geheim is leeg, maar het vak is gemarkeerd.

  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.

    Schermopname van het Bonusly-menu. Onder Beheerder is Bedrijf gemarkeerd. Onder Company is Integrations gemarkeerd.

    Schermopname van de sectie Als u wilt coderen van de Bonusly-website, met A P I gemarkeerd.

    Schermopname van de Bonusly-site. Het tabblad Services is geopend. Onder Uw P I-toegangstokens is nieuw A P I-toegangstoken maken gemarkeerd.

  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.

    Schermopname van de pagina Nieuw toegangstoken van de Bonusly-site. Een niet-gelabeld vak bevat Mijn token en de knop A P I-toets maken is gemarkeerd.

    Schermopname van de Bonusly-site. Er is een melding zichtbaar waarin nieuw toegangstoken wordt weergegeven dat is gemaakt, gevolgd door een ondenkbaar token.

  9. Klik bij het invullen van de velden die worden weergegeven in stap 5 op Verbinding testen om te controleren of de 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.

    Schermopname van de sectie Referenties voor beheerder. De knop Tekstverbinding is gemarkeerd.

  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.

    Schermopname van een leeg e-mailadres voor meldingen. Een optie is zichtbaar met het label Een e-mailmelding verzenden wanneer er een fout optreedt.

  11. Klik op Opslaan.

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

    Schermopname van de sectie Toewijzingen. Onder Naam is Microsoft Entra-gebruikers synchroniseren met Bonusly gemarkeerd.

  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.

    Schermopname van de pagina Kenmerktoewijzingen. Een tabel bevat Microsoft Entra-kenmerken, bijbehorende Bonusly-kenmerken en de overeenkomende 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.

    Schermopname van de sectie Instellingen. De wisselknop Inrichtingsstatus is ingesteld op Uit.

  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.

    Schermopname van de keuzelijst Bereik. Alleen toegewezen gebruikers en groepen synchroniseren is geselecteerd in het vak.

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

    Schermopname van de pagina Inrichten van Bonusly met de knop Opslaan gemarkeerd.

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