Configureer Playvox voor automatische user provisioning met Microsoft Entra ID

In dit artikel worden de stappen beschreven die u moet volgen in zowel Playvox als Microsoft Entra ID om automatische gebruikersvoorziening te configureren. Wanneer geconfigureerd, voorziet Microsoft Entra ID automatisch gebruikers of groepen aan en onttrekt deze van Playvox door middel van de Microsoft Entra-inrichtingsservice. Voor belangrijke informatie over wat deze service doet en hoe deze werkt, en voor veelgestelde vragen, raadpleeg Het automatiseren van gebruikersinrichting en -ontmanteling voor SaaS-toepassingen met Microsoft Entra ID.

Ondersteunde mogelijkheden

Vereiste voorwaarden

In het scenario in dit artikel wordt ervan uitgegaan dat u al beschikt over de volgende vereisten:

• een Microsoft Entra-tenant.
• Een van de volgende rollen: Toepassingsbeheerder, Cloudtoepassingsbeheerder of Toepassingseigenaar.
• Een gebruikersaccount in Playvox met superbeheerdersmachtigingen.

Stap 1: Plan uw implementatie van voorzieningen

1. Meer informatie over hoe de inrichtingsservice werkt.

2. Bepalen wie in aanmerking komt voor voorziening.

3. Bepaal welke gegevens moeten worden gekoppeld tussen Microsoft Entra ID en Playvox.

Stap 2: Playvox configureren ter ondersteuning van provisioning met behulp van Microsoft Entra ID

1. Meld u aan bij de Playvox-beheerconsole en ga naar API-sleutels voor instellingen>.

2. Selecteer API-sleutel maken.

   

3. Voer een betekenisvolle naam in voor de API-sleutel en selecteer Opslaan. Nadat de API-sleutel is gegenereerd, selecteert u Sluiten.

4. Selecteer in de API-sleutel die u hebt gemaakt het pictogram Details .

   

5. Kopieer de BASE64 KEY-waarde en sla deze op. Later voert u in Azure Portal deze waarde in het tekstvak Token voor geheim in op het tabblad Inrichten van uw Playvox-toepassing.

   

Stap 3: Playvox toevoegen vanuit de Microsoft Entra-toepassingsgalerie

Begin met het beheren van de inrichting voor Playvox door Playvox toe te voegen aan uw Microsoft Entra-tenant vanuit de toepassingsgalerie. Zie quickstart: Een toepassing toevoegen aan uw Microsoft Entra-tenant voor meer informatie.

Als u Playvox eerder hebt ingesteld voor eenmalige aanmelding (SSO), kunt u dezelfde toepassing gebruiken. We raden u echter aan om een afzonderlijke app te maken bij het testen van de integratie in eerste instantie.

Stap 4: Bepaal wie binnen de scope van voorzieningen valt.

Met de Microsoft Entra-inrichtingsservice kunt u bepalen wie is ingericht op basis van toewijzing aan de toepassing of op basis van kenmerken van de gebruiker of groep. Als u ervoor kiest om te bepalen wie voor uw app is ingericht op basis van toewijzing, kunt u de stappen gebruiken om gebruikers en groepen toe te wijzen aan de toepassing. Als u ervoor kiest om te bepalen wie alleen is ingericht op basis van kenmerken van de gebruiker of groep, kunt u een bereikfiltergebruiken.

• Begin klein. Test de toepassing met een kleine set gebruikers en groepen voordat u de toepassing naar iedereen uitrolt. Wanneer het bereik voor inrichting is ingesteld op toegewezen gebruikers en groepen, kunt u dit beheren door een of twee gebruikers of groepen toe te wijzen aan de app. Wanneer het bereik is ingesteld op alle gebruikers en groepen, kunt u een bereikfilter op basis van kenmerken opgeven.

• Als u extra rollen nodig hebt, kunt u het toepassingsmanifest bijwerken om nieuwe rollen toe te voegen.

Stap 5: Automatische inrichting van gebruikers configureren voor Playvox

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

Automatische gebruikersinrichting configureren voor Playvox in Microsoft Entra ID:

1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassingsbeheerder.

2. Navigeer naar Entra ID>Enterprise apps.

   

3. Zoek en selecteer Playvox in de lijst met toepassingen.

   

4. Selecteer het tabblad Inrichten.

   

5. Selecteer + Nieuwe configuratie.

   

6. Voer in het veld Tenant URL de Playvox Tenant-URL en Secret Token in. Selecteer Test Connection om ervoor te zorgen dat Microsoft Entra ID verbinding kan maken met Playvox. Als de verbinding mislukt, controleert u of uw Playvox-account over de vereiste beheerdersmachtigingen beschikt en probeer het opnieuw.

   

7. Selecteer Maken om uw configuratie te maken.

8. Selecteer Eigenschappen op de pagina Overzicht .

9. Selecteer het potlood om de eigenschappen te bewerken. Schakel e-mailberichten voor meldingen in en geef een e-mailbericht op om quarantaine-e-mailberichten te ontvangen. Preventie van onbedoelde verwijderingen inschakelen. Selecteer Toepassen om de wijzigingen op te slaan.

   

10. Selecteer Kenmerktoewijzing in het linkerdeelvenster en selecteer gebruikers.

11. Controleer in de sectie Kenmerktoewijzing de gebruikerskenmerken die vanuit Microsoft Entra-id met Playvox worden gesynchroniseerd. De kenmerken die als overeenkomende eigenschappen zijn geselecteerd, worden gebruikt om de gebruikersaccounts in Playvox te vinden voor updatebewerkingen. Als u ervoor kiest om het overeenkomende doelkenmerk te wijzigen, moet u ervoor zorgen dat de Playvox-API het filteren van gebruikers op basis van dat kenmerk ondersteunt. Selecteer Opslaan om eventuele wijzigingen toe te passen.

    Kenmerk	Typ	Ondersteund voor filteren
    gebruikersnaam	Touwtje	✓
    actief	Booleaan
    weergavenaam	Touwtje
    emails[type gelijk aan "work"].waarde	Touwtje
    naam.gegevenNaam	Touwtje
    naam.familienaam	Touwtje
    naam.geformatteerd	Touwtje
    externId	Touwtje

12. Als u bereikfilters wilt configureren, raadpleegt u de volgende instructies in het artikel Bereikfilter.

13. Gebruik inrichting op aanvraag om synchronisatie te valideren met een klein aantal gebruikers voordat u een grotere implementatie in uw organisatie implementeert.

14. Wanneer u klaar bent om in te richten, selecteert u Inrichten starten op de pagina Overzicht .

Stap 6: Uw implementatie bewaken

Zodra u de inrichting hebt geconfigureerd, gebruikt u de volgende resources om uw implementatie te bewaken:

1. Gebruik de inrichtingslogboeken om te bepalen welke gebruikers succesvol of onsuccesvol zijn ingericht.
2. Controleer de voortgangsbalk om de status van de provisioningcyclus te zien en hoe dicht het bij voltooiing is.
3. Als de toepassingsconfiguratie in een ongezonde toestand lijkt te verkeren, wordt de applicatie in quarantaine geplaatst. Vind meer informatie over de quarantainestatussen in het artikel over de quarantainestatus van de toepassing.

Aanvullende bronnen

• Het inrichten van gebruikersaccounts voor zakelijke apps beheren
• Wat is toegang tot toepassingen en eenmalige aanmelding met Microsoft Entra ID?

Verwante inhoud

• Meer informatie over het controleren van logboeken en het ophalen van rapporten over de inrichtingsactiviteit