Delen via

Zelfstudie: Playvox configureren voor automatische gebruikersinrichting

  • Artikel

In deze zelfstudie worden de stappen beschreven die u moet volgen in zowel Playvox als Microsoft Entra ID voor het configureren van automatische inrichting van gebruikers. Wanneer deze is geconfigureerd, richt Microsoft Entra ID gebruikers of groepen automatisch in op Playvox met behulp van de Microsoft Entra-inrichtingsservice. Voor belangrijke informatie over wat deze service doet en hoe deze werkt, en voor veelgestelde vragen, raadpleegt u Het inrichten en ongedaan maken van inrichting van gebruikers automatiseren voor SaaS-toepassingen met Microsoft Entra ID.

Ondersteunde mogelijkheden

  • Gebruikers maken in Playvox.
  • Gebruikers verwijderen uit Playvox wanneer ze geen toegang meer nodig hebben.
  • Gebruikerskenmerken gesynchroniseerd houden tussen Microsoft Entra ID en Playvox.

Vereisten

In het scenario dat in deze zelfstudie wordt beschreven, wordt ervan uitgegaan dat u al voldoet aan de volgende vereisten:

Stap 1: De implementatie van uw inrichting plannen

  1. Lees hoe de inrichtingsservice werkt.

  2. Bepaal wie u wilt opnemen in het bereik voor inrichting.

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

Stap 2: Playvox configureren ter ondersteuning van inrichting met behulp van Microsoft Entra-id

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

  2. Selecteer API-sleutel maken.

    Gedeeltelijke schermopname van de locatie van de knop API-sleutel maken in de Playvox-gebruikersinterface.

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

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

    Gedeeltelijke schermopname van het pictogram Details, een vergrootglas, in de Playvox-gebruikersinterface.

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

    Schermopname van het berichtvak Details API-sleutel, met de waarde BASE64 KEY gemarkeerd.

Als u de inrichting voor Playvox wilt beheren, voegt u Playvox toe aan uw Microsoft Entra-tenant vanuit de toepassingsgalerie. Zie quickstart: Een toepassing toevoegen aan uw Microsoft Entra-tenant voor meer informatie.

Als u Playvox al eerder hebt ingesteld voor eenmalige aanmelding (SSO), kunt u dezelfde toepassing gebruiken. We raden u echter aan een afzonderlijke app te maken wanneer u de integratie voor het eerst test.

Stap 4: Bepalen wie er allemaal in aanmerking komen voor inrichting

U gebruikt de Microsoft Entra-inrichtingsservice om te bepalen wie wordt ingericht, op basis van toewijzing aan de toepassing of op kenmerken van de gebruiker of groep. Als u wilt bepalen wie voor uw app wordt ingericht op basis van toewijzing, raadpleegt u Gebruikerstoewijzing beheren voor een app in Microsoft Entra ID voor informatie over het toewijzen van gebruikers of groepen aan de toepassing. Als u uitsluitend wilt bepalen wie wordt ingericht op basis van kenmerken van de gebruiker of groep, gebruikt u een bereikfilter zoals beschreven in Op kenmerk gebaseerde toepassingsinrichting met bereikfilters.

Onthoud deze punten:

  • Wanneer u gebruikers toewijst aan Playvox, moet u een andere rol dan Standaardtoegang selecteren. Gebruikers met de rol Standaardtoegang worden uitgesloten van inrichting en worden gemarkeerd als niet-effectief gerechtigd in de inrichtingslogboeken. Als Standaardtoegang de enige beschikbare rol voor de toepassing is, kunt u het manifest van de toepassing bijwerken om andere rollen toe te voegen.

  • Begin klein. Test de toepassing met een kleine set gebruikers of groepen voordat u de toepassing naar iedereen uitrolt. Wanneer het inrichtingsbereik is gebaseerd op toegewezen gebruikers en groepen, kunt u het formaat van de set beheren door slechts een of twee gebruikers of groepen aan de toepassing toe te wijzen. Wanneer het inrichtingsbereik alle gebruikers en groepen bevat, kunt u een bereikfilter op basis van kenmerken opgeven om de grootte van uw testset te beperken.

