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:

  • En Microsoft Entra-klientorganisation.
  • Ett användarkonto i Microsoft Entra-ID med behörighet att konfigurera etablering. Ett konto kan till exempel ha rollen Programadministratör, Molnprogramadministratör, Programägare eller Global administratör.
  • Ett användarkonto i Playvox med superadministratörsbehörigheter.

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.

    Partial screenshot showing the location of the Create API Key button in the Playvox user interface.

  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 .

    Partial screenshot showing the location of the Details icon, which is a magnifying glass, in the Playvox user interface.

  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.

    Screenshot of the Details API Key message box, with the BASE64 KEY value highlighted.

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

    Partial screenshot of the Azure portal, with Enterprise applications and All applications items highlighted

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

    Partial screenshot of the applications list, with the application search box highlighted.

  4. Välj fliken Etablering.

    Partial screenshot showing the Provisioning menu item.

  5. Ange Etableringsläge som Automatiskt.

    Partial screenshot of the Provisioning tab, showing the Automatic option selected in the Provisioning Mode drop-down list box.

  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.

    Partial screenshot showing the Admin Credentials section, including Tenant URL and Secret Token text boxes, and with the Test Connection link highlighted.

  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 .

    Partial screenshot showing the Notification Email text box and the email notification check box.

  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 Type 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.

    Partial screenshot of Settings section, showing the Provisioning Status set to On.

  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.

    Partial screenshot of the Settings section, showing the Scope drop-down list box.

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

    Partial screenshot showing Save and Discard options.

Å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