Sdílet prostřednictvím

Kurz: Konfigurace TerraTrue pro automatické zřizování uživatelů

  • Článek

Tento kurz popisuje kroky, které potřebujete provést v TerraTrue i v Microsoft Entra ID ke konfiguraci automatického zřizování uživatelů. Při konfiguraci microsoft Entra ID automaticky zřídí a zruší zřízení uživatelů a skupin do TerraTrue pomocí služby Microsoft Entra provisioning. Důležité podrobnosti o tom, co tato služba dělá, jak funguje, a nejčastější dotazy najdete v tématu Automatizace zřizování a rušení zřizování uživatelů pro aplikace SaaS pomocí Microsoft Entra ID.

Podporované funkce

  • Vytvářejte uživatele v TerraTrue.
  • Odeberte uživatele v TerraTrue, pokud už nevyžadují přístup.
  • Udržovat atributy uživatele synchronizované mezi Microsoft Entra ID a TerraTrue.
  • Jednotné přihlašování k TerraTrue.

Požadavky

Scénář popsaný v tomto kurzu předpokládá, že už máte následující požadavky:

Krok 1: Plánování nasazení zřizování

  1. Seznamte se s fungováním služby zřizování.
  2. Zjistěte, kdo bude v rozsahu zřizování.
  3. Určete, jaká data se mají mapovat mezi ID Microsoft Entra a TerraTrue.

Krok 2: Konfigurace TerraTrue pro podporu zřizování pomocí Microsoft Entra ID

  1. V TerraTrue přejděte na organization Nastavení > Authentication > SCIM nebo navštivte https://launch.terratrue.com/settings/auth/scim.

  2. Dále povolte přepínač Konfigurace SCIM a kliknutím na Kopírovat klíč rozhraní API zkopírujte klíč rozhraní API SCIM.

    Generování tokenu

Přidejte TerraTrue z galerie aplikací Microsoft Entra a začněte spravovat zřizování pro TerraTrue. Pokud jste dříve nastavili TerraTrue pro jednotné přihlašování, můžete použít stejnou aplikaci. Pro účely počátečního testování integrace však doporučujeme vytvořit samostatnou aplikaci. Další informace o přidání aplikace z galerie najdete tady.

Krok 4: Definujte, kdo bude v oboru zřizování

Služba zřizování Microsoft Entra umožňuje určit rozsah, který bude zřízen na základě přiřazení k aplikaci nebo na základě atributů uživatele nebo skupiny. Pokud se rozhodnete nastavit rozsah uživatelů, kteří se zřídí pro vaši aplikaci, na základě přiřazení, můžete k aplikaci přiřadit uživatele a skupiny pomocí následujících kroků. Pokud se rozhodnete nastavit rozsah uživatelů, kteří se zřídí, pouze na základě atributů jednotlivých uživatelů nebo skupin, můžete použít filtr rozsahu, jak je popsáno tady.

  • Začněte v malém. Než se pustíte do zavádění pro všechny, proveďte testování s malou skupinou uživatelů a skupin. Pokud je rozsah zřizování nastavený na přiřazené uživatele a skupiny, můžete testování provést tak, že k aplikaci přiřadíte jednoho nebo dva uživatele nebo skupiny. Pokud je rozsah nastavený na všechny uživatele a skupiny, můžete určit filtr rozsahu na základě atributů.

  • Pokud potřebujete další role, můžete aktualizovat manifest aplikace a přidat nové role.

Krok 5: Konfigurace automatického zřizování uživatelů pro TerraTrue

Tato část vás provede postupem konfigurace služby zřizování Microsoft Entra pro vytvoření, aktualizaci a zakázání uživatelů a/nebo skupin v TerraTrue na základě přiřazení uživatelů a/nebo skupin v Microsoft Entra ID.

