SchoolStream ASA configureren voor automatische toewijzing van gebruikers met Microsoft Entra ID

In dit artikel vindt u de stappen die u moet uitvoeren in zowel SchoolStream ASA als Microsoft Entra ID voor het configureren van automatische voorziening van gebruikers. Wanneer geconfigureerd, voorziet en deprovisioneert Microsoft Entra ID automatisch gebruikers en groepen via de Microsoft Entra-inrichtingsservice aan SchoolStream ASA. Voor belangrijke informatie over wat deze service doet, hoe deze werkt en veelgestelde vragen, raadpleegt u Automate user provisioning and deprovisioning to SaaS applications with Microsoft Entra ID.

Ondersteunde mogelijkheden

• Gebruikers maken in SchoolStream ASA
• Verwijder gebruikers in SchoolStream ASA wanneer ze geen toegang meer nodig hebben.
• Gebruikerskenmerken gesynchroniseerd houden tussen Microsoft Entra ID en SchoolStream ASA.
• Groepen en groepslidmaatschappen inrichten in SchoolStream ASA.
• Eenmalige aanmelding bij SchoolStream ASA (aanbevolen).

Vereisten

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

• Een Microsoft Entra-gebruikersaccount met een actief abonnement. Als u nog geen account hebt, kunt u gratis een account maken.
• Een van de volgende rollen:
  • Toepassingsbeheerder
  • Cloudtoepassingsbeheerder
  • Toepassingseigenaar.

• Een SchoolStream-website. Neem contact op met de ondersteuning van SchoolStream als u er geen hebt.

Stap 1: Plan uw voorzieningsimplementatie

1. Meer informatie over hoe de inrichtingsservice werkt.
2. Bepalen wie binnen de scope voor provisioning valt.
3. Bepaal welke gegevens je tussen Microsoft Entra ID en SchoolStream ASA moet koppelen.

Stap 2: SchoolStream ASA configureren ter ondersteuning van inrichting met Microsoft Entra-id

1. Neem contact op met de ondersteuning van SchoolStream om SchoolStream ASA-integratie aan te vragen. U moet uw Microsoft Entra-tenant-id en de URL van uw SchoolStream-website opgeven.

2. U krijgt uw Geheime token en SchoolStream ASA-tenant-URL nadat SchoolStream uw SchoolStream-website en de tenant-ID van Microsoft Entra heeft gemapt.

Stap 3: SchoolStream ASA toevoegen vanuit de Microsoft Entra-toepassingsgalerie

Als u wilt beginnen met het inrichten voor SchoolStream ASA in uw Microsoft Entra-id, moet u SchoolStream ASA toevoegen vanuit de Microsoft Entra-toepassingsgalerie.

1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een Cloudtoepassingsbeheerder.
2. Blader naar Entra ID>Enterprise-apps>Nieuwe toepassing.
3. Typ SchoolStream ASA in het zoekvak in het gedeelte Browse Microsoft Entra Gallery.
4. Selecteer SchoolStream ASA in het resultatenvenster en meld u vervolgens aan voor de app. Wacht enkele seconden tot de app aan de tenant is toegevoegd.

Als u SchoolStream ASA eerder hebt geconfigureerd voor Single Sign-On (SSO), 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 aan de app toe te wijzen. 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: Automatisch gebruikersvoorziening configureren voor SchoolStream ASA

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

Om automatische gebruikersvoorziening voor SchoolStream ASA in Microsoft Entra ID te configureren:

1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een Cloudtoepassingsbeheerder.

2. Bladeren naar Entra ID>Enterprise apps

   

3. Selecteer SchoolStream ASA in de lijst met toepassingen.

   

4. Selecteer het tabblad Inrichten .

   

5. Als u de inrichting voor de eerste keer configureert, selecteert u Aan de slag.

6. Stel de inrichtingsmodus in op Automatisch.

   

7. Voer in de sectie Referenties voor beheerder de URL van de SchoolStream ASA-tenant en het token voor geheim in. Selecteer Verbinding testen om te controleren of de Microsoft Entra-id verbinding kan maken met SchoolStream ASA. Als de verbinding mislukt, moet u controleren of uw SchoolStream ASA-account beheerdersmachtigingen heeft en probeer het opnieuw.

   

8. Selecteer Opslaan om de sectie Instellingen weer te geven.

9. Voer in het veld E-mailmelding van de sectie Instellingen het e-mailadres in van een persoon of groep die de meldingen over inrichtingsfouten moet ontvangen en schakel het selectievakje Een e-mailmelding verzenden in wanneer er een fout optreedt .

   

10. In de sectie Toewijzingen, selecteer Microsoft Entra-gebruikers inrichten.

