Sdílet prostřednictvím


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

Tento kurz popisuje kroky, které je potřeba provést v Coda i Microsoft Entra ID ke konfiguraci automatického zřizování uživatelů. Při konfiguraci microsoft Entra ID automaticky zřizuje a zřídí uživatele do coda 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 Coda
  • Odebrání uživatelů v Codě, pokud už nevyžadují přístup
  • Zachování synchronizace atributů uživatele mezi ID Microsoft Entra a Coda
  • Jednotné přihlašování k Coda (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 Coda.

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

  1. Otevřete konzolu Správa organizace výběrem Nastavení organizace v části ... pod pracovním prostorem.

    Nastavení organizace Coda Enterprise

  2. Ujistěte se, že je povolené zřizování pomocí SCIM.

  3. Poznamenejte si základní adresu URL SCIM a nosný token SCIM. Pokud neexistuje nosný token, klepněte na tlačítko Vygenerovat nový token.

Přidejte Coda z galerie aplikací Microsoft Entra a začněte spravovat zřizování pro Coda. Pokud jste dříve nastavili coda 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. Pokud se rozhodnete určit rozsah, který se pro vaši aplikaci zřídí na základě přiřazení, můžete k přiřazení uživatelů k aplikaci použít následující postup . Pokud se rozhodnete určit rozsah, který bude zřízen výhradně na základě atributů uživatele, můžete použít filtr oborů, jak je popsáno zde.

  • 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ů.

  • Začněte v malém. Před zavedením pro všechny otestujte malou sadu uživatelů. Pokud je obor zřizování nastavený na přiřazené uživatele, můžete ho řídit přiřazením jednoho nebo dvou uživatelů k aplikaci. Pokud je obor nastavený pro všechny uživatele, můžete zadat filtr oborů na základě atributů.

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

Tato část vás provede postupem konfigurace služby zřizování Microsoft Entra tak, aby vytvářela, aktualizovala a zakázala uživatele v TestAppu na základě přiřazení uživatelů v Microsoft Entra ID.

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

    Odkaz Coda v seznamu Aplikace

  4. Vyberte kartu Zřizování.

    Snímek obrazovky s možnostmi Spravovat s vyvolanou možností Zřizování

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

    Snímek obrazovky s rozevíracím seznamem Režim zřizování s vyvolanou možností Automatické

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

    Snímek obrazovky s dialogovým oknem Správa Přihlašovací údaje, kde můžete zadat váš tenant U R L a tajný 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 Coda.

  10. Zkontrolujte atributy uživatele, které jsou synchronizovány z Microsoft Entra ID do Coda v části Mapování atributů. Atributy vybrané jako odpovídající vlastnosti slouží ke shodě uživatelských účtů v Coda pro operace aktualizace. Pokud se rozhodnete změnit odpovídající cílový atribut, budete muset zajistit, aby rozhraní API Coda 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
    userName String
    active Logická hodnota
    name.givenName String
    name.familyName String
  11. Pokud chcete nakonfigurovat filtry rozsahu, postupujte podle pokynů uvedených v kurzu k filtrům rozsahu.

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

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

  13. Definujte uživatele, které chcete zřídit pro Coda, 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 spustí počáteční synchronizační cyklus všech uživatelů definovaných v oboru 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ů:

  1. S využitím protokolů zřizování můžete zjistit, kteří uživatelé se zřídili úspěšně a kteří neúspěšně.
  2. Pokud chcete zjistit, jaký je stav cyklu zřizování a jak blízko je dokončení, zkontrolujte indikátor průběhu.
  3. 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

Další kroky