Stap 5: Automatische gebruikersinrichting 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 cloudtoepassing Beheer istrator.

  2. Blader naar Bedrijfstoepassingen voor identiteitstoepassingen>>.

    Gedeeltelijke schermopname van de Azure Portal, met Enterprise-toepassingen en Alle toepassingen gemarkeerd.

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

    Gedeeltelijke schermopname van de lijst met toepassingen, met het zoekvak Toepassing gemarkeerd.

  4. Selecteer het tabblad Inrichten.

    Gedeeltelijke schermopname van het menu-item Inrichting.

  5. Stel Inrichtingsmodus in op Automatisch.

    Gedeeltelijke schermopname van het tabblad Inrichting, met de optie Automatisch geselecteerd in de vervolgkeuzelijst Inrichtingsmodus.

  6. Voer in de sectie Beheerdersreferenties uw Playvox-tenant-URL in als:

    https://{tenant}.playvox.com/scim/v1

    Voer het Token voor geheim in dat u eerder in stap 2 hebt gekopieerd. Selecteer vervolgens Test Verbinding maken ion om ervoor te zorgen dat Microsoft Entra ID verbinding kan maken met Playvox. Als de verbinding mislukt, moet u controleren of uw Playvox-account beheerdersmachtigingen heeft. Probeer het daarna opnieuw.

    Gedeeltelijke schermopname van de sectie Beheerdersreferenties, inclusief de tekstvakken Tenant-URL en Token voor geheim, en met de link Verbinding testen gemarkeerd.

  7. Voer in het tekstvak E-mailadres voor meldingen het e-mailadres in van een persoon of groep die de meldingen voor de inrichtingsfouten ontvangen. Selecteer vervolgens het selectievakje Een e-mailmelding verzenden wanneer er een fout optreedt.

    Gedeeltelijke schermopname van het tekstvak Meldings-e-mail en het selectievakje e-mailmelding.

  8. Selecteer Opslaan.

  9. Selecteer in de sectie Toewijzingen Microsoft Entra-gebruikers synchroniseren met Playvox.

  10. Controleer in de sectie Kenmerktoewijzing de gebruikerskenmerken die vanuit Microsoft Entra-id met Playvox worden gesynchroniseerd. De kenmerken die zijn geselecteerd als overeenkomende eigenschappen, 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 API van Playvox het filteren van gebruikers op basis van dat kenmerk ondersteunt. Selecteer Opslaan om eventuele wijzigingen toe te passen.

    Kenmerk Type Ondersteund voor filteren
    gebruikersnaam String ✓
    actief Booleaanse waarde
    displayName String
    emails[type eq "work"].value String
    name.givenName String
    name.familyName String
    name.formatted String
    externalId String

  11. Raadpleeg de instructies in de Zelfstudie bereikfilter als u bereikfilters wilt configureren.

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

    Gedeeltelijke schermopname van de sectie Instellingen, met de Inrichtingsstatus ingesteld op Aan.

  13. Definieer in Instellingen de gebruikers of groepen die moeten worden ingericht voor Playvox door de gewenste waarden in Bereik te kiezen.

    Gedeeltelijke schermopname van de sectie Instellingen, met de vervolgkeuzelijst Bereik.

  14. Selecteer Opslaan als u klaar bent voor het inrichten.

    Gedeeltelijke schermopname van de opties Opslaan en Verwijderen.

Met deze bewerking wordt de eerste synchronisatiecyclus gestart van alle gebruikers en groepen die zijn gedefinieerd onder Bereik in de sectie Instellingen. De eerste cyclus duurt langer dan latere cycli. Latere cycli vinden ongeveer om de 40 minuten plaats, mits de Microsoft Entra-inrichtingsservice wordt uitgevoerd.

Stap 6: Uw implementatie controleren

Nadat u het inrichten hebt geconfigureerd, gebruikt u de volgende resources om uw implementatie te bewaken:

  • Gebruik de inrichtingslogboeken om te bepalen welke gebruikers al dan niet met succes zijn ingericht.
  • Controleer de voortgangsbalk om de status van de inrichtingscyclus weer te geven en te zien of deze al bijna is voltooid.
  • Als het configureren van de inrichting een foutieve status lijkt te hebben, wordt de toepassing in quarantaine geplaatst. Zie Toepassing inrichten in quarantainestatus voor meer informatie over quarantainestatussen.

Aanvullende bronnen

Volgende stappen