Självstudie: Konfigurera Playvox för automatisk användaretablering

  • Artikel

I den här självstudien beskrivs de steg som ska följas i både Playvox- och Microsoft Entra-ID för att konfigurera automatisk användaretablering. När det är konfigurerat etablerar och avreglerar Microsoft Entra-ID automatiskt användare eller grupper till Playvox med hjälp av Microsoft Entra-etableringstjänsten. Viktig information om vad den här tjänsten gör och hur den fungerar och för 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 Playvox.
  • Ta bort användare i Playvox när de inte behöver åtkomst längre.
  • Behåll användarattribut synkroniserade mellan Microsoft Entra-ID och Playvox.

Förutsättningar

Scenariot i den här självstudien förutsätter att du redan har följande förutsättningar:

Steg 1: Planera etableringsdistributionen

  1. Lär dig hur etableringstjänsten fungerar.

  2. Ta reda på vem som finns i etableringsomfånget.

  3. Ta reda på vilka data som ska mappas mellan Microsoft Entra-ID och Playvox.

Steg 2: Konfigurera Playvox för att stödja etablering med hjälp av Microsoft Entra-ID

  1. Logga in på Playvox-administratörskonsolen och gå till Inställningar > API-nycklar.

  2. Välj Skapa API-nyckel.

    Partiell skärmbild som visar platsen för knappen Skapa API-nyckel i Playvox-användargränssnittet.

  3. Ange ett beskrivande namn för API-nyckeln och välj sedan Spara. När API-nyckeln har genererats väljer du Stäng.

  4. På DEN API-nyckel som du skapade väljer du ikonen Information .

    Partiell skärmbild som visar platsen för informationsikonen, som är ett förstoringsglas, i Playvox-användargränssnittet.

  5. Kopiera och spara BASE64 KEY-värdet . Senare i Azure-portalen anger du det här värdet i textrutan Hemlig token på fliken Etablering i ditt Playvox-program.

    Skärmbild av meddelanderutan Informations-API-nyckel med BASE64 KEY-värdet markerat.

Om du vill börja hantera etablering till Playvox lägger du till Playvox i din Microsoft Entra-klientorganisation från programgalleriet. Mer information finns i Snabbstart: Lägga till ett program i din Microsoft Entra-klientorganisation.

Om du tidigare har konfigurerat Playvox för enkel inloggning (SSO) kan du använda samma program. Vi rekommenderar dock att du skapar en separat app när du testar integreringen från början.

Steg 4: Definiera vem som ska finnas i omfånget för etablering

Du använder Microsoft Entra-etableringstjänsten för att omfånget vem som ska etableras, baserat antingen på tilldelning till programmet eller på attribut för användaren eller gruppen. Information om vem som ska etableras i din app baserat på tilldelning finns i Hantera användartilldelning för en app i Microsoft Entra-ID för att lära dig hur du tilldelar användare eller grupper till programmet. Om du vill begränsa vem som ska etableras enbart baserat på attribut för användaren eller gruppen använder du ett omfångsfilter enligt beskrivningen i Attributbaserad programetablering med omfångsfilter.

Kom ihåg följande punkter:

  • När du tilldelar användare till Playvox måste du välja en annan roll än Standardåtkomst. Användare med rollen Standardåtkomst undantas från etableringen och markeras som icke-berättigade i etableringsloggarna. Om Standardåtkomst är den enda roll som är tillgänglig i programmet kan du uppdatera programmanifestet för att lägga till andra roller.

  • Starta i liten skala. Testa med en liten uppsättning användare eller grupper innan du distribuerar till alla. När etableringsomfånget baseras på tilldelade användare eller grupper kan du styra storleken på uppsättningen genom att endast tilldela en eller två användare eller grupper till appen. När etableringsomfånget omfattar alla användare och grupper kan du ange ett attributbaserat omfångsfilter för att begränsa storleken på testuppsättningen.

Steg 5: Konfigurera automatisk användaretablering till Playvox

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 eller grupper baserat på användar- eller grupptilldelningar i Microsoft Entra-ID.

Så här konfigurerar du automatisk användaretablering för Playvox i Microsoft Entra-ID:

  1. Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.

  2. Bläddra till Identity>Applications Enterprise-program.>

    Partiell skärmbild av Azure-portalen med Enterprise-program och Alla programobjekt markerade

  3. I programlistan söker du efter och väljer Playvox.

    Partiell skärmbild av programlistan med sökrutan markerad.

  4. Välj fliken Etablering.

    Partiell skärmbild som visar menyalternativet Etablering.

  5. Ange Etableringsläge som Automatiskt.

    Partiell skärmbild av fliken Etablering som visar alternativet Automatiskt valt i listrutan Etableringsläge.

  6. I avsnittet Administratörsautentiseringsuppgifter anger du din Playvox-klient-URL som:

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

    Ange den hemliga token som du kopierade tidigare i steg 2. Välj sedan Test Anslut ion för att se till att Microsoft Entra ID kan ansluta till Playvox. Om anslutningen misslyckas kontrollerar du att ditt Playvox-konto har administratörsbehörighet och försöker igen.

    Partiell skärmbild som visar avsnittet Administratörsautentiseringsuppgifter, inklusive textrutorna Klient-URL och Hemlig token, och med länken Testa Anslut ion markerad.

  7. I textrutan E-postavisering anger du e-postadressen till en person eller grupp som får meddelanden om etableringsfel. Markera sedan kryssrutan Skicka ett e-postmeddelande när ett fel inträffar .

    Partiell skärmbild som visar textrutan e-postavisering och kryssrutan e-postavisering.

  8. Välj Spara.

  9. I avsnittet Mappningar väljer du Synkronisera Microsoft Entra-användare till Playvox.

  10. Granska de användarattribut som synkroniseras från Microsoft Entra-ID till Playvox i avsnittet Attributmappning . Attributen som valts som Matchande egenskaper används för att matcha användarkontona i Playvox för uppdateringsåtgärder. Om du väljer att ändra det matchande målattributet kontrollerar du att Playvox-API:et stöder filtrering av användare baserat på det attributet. Välj Spara för att checka in eventuella ändringar.

    Attribut Typ Stöds för filtrering
    userName String ✓
    aktiv Booleskt
    displayName String
    emails[type eq "work"].value String
    name.givenName String
    name.familyName String
    name.formatted String
    externalId String

  11. Information om hur du konfigurerar omfångsfilter finns i anvisningarna i självstudiekursen om omfångsfilter.

  12. Om du vill aktivera Microsoft Entra-etableringstjänsten för Playvox ändrar du etableringsstatusen till På i avsnittet Inställningar.

    Partiell skärmbild av avsnittet Inställningar som visar etableringsstatus inställd på På.

  13. I Inställningar definierar du de användare eller grupper som ska etableras till Playvox genom att välja de värden som du vill använda i Omfång.

    Partiell skärmbild av avsnittet Inställningar som visar listrutan Omfång.

  14. När du är redo att etablera väljer du Spara.

    Partiell skärmbild som visar alternativen Spara och Ignorera.

Å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 än senare cykler. Senare cykler inträffar ungefär var 40:e minut, förutsatt att Microsoft Entra-etableringstjänsten körs.

Steg 6: Övervaka distributionen

När du har konfigurerat etableringen använder du följande resurser för att övervaka distributionen:

  • Använd etableringsloggarna för att avgöra vilka användare som har etablerats eller 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. Mer information om karantäntillstånd finns i Programetablering i karantänstatus.

Ytterligare resurser

Nästa steg