Zelfstudie: Templafy OpenID Connect configureren voor automatische gebruikersinrichting
Het doel van deze zelfstudie is om de stappen te laten zien die moeten worden uitgevoerd in Templafy OpenID Connect 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 Templafy OpenID Connect.
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 Templafy-tenant.
- Een gebruikersaccount in Templafy met beheerdersmachtigingen.
Stap 1: De implementatie van uw inrichting plannen
- Lees hoe de inrichtingsservice werkt.
- Bepaal wie u wilt opnemen in het bereik voor inrichting.
- Bepaal welke gegevens moeten worden toegewezen tussen Microsoft Entra ID en Templafy OpenID Connect.
Gebruikers toewijzen aan Templafy OpenID Connect
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 Templafy OpenID Connect. Eenmaal besloten, kunt u deze gebruikers en/of groepen aan Templafy OpenID Connect toewijzen door de instructies hier te volgen:
Belangrijke tips voor het toewijzen van gebruikers aan Templafy OpenID Connect
Het wordt aanbevolen om één Microsoft Entra-gebruiker toe te wijzen aan Templafy OpenID Connect om de configuratie van de automatische gebruikersinrichting te testen. Meer gebruikers en/of groepen kunnen dan later nog worden toegewezen.
Als u een gebruiker aan Templafy OpenID Connect toewijst, moet u een geldige toepassingsspecifieke rol (indien beschikbaar) selecteren in het toewijzingsdialoogvenster. Gebruikers met de rol Standaard toegang worden uitgesloten van het inrichten.
Stap 2: Templafy OpenID Connect configureren ter ondersteuning van inrichting met Microsoft Entra-id
Voordat u Templafy OpenID Connect configureert voor automatische inrichting van gebruikers met Microsoft Entra ID, moet u SCIM-inrichting inschakelen op Templafy OpenID Connect.
Meld u aan bij de Templafy-beheerconsole. Klik op Beheer.
Klik op Verificatiemethode.
Kopieer de waarde van de SCIM API-sleutel. Deze waarde wordt ingevoerd in het veld Token voor geheim op het tabblad Inrichten van uw Templafy OpenID Connect-toepassing.
Stap 3: Templafy OpenID Connect toevoegen vanuit de galerie
Als u Templafy OpenID Connect wilt configureren voor automatische inrichting van gebruikers met Microsoft Entra ID, moet u Templafy OpenID Connect vanuit de Microsoft Entra-toepassingsgalerie toevoegen aan uw lijst met beheerde SaaS-toepassingen.
Voer de volgende stappen uit om Templafy OpenID Connect 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 Templafy OpenID Connect in de sectie Toevoegen uit de galerie, selecteer Templafy OpenID Connect in het zoekvak.
- Selecteer Templafy OpenID Connect in het resultatenvenster en voeg vervolgens de app toe. Wacht enkele seconden tot de app aan de tenant is toegevoegd.
Stap 4: Automatische gebruikersinrichting configureren voor Templafy OpenID Connect
In deze sectie wordt u begeleid bij de stappen voor het configureren van de Microsoft Entra-inrichtingsservice om gebruikers en/of groepen in Templafy OpenID Connect 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 OpenID Connect in te schakelen voor Templafy, waarvoor u de instructies in de zelfstudie Eenmalige aanmelding voor Templafy moet volgen. Eenmalige aanmelding kan onafhankelijk van automatische inrichting van gebruikers worden geconfigureerd, maar deze twee functies vormen een aanvulling op elkaar.
Automatische gebruikersinrichting configureren voor Templafy OpenID Connect in Microsoft Entra-id:
Meld u als cloudtoepassingsbeheerder aan bij het Microsoft Entra-beheercentrum.
Bladeren naar Bedrijfstoepassingen voor identiteitstoepassingen>>
Selecteer Templafy OpenID Connect in de lijst met toepassingen.
Selecteer het tabblad Inrichten.
Stel Inrichtingsmodus in op Automatisch.
Voer onder de sectie Referenties voor beheerder
https://scim.templafy.com/scimin Tenant-URL in. Voer de waarde van de SCIM-API-sleutel in die eerder in Token voor geheim is opgehaald. Klik op Verbinding testen om te controleren of de Microsoft Entra-id verbinding kan maken met Templafy. Als de verbinding mislukt, moet u controleren of uw Templafy-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 Templafy OpenID Connect.
Controleer in de sectie Kenmerktoewijzing de gebruikerskenmerken die vanuit Microsoft Entra-id met Templafy OpenID Connect worden gesynchroniseerd. De kenmerken die als overeenkomende eigenschappen zijn geselecteerd, worden gebruikt om de gebruikersaccounts in Templafy OpenID Connect te vinden voor updatebewerkingen. Selecteer de knop Opslaan om eventuele wijzigingen door te voeren.
Kenmerk Type Ondersteund voor filteren gebruikersnaam String ✓ actief Booleaanse waarde displayName String title String preferredLanguage String name.givenName String name.familyName String phoneNumbers[type eq "work"].value String phoneNumbers[type eq "mobile"].value String phoneNumbers[type eq "fax"].value String externalId String addresses[type eq "work"].locality String addresses[type eq "work"].postalCode String addresses[type eq "work"].region String addresses[type eq "work"].streetAddress String addresses[type eq "work"].country String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization String Notitie
De functie Schemadetectie is ingeschakeld voor deze toepassing.
Selecteer in de sectie Toewijzingen Microsoft Entra-groepen synchroniseren met Templafy.
Controleer in de sectie Kenmerktoewijzing de groepskenmerken die vanuit Microsoft Entra-id met Templafy OpenID Connect worden gesynchroniseerd. De kenmerken die als overeenkomende eigenschappen zijn geselecteerd, worden gebruikt om de groepen in Templafy OpenID Connect te vinden voor updatebewerkingen. Selecteer de knop Opslaan om eventuele wijzigingen door te voeren.
Kenmerk Type Ondersteund voor filteren displayName String ✓ leden Verwijzing externalId String Notitie
De functie Schemadetectie is ingeschakeld voor deze toepassing.
Als u bereikfilters wilt configureren, raadpleegt u de volgende instructies in de zelfstudie Bereikfilter.
Als u de Microsoft Entra-inrichtingsservice voor Templafy OpenID Connect wilt inschakelen, wijzigt u de inrichtingsstatus in Aan in de sectie Instellingen.
Definieer de gebruikers en/of groepen die u aan Templafy OpenID Connect wilt toevoegen door de gewenste waarden te kiezen in Bereik in de sectie Instellingen.
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 Templafy OpenID Connect worden uitgevoerd.
Stap 5: Uw implementatie bewaken
Nadat u het inrichten hebt geconfigureerd, gebruikt u de volgende resources om uw implementatie te bewaken:
- Gebruik de inrichtingslogboeken om te bepalen welke gebruikers al dan niet met succes zijn ingericht
- Controleer de voortgangsbalk om de status van de inrichtingscyclus weer te geven en te zien of deze al bijna is voltooid
- Als het configureren van de inrichting een foutieve status lijkt te hebben, wordt de toepassing in quarantaine geplaatst. Klik hier voor meer informatie over quarantainestatussen.
Wijzigingenlogboek
- 05/04/2023 - Ondersteuning toegevoegd voor Schema Discovery.
Meer resources
- Gebruikersaccountinrichting voor zakelijke apps beheren
- Wat is toegang tot toepassingen en eenmalige aanmelding met Microsoft Entra ID?