Konfigurace automatického zřizování uživatelů pro TerraTrue v Microsoft Entra ID:

  1. Přihlaste se do Centra pro správu Microsoft Entra jako alespoň cloudová aplikace Správa istrator.

  2. Přejděte k podnikovým aplikacím identit>>

    Okno Podnikové aplikace

  3. V seznamu aplikací vyberte TerraTrue.

    Odkaz TerraTrue v seznamu Aplikace

  4. Vyberte kartu Zřizování.

    Karta Zřizování

  5. Nastavte Režim zřizování na hodnotu Automaticky.

    Automatická karta Zřizování

  6. V části Správa Přihlašovací údaje zadejte adresu URL tenanta TerraTrue a token tajného kódu. Klikněte na test Připojení ion a ujistěte se, že se id Microsoft Entra může připojit k TerraTrue. Pokud připojení selže, ujistěte se, že váš účet TerraTrue má Správa oprávnění, a zkuste to znovu.

    Token

  7. Do pole Oznamovací e-mail zadejte e-mailovou adresu osoby nebo skupiny, na kterou by se měla odesílat oznámení o chybách zřizování, a zaškrtněte políčko Když dojde k selhání, poslat oznámení e-mailem.

    E-mailové oznámení

  8. Zvolte Uložit.

  9. V části Mapování vyberte Synchronizovat uživatele Microsoft Entra s TerraTrue.

  10. Zkontrolujte atributy uživatele, které jsou synchronizovány z Microsoft Entra ID do TerraTrue v části Mapování atributů. Atributy vybrané jako odpovídající vlastnosti se používají ke shodě uživatelských účtů v TerraTrue pro operace aktualizace. Pokud se rozhodnete změnit odpovídající cílový atribut, budete muset zajistit, aby rozhraní TERRATrue API podporovalo filtrování uživatelů na základě daného atributu. Výběrem tlačítka Uložit potvrďte všechny změny.

    Atribut Typ Podporováno pro filtrování Vyžaduje TerraTrue
    userName String ✓ ✓
    active Logická hodnota
    name.givenName String
    name.familyName String
    name.formatted String

  11. Pokud chcete nakonfigurovat filtry rozsahu, postupujte podle pokynů uvedených v kurzu k filtrům rozsahu.

  12. Pokud chcete povolit službu zřizování Microsoft Entra pro TerraTrue, změňte stav zřizování na Zapnuto v části Nastavení.

    Zapnutý přepínač Stav zřizování

  13. Definujte uživatele nebo skupiny, které chcete pro TerraTrue zřídit, výběrem požadovaných hodnot v oboru v části Nastavení.

    Rozsah zřizování

  14. Jakmile budete připraveni na zřízení, klikněte na Uložit.

    Uložení konfigurace zřizování

Tato operace zahájí cyklus počáteční synchronizace všech uživatelů a skupin definovaných v nabídce Rozsah v části Nastavení. Počáteční cyklus trvá déle než následné cykly, ke kterým dochází přibližně každých 40 minut, pokud je spuštěná služba zřizování Microsoft Entra.

Krok 6: Monitorování nasazení

Po dokončení konfigurace zřizování můžete své nasazení monitorovat pomocí následujících prostředků:

  • S využitím protokolů zřizování můžete zjistit, kteří uživatelé se zřídili úspěšně a kteří neúspěšně.
  • Pokud chcete zjistit, jaký je stav cyklu zřizování a jak blízko je dokončení, zkontrolujte indikátor průběhu.
  • Pokud se zdá, že konfigurace zřizování není v pořádku, aplikace přejde do karantény. Další informace o stavech karantény najdete tady.

Řešení potíží a tipy

S hello@terratrue.com žádostí o pomoc se ujistěte, že zřizování funguje správně.

TerraTrue poskytuje historii revizí všech změn uživatelského účtu viditelného pro všechny správce TerraTrue na následujícím odkazu. Všechny změny uživatele provedené v důsledku zřizování SCIM se zobrazí se sloupcem Actor s textem Scim System User.

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

TerraTrue nakonec nastaví zobrazované jméno uživatele na základě jména a příjmení přijatého při první synchronizaci uživatele. Následné změny zobrazovaného jména uživatele může provést správce z TerraTrue v rámci organizace uživatelů Nastavení na následujícím odkazu:

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

Další materiály

Další kroky