OpenForms configureren voor automatische voorziening van gebruikers

In deze handleiding worden de stappen beschreven die u moet uitvoeren in zowel OpenForms als Microsoft Entra ID om automatische gebruikersvoorziening te configureren. Wanneer geconfigureerd, zorgt Microsoft Entra ID ervoor dat gebruikers en groepen automatisch worden ingericht en verwijderd naar OpenForms met behulp van de Microsoft Entra-provisioning service. Zie Automatiseren van gebruikersprovisioning en deprovisioning naar SaaS-toepassingen met Microsoft Entra IDvoor belangrijke informatie over wat deze service doet, hoe deze werkt en veelgestelde-vragen.

Ondersteunde mogelijkheden

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

Voorwaarden

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 van de volgende rollen: toepassingsbeheerder, cloudtoepassingsbeheerderof toepassingseigenaar.
• Een gebruikersaccount in OpenForms met machtigingen voor accounteigenaar.

Stap 1: Uw voorzieningsimplementatie plannen

1. Meer informatie over hoe de inrichtingsservice werkt.
2. Bepaal wie binnen het bereik van valt voor de voorzieningen van.
3. Bepaal welke gegevens u wilt toewijzen tussen Microsoft Entra ID en OpenForms.

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

Deze procedure wordt beschreven in het helpcentrum van OpenForms.

Stap 3: OpenForms toevoegen vanuit de Microsoft Entra-toepassingsgalerie

Voeg OpenForms toe vanuit de Microsoft Entra-applicatiegalerij om te beginnen met het implementeren naar OpenForms. Als u OpenForms eerder hebt ingesteld voor eenmalige aanmelding, 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 applicatie uit de galerij hier.

Stap 4: Definieer wie in aanmerking komt voor voorzieningen

Met de Microsoft Entra-inrichtingsservice kunt u bepalen wie wordt ingericht op basis van toewijzing aan de toepassing en of op basis van kenmerken van de gebruiker/groep. Als u ervoor kiest om te bepalen wie wordt ingericht voor uw app op basis van toewijzing, kunt u de volgende stappen gebruiken om gebruikers en groepen toe te wijzen aan de toepassing. Als u ervoor kiest om te bepalen wie alleen wordt ingericht op basis van kenmerken van de gebruiker of groep, kunt u een bereikfilter gebruiken zoals beschreven hier.

• 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 op attributen gebaseerd filter opgeven.

• Als u meer rollen nodig hebt, kunt u het toepassingsmanifest bijwerken om nieuwe rollen toe te voegen.

Stap 5: Configureer de automatische voorziening van gebruikers voor OpenForms

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.

Automatische gebruikersinrichting configureren voor OpenForms in Microsoft Entra ID:

1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een beheerder van cloudtoepassingen.

2. Blader naar Identity>toepassingen>enterprise-toepassingen

   

3. Selecteer OpenFormsin de lijst met toepassingen.

   

4. Selecteer het tabblad Inrichten.

   

5. Stel de inrichtingsmodus in op Automatisch.

   

6. Voer in de sectie Beheerdersgegevens uw OpenForms-tenant-URL en geheime token in. Klik op Verbinding testen om te controleren of Microsoft Entra ID verbinding kan maken met OpenForms. Als de verbinding mislukt, moet u controleren of uw OpenForms-account beheerdersmachtigingen heeft en probeer het opnieuw.

   

7. Voer in het veld Meldings-e-mail het e-mailadres in van een persoon of groep die de meldingen voor inrichtingsfouten moet ontvangen en schakel het selectievakje Een e-mailmelding verzenden in wanneer er een fout optreedt selectievakje.

   

8. Selecteer opslaan.

9. Selecteer onder de sectie Toewijzingen de optie Microsoft Entra-gebruikers synchroniseren met OpenForms.

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

    Attribuut	Type	Ondersteund voor filteren	Vereist door OpenForms
    userName	Snaar	✓	✓
    actief	Booleaans		✓
    emails[type eq "work"].value	Snaar
    naam.voornaam	Snaar		✓
    naam.achternaam	Snaar		✓
    externalId	Snaar		✓

11. Onder de sectie Toewijzingen, selecteer Synchronisatie van Microsoft Entra-groepen naar OpenForms.

12. Controleer in de sectie Kenmerktoewijzingen de groepskenmerken die vanuit Microsoft Entra-id met OpenForms worden gesynchroniseerd. De kenmerken die zijn geselecteerd als overeenkomende eigenschappen, worden gebruikt om de groepen in OpenForms te laten overeenkomen voor bijwerkingsoperaties. Selecteer de knop Opslaan om wijzigingen door te voeren.

    Attribuut	Type	Ondersteund voor filteren	Vereist door OpenForms
    weergavenaam	Snaar	✓	✓
    externalId	Snaar		✓
    leden	Referentie

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

14. Als u de Microsoft Entra-inrichtingsservice voor OpenForms wilt inschakelen, wijzigt u de Inrichtingsstatus in Op in de sectie Instellingen.

    

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

    

16. Wanneer u klaar bent om in te richten, klikt u op 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 bewaken

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

• Gebruik de inrichtingslogboeken om te bepalen welke gebruikers succesvol of onsuccesvol zijn ingericht.
• Controleer de voortgangsbalk om de status van de inrichtingscyclus te zien en hoe ver het is gevorderd naar voltooiing.
• Als de inrichtingsconfiguratie een slechte status lijkt te hebben, wordt de toepassing in quarantaine geplaatst. Meer informatie over quarantainestatussen hier.

Meer bronnen

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

Volgende stappen

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