Självstudie: Konfigurera SchoolStream ASA för automatisk användaretablering i SchoolStream ASA

I den här självstudien beskrivs de steg du behöver utföra i både SchoolStream ASA 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 SchoolStream ASA 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 SchoolStream ASA
• Ta bort användare i SchoolStream ASA när de inte längre behöver åtkomst.
• Behåll användarattribut synkroniserade mellan Microsoft Entra ID och SchoolStream ASA.
• Etablera grupper och gruppmedlemskap i SchoolStream ASA.
• Enkel inloggning till SchoolStream ASA (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
• En av följande roller: Programadministratör, Molnprogramadministratör eller Programägare.
• En SchoolStream-webbplats. Kontakta SchoolStream-supporten om du inte har någon.

Steg 1: Planera etableringsdistributionen

1. Lär dig mer om 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 SchoolStream ASA.

Steg 2: Konfigurera SchoolStream ASA för att stödja etablering med Microsoft Entra-ID

1. Kontakta SchoolStream-supporten för att begära SchoolStream ASA-integrering. Du måste ange ditt Klient-ID för Microsoft Entra och webbadressen till SchoolStream-webbplatsen.

2. Du får din hemliga token och SCHOOLStream ASA-klient-URL efter att SchoolStream har mappat din SchoolStream-webbplats och Microsoft Entra-klient-ID.

Steg 3: Lägg till SchoolStream ASA från Microsoft Entra-programgalleriet

Om du vill börja hantera etablering till SchoolStream ASA i ditt Microsoft Entra-ID måste du lägga till SchoolStream ASA från Microsoft Entra-programgalleriet.

1. Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.
2. Bläddra till Identity>Applications Enterprise-program>>Nytt program.
3. I avsnittet Bläddra i Microsoft Entra-galleriet skriver du SchoolStream ASA i sökrutan.
4. Välj SchoolStream ASA från resultatpanelen och sedan Registrera dig för appen. Vänta några sekunder medan appen läggs till i din klientorganisation.

Om du tidigare har konfigurerat SchoolStream ASA 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 SchoolStream ASA

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

Så här konfigurerar du automatisk användaretablering för SchoolStream ASA 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>

   

3. I programlistan väljer du SchoolStream ASA.

   

4. Välj fliken Etablering.

   

5. Om du konfigurerar etablering för första gången väljer du Kom igång.

6. Ange Etableringsläge som Automatiskt.

   

7. I avsnittet Administratörsautentiseringsuppgifter anger du din SCHOOLStream ASA-klient-URL och hemliga token. Klicka på Testa anslutning för att se till att Microsoft Entra ID kan ansluta till SchoolStream ASA. Om anslutningen misslyckas kontrollerar du att ditt SchoolStream ASA-konto har administratörsbehörighet och försöker igen.

   

8. Välj Spara för att se avsnittet Inställningar .

9. I fältet E-postavisering i Inställningar anger du e-postadressen till en person eller grupp som ska få meddelanden om etableringsfel och markerar kryssrutan Skicka ett e-postmeddelande när ett fel inträffar.

   

10. I avsnittet Mappningar väljer du Etablera Microsoft Entra-användare.

11. Välj Lägg till ny mappning längst ned.

12. I dialogrutan Redigera attribut:

    • I fältet Mappningstyp väljer du Direkt i listrutan.

    • I fältet Källattribut väljer du extensionAttribute1 i listrutan.

    • Ange ditt Microsoft Entra-klient-ID i fältet Standardvärde om null(valfritt),

    • I fältet Målattribut väljer du urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization i listrutan.

    • I fältet Matcha objekt med det här attributet väljer du Nej i listrutan.

    • I fältet Tillämpa den här mappningen väljer du Alltid i listrutan.

    • Välj OK.

      

13. Granska de användarattribut som synkroniseras från Microsoft Entra-ID till SchoolStream ASA i avsnittet Attributmappning . De attribut som valts som Matchande egenskaper används för att matcha användarkontona i SchoolStream ASA för uppdateringsåtgärder. Om du väljer att ändra det matchande målattributet måste du se till att SchoolStream ASA API stöder filtrering av användare baserat på det attributet.

    Attribut	Typ	Stöds för filtrering
    userName	String	✓
    aktiv	Booleskt
    displayName	String
    emails[type eq "work"].value	String
    preferredLanguage	String
    name.givenName	String
    name.familyName	String
    name.formatted	String
    phoneNumbers[type eq "mobile"].value	String
    externalId	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization	String

14. Under avsnittet Mappningar väljer du Synkronisera Microsoft Entra-grupper till UNIFI.

15. Granska gruppattributen som synkroniseras från Microsoft Entra-ID till UNIFI i avsnittet Attributmappning . Attributen som valts som Matchande egenskaper används för att matcha grupperna i UNIFI för uppdateringsåtgärder. Välj knappen Spara för att checka in eventuella ändringar.

    Attribut	Typ	Stöds för filtrering
    displayName	String	✓
    medlemmar	Referens
    externalId	String

16. Välj knappen Spara för att checka in eventuella ändringar. Du kan gå tillbaka till fliken Program och välja Redigera etablering för att fortsätta.

17. Information om hur du konfigurerar omfångsfilter finns i följande instruktioner i självstudien för omfångsfilter.

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

    

19. Definiera de användare och/eller grupper som du vill etablera till SchoolStream ASA genom att välja önskade värden i Omfång i avsnittet Inställningar .

    

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

Ändringslogg

• 2020-09-24 – Gruppetablering har aktiverats.

Fler resurser

• Hantera användarkontoetablering för Enterprise-appar
• Vad är programåtkomst och enkel inloggning med Microsoft Entra-ID?

Nästa steg

• Lär dig att granska loggar och hämta rapporter om etableringsaktivitet