Zelfstudie: Miro configureren voor automatische inrichting van gebruikers
Het doel van deze zelfstudie is om de stappen te laten zien die moeten worden uitgevoerd in Miro en Microsoft Entra ID om Microsoft Entra-id te configureren om gebruikers en/of groepen automatisch in te richten en de inrichting van gebruikers en/of groepen ongedaan te maken voor Miro.
Notitie
In deze zelfstudie wordt een connector beschreven die is gebouwd op de Microsoft Entra-service voor het inrichten van gebruikers. 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.
Vereisten
In het scenario dat in deze zelfstudie wordt beschreven, wordt ervan uitgegaan dat u al beschikt over de volgende vereisten:
- Een Microsoft Entra-tenant
- Een Miro-tenant
- Een gebruikersaccount in Miro met beheerdersmachtigingen.
Gebruikers toewijzen aan Miro
Microsoft Entra ID maakt gebruik van een concept met de naam toewijzingen om te bepalen welke gebruikers toegang moeten krijgen tot geselecteerde apps. In de context van automatische inrichting van gebruikers worden alleen de gebruikers en/of groepen die zijn toegewezen aan een toepassing in Microsoft Entra-id gesynchroniseerd.
Voordat u automatische inrichting van gebruikers configureert en inschakelt, moet u beslissen welke gebruikers en/of groepen in Microsoft Entra ID toegang nodig hebben tot Miro. Als u dit eenmaal hebt besloten, kunt u deze gebruikers en/of groepen aan Miro toewijzen door de instructies hier te volgen:
Belangrijke tips voor het toewijzen van gebruikers aan Miro
Het wordt aanbevolen om één Microsoft Entra-gebruiker toe te wijzen aan Miro om de configuratie van de automatische gebruikersinrichting te testen. Extra gebruikers en/of groepen kunnen later worden toegewezen.
Als u een gebruiker aan Miro toewijst, moet u een geldige toepassingsspecifieke rol (indien beschikbaar) selecteren in het toewijzingsdialoogvenster. Gebruikers met de rol Standaard toegang worden uitgesloten van het inrichten.
Miro instellen voor inrichting
Om het benodigde Token voor geheim op te halen, neemt u contact op met het ondersteuningsteam van Miro. Deze waarde wordt ingevoerd in het veld Token voor geheim op het tabblad Inrichten van uw Miro-toepassing.
Miro toevoegen vanuit de galerie
Voordat u Miro configureert voor automatische inrichting van gebruikers met Microsoft Entra ID, moet u Miro vanuit de Microsoft Entra-toepassingsgalerie toevoegen aan uw lijst met beheerde SaaS-toepassingen.
Voer de volgende stappen uit om Miro toe te voegen vanuit de Microsoft Entra-toepassingsgalerie:
- Meld u als cloudtoepassingsbeheerder aan bij het Microsoft Entra-beheercentrum.
- Blader naar Bedrijfstoepassingen voor identiteitstoepassingen>>>Nieuwe toepassing.
- Typ in de sectie Toevoegen uit de galerie Miro in het zoekvak.
- Selecteer Miro in het resultatenvenster en voeg vervolgens de app toe. Wacht enkele seconden tot de app aan de tenant is toegevoegd.
Automatische gebruikersinrichting voor Miro configureren
In deze sectie wordt u begeleid bij de stappen voor het configureren van de Microsoft Entra-inrichtingsservice om gebruikers en/of groepen in Miro te maken, bij te werken en uit te schakelen op basis van gebruikers- en/of groepstoewijzingen in Microsoft Entra-id.
Tip
U kunt er ook voor kiezen om eenmalige aanmelding op basis van SAML in te schakelen voor Miro, waarvoor u de instructies in de zelfstudie Eenmalige aanmelding voor Miro moet volgen. Eenmalige aanmelding kan onafhankelijk van automatische inrichting van gebruikers worden geconfigureerd, maar deze twee functies vormen een aanvulling op elkaar.
Notitie
Voor meer informatie over het SCIM-eindpunt van Miro kunt u hier terecht.
Automatische gebruikersinrichting configureren voor Miro in Microsoft Entra-id
Meld u als cloudtoepassingsbeheerder aan bij het Microsoft Entra-beheercentrum.
Bladeren naar Bedrijfstoepassingen voor identiteitstoepassingen>>
Selecteer Miro in de lijst met toepassingen.
Selecteer het tabblad Inrichten.
Stel Inrichtingsmodus in op Automatisch.
Voer onder de sectie Referenties voor beheerder
https://miro.com/api/v1/scimin Tenant-URL in. Voer de waarde van het SCIM-verificatietoken in die eerder in Token voor geheim is opgehaald. Klik op Verbinding testen om te controleren of Microsoft Entra ID verbinding kan maken met Miro. Als de verbinding mislukt, moet u controleren of uw Miro-account beheerdersmachtigingen heeft. Probeer het daarna opnieuw.
Voer in het veld E-mailadres voor meldingen het e-mailadres in van een persoon of groep die de inrichtingsfoutmeldingen zou moeten ontvangen en vink het vakje Een e-mailmelding verzenden als een fout optreedt aan.
Klik op Opslaan.
Selecteer in de sectie Toewijzingen Microsoft Entra-gebruikers synchroniseren met Miro.
Controleer in de sectie Kenmerktoewijzing de gebruikerskenmerken die vanuit Microsoft Entra-id met Miro worden gesynchroniseerd. De kenmerken die als overeenkomende eigenschappen zijn geselecteerd, worden gebruikt om de gebruikersaccounts in Miro te vinden voor updatebewerkingen. Selecteer de knop Opslaan om eventuele wijzigingen door te voeren.
Selecteer in de sectie Toewijzingen Microsoft Entra-groepen synchroniseren met Miro.
Controleer in de sectie Kenmerktoewijzing de groepskenmerken die vanuit Microsoft Entra-id met Miro worden gesynchroniseerd. De kenmerken die als overeenkomende eigenschappen zijn geselecteerd, worden gebruikt om de groepen in Miro te vinden voor updatebewerkingen. Selecteer de knop Opslaan om eventuele wijzigingen door te voeren. Schakel Maken en Verwijderen uit onder Acties voor het doelobject, aangezien de SCIM-API van Miro geen ondersteuning biedt voor het maken en verwijderen van groepen.
Als u bereikfilters wilt configureren, raadpleegt u de volgende instructies in de zelfstudie Bereikfilter.
Als u de Microsoft Entra-inrichtingsservice voor Miro wilt inschakelen, wijzigt u de inrichtingsstatus in Aan in de sectie Instellingen.
Definieer de gebruikers en/of groepen die u aan Miro wilt toevoegen door de gewenste waarden in Bereik in de sectie Instellingen te kiezen.
Wanneer u klaar bent om in te richten, klikt u op Opslaan.
Met deze bewerking wordt de eerste synchronisatie gestart van alle gebruikers en/of groepen die zijn gedefinieerd onder Bereik in de sectie Instellingen. De eerste synchronisatie duurt langer dan volgende synchronisaties, die ongeveer om de 40 minuten plaatsvinden zolang de Microsoft Entra-inrichtingsservice wordt uitgevoerd. U kunt de sectie Synchronisatiedetails gebruiken om de voortgang te controleren en koppelingen te volgen naar het activiteitenrapport van de inrichting, waarin alle acties worden beschreven die door de Microsoft Entra-inrichtingsservice op Miro worden uitgevoerd.
Zie Rapportage over automatische inrichting van gebruikersaccounts voor meer informatie over het lezen van de Microsoft Entra-inrichtingslogboeken.
Connectorbeperkingen
- Het SCIM-eindpunt van Miro staat het maken en verwijderen van groepen niet toe. Het biedt alleen ondersteuning voor bijwerken.
Tips voor probleemoplossing
Als er fouten optreden bij het maken van groepen, moet u deze uitschakelen door het selectievakje Maken en Verwijderen onder Doelobjectacties uit te schakelen, omdat Miro SCIM-API geen ondersteuning biedt voor het maken en verwijderen van groepen.
Aanvullende bronnen
- Gebruikersaccountinrichting voor zakelijke apps beheren
- Wat is toegang tot toepassingen en eenmalige aanmelding met Microsoft Entra ID?