Delen via

Oneflow configureren voor automatische gebruikersvoorziening met Microsoft Entra-ID

In dit artikel worden de stappen beschreven die u moet uitvoeren in zowel Oneflow als Microsoft Entra ID voor het configureren van automatische gebruikersprovisioning. Wanneer geconfigureerd, richt Microsoft Entra ID gebruikers en groepen automatisch in en verwijdert ze voor Oneflow, gebruikmakend van de Microsoft Entra-inrichtingsservice. 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 Oneflow.
  • Verwijder gebruikers in Oneflow wanneer ze geen toegang meer nodig hebben.
  • Gebruikerskenmerken gesynchroniseerd houden tussen Microsoft Entra ID en Oneflow.
  • Groepen en groepslidmaatschappen inrichten in Oneflow.
  • Eenmalige aanmelding bij Oneflow (aanbevolen).

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 voor voorzieningen

  1. Meer informatie over hoe de inrichtingsservice werkt.
  2. Bepaal wie in aanmerking komt voor voorzieningen.
  3. Bepaal welke gegevens moeten worden toegewezen tussen Microsoft Entra ID en Oneflow.

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

Gebruik de volgende informatie voor stap 5-6.

  • URL van huurder: https://api.oneflow.com/scim/v1/

  • Geheim token: het oneflow SCIM-token fungeert als het geheime token bij de provisioning. Volg de stappen in dit artikel voor het genereren van een SCIM-token voor Oneflow.

Voeg Oneflow toe vanuit de Microsoft Entra-toepasselingalerij om provisioning naar Oneflow te beheren. Als u Oneflow eerder hebt ingesteld voor SSO, kunt u dezelfde toepassing gebruiken. Het is echter raadzaam 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 met een kleine set gebruikers en groepen voordat ze voor iedereen worden uitgerold. 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: Configureer automatische gebruikersvoorziening naar Oneflow

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

Om automatische gebruikersinrichting voor Oneflow in Microsoft Entra ID te configureren:

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

  2. Navigeer naar Entra ID>Enterprise-apps

    Schermopname van de blade Bedrijfstoepassingen.

  3. Selecteer Oneflow in de lijst met toepassingen.

    Schermopname van de oneflow-koppeling in de lijst met toepassingen.

  4. Selecteer het tabblad Inrichten .

    Schermopname van het tabblad Inrichten.

  5. Stel de inrichtingsmodus in op Automatisch.

    Schermopname van het tabblad Inrichten automatisch.

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

    Schermafbeelding van Token.

  7. Voer in het veld E-mailmelding 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 .

    Schermopname van e-mailmelding.

  8. Selecteer opslaan.

  9. Selecteer in de sectie MappingsSynchroniseer Microsoft Entra-gebruikers naar Oneflow.

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

    Attribuut Soort Ondersteund voor filteren Vereist voor Oneflow
    gebruikersnaam Draad ✓ ✓
    actief Booleaans ✓
    externId Draad
    emails[type eq "werk"].value Draad
    naam.voornaam Draad
    naam.familienaam Draad
    telefoonNummers[type gelijk aan "werk"].waarde Draad
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:afdeling Draad
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber (werknemernummer) Draad
    bijnaam Draad
    titel Draad
    profielURL Draad
    weergavenaam Draad
    adressen[type gelijk aan "werk"].straatadres Draad
    adressen[type eq "werk"].lokaliteit Draad
    addressen[type gelijk aan "werk"].regio Draad
    addresses[type eq "werk"].postalCode Draad
    adressen[type eq "work"].land Draad
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:kostenplaats Draad
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:afdeling Draad
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:Organization Draad
    urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:adSourceAnchor Draad
    urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:customAttribute1 Draad
    urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:customAttribute2 Draad
    urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:customAttribute3 Draad
    urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:customAttribute4 Draad
    urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:customAttribute5 Draad
    urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:distinguishedName Draad
    urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:domain Draad
    urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:userPrincipalName Draad

  11. In de sectie Toewijzingen, selecteert u Microsoft Entra-groepen synchroniseren met Oneflow.

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

    Attribuut Soort Ondersteund voor filteren Vereist voor Oneflow
    weergavenaam Draad ✓ ✓
    externId Draad ✓ ✓
    leden Referentie

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

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

    Schermopname van inschakelen van de provisioningstatus.

  15. Definieer de gebruikers en/of groepen die u wilt inrichten voor Oneflow door de gewenste waarden te kiezen in Bereik in de sectie Instellingen .

    Schermopname van Provisioning Scope.

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

    Schermopname van het opslaan van de inrichtingsconfiguratie.

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 bewaken

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 ver deze is gevorderd richting voltooiing.
  3. Als de inrichtingsconfiguratie een slechte status lijkt te hebben, wordt de toepassing in quarantaine geplaatst. Meer informatie over quarantainestatussen in het artikel over het inrichten van quarantainestatussen van toepassingen.

Meer middelen

Verwante inhoud