Sdílet prostřednictvím


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

Tento kurz popisuje kroky, které potřebujete provést v xledgeru i v Microsoft Entra ID pro 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 xledger pomocí služby zřizování Microsoft Entra. 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

  • Vytvořte uživatele v xledgeru.
  • Odeberte uživatele v xledgeru, pokud už nevyžadují přístup.
  • Udržovat atributy uživatele synchronizované mezi Microsoft Entra ID a Xledger.
  • Zřiďte skupiny a členství ve skupinách v xledgeru.
  • Jednotné přihlašování k xledgeru (doporučeno).

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

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

  1. Přihlaste se k xledgeru s rolí Domain Správa istrator (nebo podobné) a přejděte na Správa istrace > přístupových tokenů rozhraní API pro přístup k > systému.

  2. Vygenerujte tajný token a poznamenejte si ho.

    Snímek obrazovky s přístupovými tokeny rozhraní API (nový token)

  3. Poznamenejte si adresu URL tenanta.

    Snímek obrazovky s přístupovým tokenem rozhraní API (adresa URL rozhraní API)

Tyto hodnoty se použijí na kartě Zřizování aplikace Xledger. (Krok 5)

Přidejte xledger z galerie aplikací Microsoft Entra a začněte spravovat zřizování pro Xledger. Pokud jste dříve nastavili xledger pro jednotné přihlašování, můžete použít stejnou aplikaci. Při počátečním testování integrace se ale doporučuje 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 xledger

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 aplikaci TestApp na základě přiřazení uživatelů a/nebo skupin v Microsoft Entra ID.

Konfigurace automatického zřizování uživatelů pro xledger 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>>

    Snímek obrazovky s oknem Podnikové aplikace

  3. V seznamu aplikací vyberte Xledger.

    Snímek obrazovky s odkazem Xledger v seznamu Aplikace

  4. Vyberte kartu Zřizování.

    Snímek obrazovky s kartou Zřizování

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

    Snímek obrazovky s automatickou kartou Zřizování

  6. V části Správa Přihlašovací údaje zadejte adresu URL tenanta Xledger a token tajného klíče. Klikněte na tlačítko Test Připojení ion, abyste zajistili, že se ID Microsoft Entra může připojit k xledgeru. Pokud připojení selže, ujistěte se, že váš účet Xledger má Správa oprávnění a zkuste to znovu.

    Snímek obrazovky s tokenem

  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.

    Snímek obrazovky s e-mailem s oznámením

  8. Zvolte Uložit.

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

  10. Zkontrolujte atributy uživatele, které jsou synchronizovány z Microsoft Entra ID do Xledger v části Mapování atributů. Atributy vybrané jako odpovídající vlastnosti slouží k porovnání uživatelských účtů v xledgeru pro operace aktualizace. Pokud se rozhodnete změnit odpovídající cílový atribut, musíte zajistit, aby rozhraní API xledgeru 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í Požadováno uživatelem Xledger
    userName String
    active Logická hodnota
    displayName String
    emails[type eq "work"].value String
    phoneNumbers[type eq "work"].value String
    urn:ietf:params:scim:schemas:extension:xledger:2.0:User:accessFromDate DateTime
    urn:ietf:params:scim:schemas:extension:xledger:2.0:User:accessToDate DateTime
  11. V části Mapování vyberte Synchronizovat skupiny Microsoft Entra do xledgeru.

  12. Zkontrolujte atributy skupiny, které jsou synchronizovány z Microsoft Entra ID do Xledger v části Mapování atributů. Atributy vybrané jako odpovídající vlastnosti slouží ke shodě skupin v xledgeru pro aktualizační operace. Výběrem tlačítka Uložit potvrďte všechny změny.

    Atribut Typ Podporováno pro filtrování Požadováno uživatelem Xledger
    displayName String
    členové Reference
  13. Pokud chcete nakonfigurovat filtry rozsahu, postupujte podle pokynů uvedených v kurzu k filtrům rozsahu.

  14. Chcete-li povolit službu zřizování Microsoft Entra pro Xledger, změňte stav zřizování na Zapnuto v Nastavení části.

    Snímek obrazovky se zapnutým zapnutým stavem zřizování

  15. Definujte uživatele nebo skupiny, které chcete zřídit pro xledger, výběrem požadovaných hodnot v oboru v oddílu Nastavení.

    Snímek obrazovky s oborem zřizování

  16. Až budete připravení zřídit, klikněte na Uložit.

    Snímek obrazovky s uložením 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ě.
  • Zkontrolujte indikátor průběhu a podívejte se na stav cyklu zřizování a jeho zavření.
  • Pokud se zdá, že konfigurace zřizování je v pořádku, aplikace přejde do karantény. Další informace o stavech karantény najdete tady.

Další materiály

Další kroky