Vonage configureren voor automatische toewijzing van gebruikers met behulp van Microsoft Entra ID

In dit artikel worden de stappen beschreven die u moet uitvoeren in Vonage en Microsoft Entra ID voor het configureren van automatische gebruikersvoorziening. Wanneer geconfigureerd, richt Microsoft Entra ID gebruikers en groepen automatisch in en verwijdert deze uit Vonage met behulp van de Microsoft Entra-inrichtingsservice. Zie Automate user provisioning and deprovisioning to SaaS applications with Microsoft Entra ID voor belangrijke informatie over wat deze service doet, hoe deze werkt en veelgestelde vragen.

Ondersteunde mogelijkheden

  • Maak gebruikers in Vonage.
  • Verwijder gebruikers in Vonage wanneer ze geen toegang meer nodig hebben.
  • Gebruikerskenmerken gesynchroniseerd houden tussen Microsoft Entra ID en Vonage.
  • Eenmalige aanmelding bij Vonage (aanbevolen).
  • Authenticatie via de Code Auth Grant-flow wordt ondersteund.

Vereiste voorwaarden

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

Stap 1: Het plannen van uw provisioning-implementatie

  1. Lees meer over hoe de inrichtingsservice werkt.
  2. Bepalen wie binnen de reikwijdte van inrichting behoort.
  3. Bepaal welke gegevens moeten worden gemapt tussen Microsoft Entra ID en Vonage.

Stap 2: Configureer Vonage om te ondersteunen bij provisioning met Microsoft Entra ID

  1. Meld u aan bij de Vonage-beheerportal met een gebruiker met beheerdersrechten.

    Schermopname van aanmelden bij de vonage-beheerportal.

  2. Ga naar Account > Single Sign-On Settings in het menu aan de linkerkant.

    Schermopname van instellingen voor eenmalige aanmelding.

  3. Selecteer het tabblad Gebruikersinstellingen , schakel SCIM-gebruikersinrichting inschakelen in en selecteer Opslaan.

Schermopname van SCIM inschakelen.

Voeg Vonage toe vanuit de Microsoft Entra applicatiegalerij om de provisioning voor Vonage te beheren. Als u Vonage eerder hebt ingesteld voor eenmalige aanmelding, 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. Meer informatie over het toevoegen van een toepassing vanuit de galerie vindt u hier.

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 bereikfilter gebruiken.

  • 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 een kenmerk opgeven.

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

Stap 5: Automatische gebruikersvoorziening configureren voor Vonage

Opmerking

Elke gebruiker die aan Vonage is toegevoegd, moet voornaam, achternaam en e-mailadres hebben. Anders mislukt de integratie.

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

Automatische gebruikersprovisioning configureren voor Vonage in Microsoft Entra ID

  1. Meld u aan bij de Microsoft Entra-beheercentrum als ten minste een Cloud-toepassingsbeheerder.

  2. Blader naar Entra ID>Enterprise apps

    Schermopname van het tabblad Enterprise-applicaties.

  3. Selecteer Vonage in de lijst met toepassingen.

    Schermopname van de koppeling Vonage in de lijst met toepassingen.

  4. Selecteer het tabblad Inrichten .

    Schermopname van het tabblad Inrichten.

  5. Selecteer + Nieuwe configuratie.

    Schermopname van nieuwe configuratie.

  6. Voordat u de volgende stap uitvoert, moet u ervoor zorgen dat u bent gemachtigd als Supergebruiker voor accounts. Als u wilt controleren of de gebruiker een account supergebruiker is, voert u zich aan bij de Vonage-beheerportal. U zou in de linkerbovenhoek iets moeten zien dat vergelijkbaar is met de onderstaande afbeelding.

    Schermopname van de gebruiker van het tabblad Inrichten.

  7. Selecteer in de sectie Beheerdersreferenties de optie Autoriseren. Zorg ervoor dat u uw Account Supergebruiker-referenties invoert. Als u niet wordt gevraagd om referenties in te voeren, zorg dan dat u bent aangemeld met de Account Supergebruiker. U kunt dit controleren aan de linker bovenkant, onder uw naam, waar "Account Supergebruiker" moet staan. Selecteer Test Connection om ervoor te zorgen dat Microsoft Entra ID verbinding kan maken met Vonage. Als de verbinding mislukt, moet u controleren of uw Vonage-account beheerdersmachtigingen heeft en probeer het opnieuw.

    Schermopname van een token.

  8. Selecteer Maken om uw configuratie te maken.

  9. Selecteer Eigenschappen op de pagina Overzicht .

  10. Selecteer het pictogram Bewerken om de eigenschappen te bewerken. Schakel e-mailberichten voor meldingen in en geef een e-mailbericht op om quarantainemeldingen te ontvangen. Schakel preventie van onbedoelde verwijderingen in. Selecteer Toepassen om de wijzigingen op te slaan.

    Schermopname van provisioning-instellingen.

  11. Selecteer Kenmerktoewijzing in het linkerdeelvenster en selecteer gebruikers.

  12. Controleer in de sectie Attribute-Mapping de gebruikerskenmerken die vanuit Microsoft Entra ID met Vonage worden gesynchroniseerd. De kenmerken die als overeenkomende eigenschappen zijn geselecteerd, worden gebruikt om de gebruikersaccounts in Vonage te vinden voor updatebewerkingen. Als u ervoor kiest om het overeenkomende doelkenmerk te wijzigen, moet u ervoor zorgen dat de Vonage-API het filteren van gebruikers op basis van dat kenmerk ondersteunt. Selecteer de knop Opslaan om wijzigingen door te voeren.

    Kenmerk Typ Ondersteund voor filteren
    gebruikersnaam Touwtje
    actief Booleaan
    emails[type gelijk aan "work"].waarde Touwtje
    naam.gegevenNaam Touwtje
    naam.familienaam Touwtje
  13. Als u bereikfilters wilt configureren, raadpleegt u de instructies in het artikel Bereikfilter.

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

  15. 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 niet succesvol zijn ingericht.
  2. Controleer de voortgangsbalk om de status van de inrichtingscyclus te bekijken en hoe dichtbij deze bij voltooiing is.
  3. Als de toepassingsconfiguratie in een ongezonde toestand lijkt te verkeren, wordt de applicatie in quarantaine geplaatst. Meer informatie over quarantainestatussen in het artikel over het inrichten van quarantainestatussen van toepassingen.

Meer middelen