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

Tento kurz popisuje kroky, které potřebujete provést v nástroji Documo i 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 documo 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é možnosti

• Vytváření uživatelů v Documu
• Odebrání uživatelů v aplikaci Documo, pokud už nevyžadují přístup
• Udržování atributů uživatele synchronizovaných mezi ID Microsoft Entra a Documo
• Jednotné přihlašování k Documo (doporučeno).

Požadavky

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

• Tenant Microsoft Entra
• Jedna z následujících rolí: Application Správa istrator, Cloud Application Správa istrator nebo Application Owner.
• Účet Documo s přístupem k rozhraní API
• Uživatelský účet v Aplikaci Documo s oprávněními Správa

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

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

1. Vygenerujte klíč rozhraní API pro zřizování Microsoft Entra.
2. Vyhledejte a zapamatujte si adresu URL rozhraní API. Výchozí adresa URL rozhraní API je https://api.documo.com. Pokud máte vlastní doménu rozhraní DOcumo API, můžete na ni odkazovat na kartě domény na stránce nastavení brandingu Documo.

Krok 3: Přidání Documo z galerie aplikací Microsoft Entra

Přidejte Documo z galerie aplikací Microsoft Entra a začněte spravovat zřizování do Documo. Pokud jste dříve nastavili Documo 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 Documo

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

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

   

3. V seznamu aplikací vyberte Documo.

   

4. Vyberte kartu Zřizování.

   

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

   

6. V části Správa Přihlašovací údaje zadejte adresu URL tenanta Documo a tajný token.

   • Adresa URL vašeho tenanta je adresa URL rozhraní API, kterou jste připravili v kroku 2 s připojeným /scim/v2 ke konci. Hodnota pro ty bez vlastních domén by měla být https://api.documo.com/scim/v2.

   • V poli Token tajného klíče zkopírujte a vložte klíč rozhraní API, který jste připravili v kroku 2. Klikněte na test Připojení ion a ujistěte se, že se Microsoft Entra ID může připojit k Documo. Pokud připojení selže, ujistěte se, že váš účet Documo má Správa oprávnění, a zkuste to znovu.

   

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.

   

8. Zvolte Uložit.

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

10. Zkontrolujte atributy uživatele, které jsou synchronizovány z Microsoft Entra ID do Documo v části Mapování atributů. Atributy vybrané jako odpovídající vlastnosti se používají k porovnání uživatelských účtů v nástroji Documo pro operace aktualizace. Pokud se rozhodnete změnit odpovídající cílový atribut, budete muset zajistit, aby rozhraní API Documo 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í
    userName	String	✓
    active	Logická hodnota
    name.givenName	String
    name.familyName	String
    roles[primary eq "True"].value	String

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

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

    

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

    

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

    

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.

Další materiály

• Správa zřizování uživatelských účtů pro podnikové aplikace
• Co je přístup k aplikacím a jednotné přihlašování pomocí Microsoft Entra ID?

Další kroky

• Zjistěte, jak procházet protokoly a získat sestavy aktivit zřizování.