TerraTrue configureren voor automatische gebruikersvoorziening met Microsoft Entra ID

In dit artikel worden de stappen beschreven die u moet uitvoeren in zowel TerraTrue als in Microsoft Entra ID voor het configureren van automatische gebruikersvoorziening. Wanneer geconfigureerd is, voorziet en deprovisioneert Microsoft Entra ID automatisch gebruikers en groepen voor TerraTrue via de Microsoft Entra-inrichtingsservice. Zie Automate gebruikersvoorziening en -onttrekking naar SaaS-toepassingen met Microsoft Entra ID voor belangrijke informatie over wat deze service doet, hoe het werkt, en beantwoordt veelgestelde vragen.

Ondersteunde mogelijkheden

Benodigdheden

In het scenario dat in dit artikel 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 TerraTrue-tenant.
• Een gebruikersaccount in TerraTrue met beheerdersmachtigingen.

Stap 1: Plan uw implementatie van voorzieningen

1. Leer meer over hoe de provisioningdienst werkt.
2. Bepaal wie binnen de reikwijdte van valt voor het inrichten van.
3. Bepaal welke gegevens je moet koppelen tussen Microsoft Entra ID en TerraTrue.

Stap 2: TerraTrue configureren ter ondersteuning van inrichting met Microsoft Entra ID

1. Navigeer in TerraTrue naar Organization Settings > Authentication > SCIM of ga naar https://launch.terratrue.com/settings/auth/scim.

2. Schakel vervolgens de SCIM-configuratie-wisselknop in en selecteer "Kopieer API-sleutel" om de SCIM API-sleutel te kopiëren.

   

Stap 3: TerraTrue toevoegen vanuit de Microsoft Entra toepassingsgalerie

Voeg TerraTrue toe vanuit de Microsoft Entra applicatiegalerij om te beginnen met het beheren van provisioning naar TerraTrue. Als u TerraTrue eerder hebt ingesteld voor Single Sign-On, kunt u dezelfde applicatie gebruiken. We raden u echter aan om een afzonderlijke app te maken bij het testen van de integratie in eerste instantie. Klik hier voor meer informatie over het toevoegen van een toepassing uit de galerie.

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

• 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 kenmerken opgeven.

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

Stap 5: Automatische gebruikersinrichting configureren voor TerraTrue

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

Automatische gebruikersinrichting configureren voor TerraTrue in Microsoft Entra ID

1. Meld u aan bij de Microsoft Entra-beheercentrum als ten minste een Cloud-toepassingsbeheerder.

2. Blader naar Entra ID>Enterprise apps

   

3. Selecteer TerraTrue in de lijst met toepassingen.

   

4. Selecteer het tabblad Inrichten.

   

5. Selecteer + Nieuwe configuratie.

   

6. Voer in het veld Tenant-URL uw TerraTrue-tenant-URL en geheimtoken in. Selecteer Test Connection om ervoor te zorgen dat Microsoft Entra ID verbinding kan maken met TerraTrue. Als de verbinding mislukt, controleert u of uw TerraTrue-account over de vereiste beheerdersmachtigingen beschikt en probeer het opnieuw.

   

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.

   

10. Selecteer Kenmerktoewijzing in het linkerdeelvenster en selecteer gebruikers.

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

    Kenmerk	Typ	Ondersteund voor filteren	Vereist door TerraTrue
    gebruikersnaam	Draad	✓	✓
    actief	Booleaan
    naam.gegevenNaam	Draad
    naam.familienaam	Draad
    naam.geformatteerd	Draad

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

13. Gebruik inrichting op aanvraag om synchronisatie te valideren met een klein aantal gebruikers voordat u een grotere implementatie in uw organisatie implementeert.

14. 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 welke gebruikers succesvol of onsuccesvol zijn ingericht.
2. Controleer de voortgangsbalk om de status van de provisioningcyclus te zien en hoe dicht het bij voltooiing is.
3. Als de configuratie in een ongezonde staat lijkt te verkeren, gaat de toepassing in quarantaine. Vind meer informatie over de quarantainestatussen in het artikel over de quarantainestatus van de toepassing.

Troubleshooting and Tips (Engelstalig)

Neem contact op met hello@terratrue.com voor hulp om ervoor te zorgen dat uw voorziening correct werkt.

TerraTrue biedt via de onderstaande koppeling een revisiegeschiedenis van alle wijzigingen in het account van een gebruiker die zichtbaar is voor een TerraTrue-beheerder. Alle gebruikerswijzigingen die zijn aangebracht als gevolg van SCIM-inrichting, worden weergegeven met de kolom Actor als 'Scim System User'.

https://launch.terratrue.com/settings/history

Ten slotte stelt TerraTrue de weergavenaam van de gebruiker in op basis van de voornaam en achternaam die tijdens de eerste gebruikerssynchronisatie zijn ontvangen. Volgende wijzigingen in de weergavenaam van de gebruiker kunnen via de onderstaande koppeling door een beheerder vanuit TerraTrue worden aangebracht onder de instellingen van de gebruikersorganisatie:

https://launch.terratrue.com/settings/users

Meer middelen

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

Verwante inhoud

• Meer informatie over het controleren van logboeken en het ophalen van rapporten over de inrichtingsactiviteit