Självstudie: Konfigurera Vonage för automatisk användaretablering
I den här självstudien beskrivs de steg du behöver utföra i både Vonage- och Microsoft Entra-ID för att konfigurera automatisk användaretablering. När microsoft Entra-ID konfigureras etableras och avetableras användare och grupper automatiskt till Vonage med hjälp av Microsoft Entra-etableringstjänsten. Viktig information om vad den här tjänsten gör, hur den fungerar och vanliga frågor finns i Automatisera användaretablering och avetablering till SaaS-program med Microsoft Entra-ID.
Funktioner som stöds
- Skapa användare i Vonage.
- Ta bort användare i Vonage när de inte längre behöver åtkomst.
- Behåll användarattribut synkroniserade mellan Microsoft Entra-ID och Vonage.
- Enkel inloggning till Vonage (rekommenderas).
Förutsättningar
Scenariot som beskrivs i den här självstudien förutsätter att du redan har följande förutsättningar:
- En Microsoft Entra-klientorganisation.
- Ett användarkonto i Microsoft Entra-ID med behörighet att konfigurera etablering (till exempel programadministratör, molnprogramadministratör, programägare eller global administratör).
- En Vonage-klientorganisation .
- Ett användarkonto i Vonage med administratörsbehörighet (Konto superanvändare).
Steg 1: Planera etableringsdistributionen
- Lär dig mer om hur etableringstjänsten fungerar.
- Ta reda på vem som finns i etableringsomfånget.
- Ta reda på vilka data som ska mappas mellan Microsoft Entra-ID och Vonage.
Steg 2: Konfigurera Vonage för att stödja etablering med Microsoft Entra-ID
Logga in på Vonage-administratörsportalen med en administratörsanvändare.
Gå till Konto > enkel inloggning Inställningar på menyn till vänster.
Välj fliken Användare Inställningar, växla Aktivera SCIM-användaretablering PÅ och klicka på Spara.
Steg 3: Lägg till Vonage från Microsoft Entra-programgalleriet
Lägg till Vonage från Microsoft Entra-programgalleriet för att börja hantera etablering till Vonage. Om du tidigare har konfigurerat Vonage för enkel inloggning kan du använda samma program. Vi rekommenderar dock att du skapar en separat app när du testar integreringen i början. Lär dig mer om att lägga till ett program från galleriet här.
Steg 4: Definiera vem som ska finnas i omfånget för etablering
Med Microsoft Entra-etableringstjänsten kan du omfångsbegränsa vem som ska etableras baserat på tilldelning till programmet och eller baserat på attribut för användaren/gruppen. Om du väljer att omfånget som ska etableras till din app ska baseras på tilldelning, kan du använda följande steg för att tilldela användare och grupper till programmet. Om du väljer att omfånget endast ska etableras baserat på attribut för användaren eller gruppen, kan du använda ett omfångsfilter enligt beskrivningen här.
Starta i liten skala. Testa med en liten uppsättning användare och grupper innan du distribuerar till alla. När etableringsomfånget har angetts till tilldelade användare och grupper, kan du kontrollera detta genom att tilldela en eller två användare eller grupper till appen. När omfånget är inställt på alla användare och grupper, kan du ange ett attributbaserat omfångsfilter.
Om du behöver ytterligare roller kan du uppdatera programmanifestet för att lägga till nya roller.
Steg 5: Konfigurera automatisk användaretablering till Vonage
Kommentar
Alla användare som läggs till i Vonage måste ha förnamn, efternamn och e-post. Annars misslyckas integreringen.
Det här avsnittet vägleder dig genom stegen för att konfigurera Microsoft Entra-etableringstjänsten för att skapa, uppdatera och inaktivera användare och/eller grupper i Vonage baserat på användar- och/eller grupptilldelningar i Microsoft Entra-ID.
Så här konfigurerar du automatisk användaretablering för Vonage i Microsoft Entra-ID:
Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.
Bläddra till Identity>Applications Enterprise-program>
I programlistan väljer du Vonage.
Välj fliken Etablering.
Ange Etableringsläge som Automatiskt.
Innan nästa steg kontrollerar du att du har behörighet som superanvändare för kontot. För att kontrollera om användaren är ett konto superanvändare utför inloggning på Vonage admin portal. Du bör se på den övre vänstra sidan som liknar bilden nedan.
I avsnittet Administratörsautentiseringsuppgifter klickar du på Auktorisera och kontrollerar att du anger dina autentiseringsuppgifter för superanvändare för kontot. Om du inte ber dig ange autentiseringsuppgifter kontrollerar du att du har loggat in med superanvändaren för kontot (du kan kontrollera det http://admin.vonage.com/ längst upp till vänster och bälg ditt namn som du behöver för att se "Konto superanvändare"). Klicka på Test Anslut ion för att se till att Microsoft Entra ID kan ansluta till Vonage. Om anslutningen misslyckas kontrollerar du att Vonage-kontot har administratörsbehörighet och försöker igen.
I fältet E-postavisering anger du e-postadressen till den person eller grupp som ska ta emot meddelanden om etableringsfel. Markera sedan kryssrutan Skicka ett e-postmeddelande när ett fel uppstår.
Välj Spara.
I avsnittet Mappningar väljer du Synkronisera Microsoft Entra-användare till Vonage.
Granska de användarattribut som synkroniseras från Microsoft Entra-ID till Vonage i avsnittet Attributmappning . Attributen som valts som Matchande egenskaper används för att matcha användarkontona i Vonage för uppdateringsåtgärder. Om du väljer att ändra det matchande målattributet måste du se till att Vonage-API:et stöder filtrering av användare baserat på det attributet. Välj knappen Spara för att checka in eventuella ändringar.
Attribut Type Stöds för filtrering userName String ✓ aktiv Booleskt emails[type eq "work"].value String name.givenName String name.familyName String Information om hur du konfigurerar omfångsfilter finns i följande instruktioner i självstudien för omfångsfilter.
Om du vill aktivera Microsoft Entra-etableringstjänsten för Vonage ändrar du etableringsstatusen till På i avsnittet Inställningar.
Definiera de användare och/eller grupper som du vill etablera till Vonage genom att välja önskade värden i Omfång i avsnittet Inställningar.
När du är redo att etablera klickar du på Spara.
Åtgärden startar den initiala synkroniseringscykeln för alla användare och grupper som har definierats i Omfång i avsnittet Inställningar. Den inledande cykeln tar längre tid att utföra än efterföljande cykler, som inträffar ungefär var 40:e minut så länge Microsoft Entra-etableringstjänsten körs.
Steg 6: Övervaka distributionen
När du har konfigurerat etableringen använder du följande resurser till att övervaka distributionen:
- Använd etableringsloggarna för att se vilka användare som har etablerats och vilka som har misslyckats
- Kontrollera förloppsindikatorn för att se status för etableringscykeln och hur nära den är att slutföras
- Om etableringskonfigurationen verkar innehålla fel, kommer programmet att placeras i karantän. Läs mer om karantänstatus här.
Fler resurser
- Hantera användarkontoetablering för Enterprise-appar
- Vad är programåtkomst och enkel inloggning med Microsoft Entra-ID?