Het configureren van Swit voor automatische gebruikersvoorziening met Microsoft Entra ID

In dit artikel worden de stappen beschreven die u moet uitvoeren in zowel Swit als Microsoft Entra ID om gebruikersprovisioning te configureren. Wanneer geconfigureerd, provisioneert en deprovisioneert Microsoft Entra ID automatisch gebruikers en groepen naar Swit met behulp van de Microsoft Entra-voorzieningsservice. Voor belangrijke informatie over wat deze service doet, hoe deze werkt en antwoorden op veelgestelde vragen, kijk bij Automatiseren van gebruikersprovisioning en deprovisioning naar SaaS-toepassingen met Microsoft Entra ID.

Ondersteunde mogelijkheden

  • Maak gebruikers aan in Swit.
  • Verwijder gebruikers in Swit wanneer ze geen toegang meer nodig hebben.
  • Gebruikerskenmerken gesynchroniseerd houden tussen Microsoft Entra ID en Swit.
  • Groepen en groepslidmaatschappen inrichten in Swit.

Vereiste voorwaarden

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

Stap 1: Plan uw implementatie van voorzieningen

  1. Kom meer te weten over hoe de inrichtingsservice werkt.
  2. Bepaal wie binnen de scope voor provisioning valt.
  3. Bepaal welke gegevens in kaart moeten worden gebracht tussen Microsoft Entra ID en Swit.

Stap 2: Swit configureren om voorziening met Microsoft Entra ID te ondersteunen

Als u Swit wilt configureren ter ondersteuning van inrichting met Microsoft Entra-id, stuurt u een e-mail naar help@swit.io.

Voeg Swit toe vanuit de Microsoft Entra-toepassingsgalerie om te beginnen met het inrichten voor Swit. Als u Swit eerder hebt ingesteld voor eenmalige aanmelding (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 toe te wijzen aan de app. 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: Automatische gebruikersinrichting configureren voor Swit

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

Automatische gebruikersvoorziening configureren voor Swit in Microsoft Entra ID

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

  2. Navigeer naar Entra ID>Enterprise-apps

    Schermopname van het tabblad Enterprise-applicaties.

  3. Selecteer Swit in de lijst met toepassingen.

    Schermopname van de koppeling Swit in de lijst met toepassingen.

  4. Selecteer het tabblad Inrichten .

    Schermopname van de mogelijkheden onder Beheren, met de optie Inrichten aangegeven.

  5. Selecteer + Nieuwe configuratie.

    Schermopname van de optie Nieuwe configuratie op de pagina Inrichten.

  6. Selecteer Autoriseren in de sectie Beheerdersreferenties , zorg ervoor dat u de beheerdersreferenties van uw Swit-account invoert. Selecteer Verbinding testen om te controleren of de Microsoft Entra-id verbinding kan maken met Swit. Als de verbinding mislukt, moet u controleren of uw Swit-account beheerdersmachtigingen heeft en probeer het opnieuw.

    Schermopname van het dialoogvenster Swit-autorisatietoken.

  7. Selecteer Maken om uw configuratie te maken.

  8. Selecteer Eigenschappen op de pagina Overzicht .

  9. Selecteer het pictogram Bewerken om de eigenschappen te bewerken. Schakel e-mailberichten voor meldingen in en geef een e-mailbericht op om quarantainemeldingen te ontvangen. Schakel preventie van onbedoelde verwijderingen in. Selecteer Toepassen om de wijzigingen op te slaan.

    Schermopname van de pagina Inrichtingseigenschappen.

  10. Selecteer Kenmerktoewijzing in het linkerdeelvenster en selecteer gebruikers.

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

    Kenmerk Typ Ondersteund voor filteren Vereist door Swit
    gebruikersnaam Touwtje ✓ ✓
    actief Booleaan ✓
    telefoonnummers[type gelijk aan "mobiel"].waarde Touwtje
    telefoonNummers[type gelijk aan "werk"].waarde Touwtje
    weergavenaam Touwtje ✓
    externId Touwtje ✓
    voorkeurstaal Touwtje

  12. Selecteer Groepen.

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

    Kenmerk Typ Ondersteund voor filteren Vereist door Swit
    weergavenaam Touwtje ✓ ✓
    externId Touwtje ✓
    leden Referentie

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

  15. Gebruik inrichting op aanvraag om synchronisatie met een paar gebruikers te valideren voordat u de implementatie breder in uw organisatie implementeert.

  16. Wanneer u klaar bent om in te richten, selecteert u Inrichten starten op de pagina Overzicht .

Stap 6: Uw implementatie bewaken

Zodra u de inrichting hebt geconfigureerd, gebruikt u de volgende resources om uw implementatie te bewaken:

  1. Gebruik de inrichtingslogboeken om te bepalen of gebruikers succesvol zijn ingericht of niet.
  2. Controleer de voortgangsbalk om de status van de inrichtingscyclus te bekijken en hoe dicht deze bij voltooiing is.
  3. Als de implementatieconfiguratie in een ongezonde staat lijkt te verkeren, wordt de toepassing in quarantaine geplaatst. Meer informatie over quarantainestatussen in het artikel over het inrichten van quarantainestatussen van toepassingen.

Meer middelen

Verwante inhoud

  • Last updated on