Konfigurera TerraTrue för automatisk användaretablering med Microsoft Entra ID

I den här artikeln beskrivs de steg som du behöver utföra i både TerraTrue och Microsoft Entra ID för att konfigurera automatisk användaretablering. När den är konfigurerad tilldelar och återkallar Microsoft Entra ID automatiskt användare och grupper till TerraTrue med hjälp av Microsoft Entra tilldelningstjänsten. Viktig information om vad den här tjänsten gör, hur den fungerar och vanliga frågor finns i Automatisk användaretablering och avetablering till SaaS-program med Microsoft Entra ID.

Funktioner som stöds

  • Skapa användare i TerraTrue.
  • Ta bort användare i TerraTrue när de inte längre behöver åtkomst.
  • Behåll användarattribut synkroniserade mellan Microsoft Entra ID och TerraTrue.
  • Enkel inloggning till TerraTrue.
  • Autentisering med långvarig bärartoken stöds.

Förutsättningar

Scenariot som beskrivs i den här artikeln förutsätter att du redan har följande förutsättningar:

Steg 1: Planera resurstilldelningen

  1. Lär dig mer om hur provisioneringstjänsten fungerar.
  2. Ta reda på vem som är inom :s område för försörjning av.
  3. Bestäm vilka data som ska mappas mellan Microsoft Entra ID och TerraTrue.

Steg 2: Konfigurera TerraTrue för att stödja etablering med Microsoft Entra ID

  1. I TerraTrue går du till Organisationsinställningar > autentisering > SCIM- eller besöker https://launch.terratrue.com/settings/auth/scim.

  2. Aktivera sedan växlingsknappen "SCIM-konfiguration" och välj "Kopiera API-nyckel" för att kopiera SCIM API-nyckeln.

    Skärmbild av Generera token.

Lägg till TerraTrue från programgalleriet i Microsoft Entra för att börja hantera provisionering till TerraTrue. Om du tidigare har konfigurerat TerraTrue för enkel inloggning kan du använda samma program. Vi rekommenderar dock att du skapar en separat app när du testar integreringen från början. Läs mer om att lägga till ett program från galleriet här.

Steg 4: Definiera vilka som omfattas av provisioner

Med Microsoft Entra etableringstjänst kan du omfångsbegränsa vem som etableras baserat på tilldelning till programmet, eller baserat på attribut för användaren eller gruppen. Om du väljer att avgränsa vem som får åtkomst till din app baserat på tilldelning kan du använda stegen för att tilldela användare och grupper till applikationen. Om du väljer att bestämma vem som försörjs enbart baserat på användarens eller gruppens attribut kan du använda ett omfångsfilter.

  • Börja litet. Testa med en liten uppsättning användare och grupper innan du distribuerar till alla. När omfånget för etablering är inställt på tilldelade användare och grupper kan du styra detta genom att tilldela en eller två användare eller grupper till appen. När omfånget är inställt på alla användare och grupper kan du ange ett attributbaserat omfångsfilter.

  • Om du behöver extra roller kan du uppdatera programmanifestet för att lägga till nya roller.

Steg 5: Konfigurera automatisk användaretablering till TerraTrue

Det här avsnittet vägleder dig genom stegen för att konfigurera Microsoft Entra etableringstjänsten för att skapa, uppdatera och inaktivera användare och/eller grupper i TerraTrue baserat på användar- och/eller grupptilldelningar i Microsoft Entra ID.

Konfigurera automatisk användaretablering för TerraTrue i Microsoft Entra ID

  1. Logga in på Microsoft Entra administrationscenter som minst en Cloud-programadministratör.

  2. Bläddra till Entra ID>Enterprise-appar

    Skärmbild av Företagsapplikationer-fliken.

  3. I programlistan väljer du TerraTrue.

    Skärmbild av TerraTrue-länken i programlistan.

  4. Välj fliken Provisionering.

    Skärmdump av fliken Konfiguration.

  5. Välj + Ny konfiguration.

    Skärmbild av Ny konfiguration.

  6. I fältet Tenant-URL anger du din TerraTrue Tenant-URL och hemliga token. Välj Testanslutning för att säkerställa att Microsoft Entra ID kan ansluta till TerraTrue. Om anslutningen misslyckas kontrollerar du att Ditt TerraTrue-konto har nödvändiga administratörsbehörigheter och försök igen.

    Skärmbild av provisioning-testanslutning.

  7. Välj Skapa för att skapa konfigurationen.

  8. Välj Egenskaper på sidan Översikt .

  9. Välj ikonen Redigera för att redigera egenskaperna. Aktivera e-postaviseringar och ange ett e-postmeddelande för att ta emot karantänmeddelanden. Aktivera förebyggande av oavsiktliga borttagningar. Välj Använd för att spara ändringarna.

    Skärmbild av provisioneringsegenskaper.

  10. Välj Attributmappning i den vänstra panelen och välj användare.

  11. Granska de användarattribut som synkroniseras från Microsoft Entra ID till TerraTrue i avsnittet Attribute-Mapping. De attribut som valts som matchande egenskaper används för att matcha användarkontona i TerraTrue för uppdateringsåtgärder. Om du väljer att ändra det matchande målattributet måste du se till att TerraTrue-API:et stöder filtrering av användare baserat på det attributet. Välj knappen Spara för att checka in eventuella ändringar.

    Attribut Typ Stöds för filtrering Krävs av TerraTrue
    användarnamn Sträng
    aktiv Boolesk
    namn.förnamn Sträng
    name.efternamn Sträng
    formaterat namn Sträng
  12. Information om hur du konfigurerar omfångsfilter finns i anvisningarna i artikeln Omfångsfilter.

  13. Använd etablering på begäran för att verifiera synkronisering med ett litet antal användare innan du distribuerar mer allmänt i din organisation.

  14. När du är redo att konfigurera väljer du Starta konfiguration på sidan Översikt.

Steg 6: Övervaka distributionen

När du har konfigurerat etableringen använder du följande resurser för att övervaka distributionen:

  1. Använd etableringsloggarna för att avgöra vilka användare som har etablerats framgångsrikt eller misslyckats
  2. Kontrollera förloppsindikatorn för att se statusen för tilldelningscykeln och hur nära den är att slutföras
  3. Om etableringskonfigurationen verkar vara i ett feltillstånd hamnar programmet i karantän. Läs mer om karantänstatus i artikeln provisionering av applikationens karantänstatus.

Felsökning och tips

Kontakta hello@terratrue.com för att få hjälp med att se till att ditt tillhandahållande fungerar korrekt.

TerraTrue innehåller en revisionshistorik över alla ändringar av ett användarkonto som är synligt för en TerraTrue-administratör på länken nedan. Alla användarändringar som görs till följd av SCIM-etablering visas med kolumnen Aktör som "Scim System User".

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

Slutligen anger TerraTrue användarens visningsnamn baserat på det förnamn och efternamn som togs emot under den första användarsynkroniseringen. Efterföljande ändringar av användarens visningsnamn kan göras av en administratör inifrån TerraTrue under Användarorganisationsinställningar på länken nedan:

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

Fler resurser