Delen via


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.

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:

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassing Beheer istrator.
  2. Blader naar Bedrijfstoepassingen voor identiteitstoepassingen>>>Nieuwe toepassing.
  3. Typ in de sectie Toevoegen uit de galerie Miro in het zoekvak.
  4. 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

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassing Beheer istrator.

  2. Bladeren naar Bedrijfstoepassingen voor identiteitstoepassingen>>

    Enterprise applications blade

  3. Selecteer Miro in de lijst met toepassingen.

    The Miro link in the Applications list

  4. Selecteer het tabblad Inrichten.

    Screenshot of the Manage options with the Provisioning option called out.

  5. Stel Inrichtingsmodus in op Automatisch.

    Screenshot of the Provisioning Mode dropdown list with the Automatic option called out.

  6. Voer onder de sectie Referenties voor beheerder https://miro.com/api/v1/scim in Tenant-URL in. Voer de waarde van het SCIM-verificatietoken in die eerder in Token voor geheim is opgehaald. Klik op Test Verbinding maken ion 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.

    Tenant URL + Token

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

    Notification Email

  8. Klik op Opslaan.

  9. Selecteer in de sectie Toewijzingen Microsoft Entra-gebruikers synchroniseren met Miro.

    Miro User Mappings

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

    Miro User Attributes

  11. Selecteer in de sectie Toewijzingen Microsoft Entra-groepen synchroniseren met Miro.

    Miro Group Mappings

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

    Miro Group Attributes

  13. Als u bereikfilters wilt configureren, raadpleegt u de volgende instructies in de zelfstudie Bereikfilter.

  14. Als u de Microsoft Entra-inrichtingsservice voor Miro wilt inschakelen, wijzigt u de inrichtingsstatus in Aan in de sectie Instellingen.

    Provisioning Status Toggled On

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

    Provisioning Scope

  16. Wanneer u klaar bent om in te richten, klikt u op Opslaan.

    Saving Provisioning Configuration

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.

    Miro Group Tips

Aanvullende bronnen

Volgende stappen