11. Selecteer onderaan Nieuwe toewijzing toevoegen.

12. In het dialoogvenster Kenmerk bewerken:

    • Selecteer in het veld Toewijzingstype de optie Direct uit de vervolgkeuzelijst.

    • Selecteer in het veld BronkenmerkextensionAttribute1 in de vervolgkeuzelijst.

    • Voer uw Microsoft Entra-tenant-id in het veld Standaardwaarde in als null(optioneel),

    • Selecteer in het veld Doelkenmerkurn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization in de vervolgkeuzelijst,

    • Selecteer in het veld Objecten koppelen met dit kenmerkNee uit de vervolgkeuzelijst.

    • Selecteer in het veld Deze toewijzing toepassenAltijd uit de vervolgkeuzelijst.

    • Klik op OK.

      

13. Controleer in de sectie Kenmerktoewijzing de gebruikerskenmerken die vanuit Microsoft Entra-id met SchoolStream ASA worden gesynchroniseerd. De kenmerken die als overeenkomende eigenschappen zijn geselecteerd, worden gebruikt om de gebruikersaccounts in SchoolStream ASA te vinden voor updatebewerkingen. Als u ervoor kiest om het overeenkomende doelkenmerk te wijzigen, moet u ervoor zorgen dat de SchoolStream ASA-API het filteren van gebruikers op basis van dat kenmerk ondersteunt.

    Kenmerk	Soort	Ondersteund voor filteren
    gebruikersnaam	Snaar / Touwtje	✓
    actief	Booleaans
    weergavenaam	Snaar / Touwtje
    emails[type gelijk aan "work"].waarde	Snaar / Touwtje
    Voorkeurstaal	Snaar / Touwtje
    naam.gegevenNaam	Snaar / Touwtje
    naam.familienaam	Snaar / Touwtje
    naam.geformatteerd	Snaar / Touwtje
    telefoonnummers[type eq "mobiel"].waarde	Snaar / Touwtje
    externId	Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:Organization	Snaar / Touwtje

14. Selecteer in de sectie Toewijzingende optie Microsoft Entra-groepen synchroniseren met UNIFI.

15. Controleer in de sectie Kenmerktoewijzing de groepskenmerken die vanuit Microsoft Entra-id met UNIFI worden gesynchroniseerd. De kenmerken die als overeenkomende eigenschappen zijn geselecteerd, worden gebruikt om de groepen in UNIFI te vinden voor updatebewerkingen. Selecteer de knop Opslaan om wijzigingen door te voeren.

    Kenmerk	Soort	Ondersteund voor filteren
    weergavenaam	Snaar / Touwtje	✓
    leden	Verwijzing
    externId	Snaar / Touwtje

16. Selecteer de knop Opslaan om wijzigingen door te voeren. U kunt teruggaan naar het tabblad Toepassing en inrichting bewerken selecteren om door te gaan.

17. Als u bereikfilters wilt configureren, raadpleegt u de volgende instructies in het artikel Bereikfilter.

18. Als u de Microsoft Entra-inrichtingsservice voor SchoolStream ASA wilt inschakelen, wijzigt u de inrichtingsstatus in Aan in de sectie Instellingen .

    

19. Definieer de gebruikers en/of groepen die u aan SchoolStream ASA wilt toevoegen door de gewenste waarden te kiezen in Bereik in de sectie Instellingen .

    

20. Wanneer u klaar bent om in te richten, selecteert u Opslaan.

    

Met deze bewerking wordt de eerste synchronisatiecyclus gestart van alle gebruikers en groepen die zijn gedefinieerd in Bereik in de sectie Instellingen . De eerste cyclus duurt langer dan volgende cycli, die ongeveer om de 40 minuten plaatsvinden zolang de Microsoft Entra-inrichtingsservice wordt uitgevoerd.

Stap 6: Uw implementatie controleren

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 met succes of mislukt worden ingericht
2. Controleer de voortgangsbalk om de status van de inrichtingscyclus te bekijken en te zien hoe dicht het bij voltooiing is.
3. Als de configuratie in een ongezonde staat lijkt te verkeren, gaat de toepassing in quarantaine. Meer informatie over quarantainestatussen in het artikel over het inrichten van quarantainestatussen van toepassingen.

Wijzigingenlogboek

• 24-09-2020 - Groepsvoorziening is ingeschakeld.

Meer bronnen

• Het inrichten van gebruikersaccounts voor Enterprise Apps beheren
• Wat is toegang tot toepassingen en eenmalige aanmelding met Microsoft Entra ID?

Verwante inhoud

• Meer informatie over het controleren van logboeken en het ophalen van rapporten over inrichtingsactiviteiten