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

Článek
01/03/2024

Tento kurz popisuje kroky, které potřebujete udělat v Cerby i v 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 a skupiny pro Cerby 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

Vytváření uživatelů v Cerby
Odebrání uživatelů v Cerby, pokud už nevyžadují přístup
Zachování synchronizace atributů uživatele mezi ID Microsoft Entra a Cerby
Zřiďte skupiny a členství ve skupinách v Cerby.
Jednotné přihlašování k Cerby (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
Uživatelský účet v Microsoft Entra ID s oprávněním ke konfiguraci zřizování (například application Správa istrator, správce cloudových aplikací, vlastník aplikace nebo globální Správa istrator).
Uživatelský účet v Cerby s rolí Vlastník pracovního prostoru
Musí být nastavená integrace založená na Cerby SAML2. Podle pokynů v článku o nastavení integrace postupujte podle pokynů v článku o konfiguraci aplikace SAML galerie aplikací Cerby s vaším tenantem Microsoft Entra.

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

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

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

Cerby ve výchozím nastavení povolil podporu zřizování pro ID Microsoft Entra. Ověřovací token rozhraní API SCIM musíte načíst pouze provedením následujících kroků:

Přihlaste se ke svému odpovídajícímu pracovnímu prostoru Cerby.
Klikněte na tlačítko Hi there < user >! , které se nachází v dolní části levé navigační nabídky. Zobrazí se rozevírací nabídka.
V rozevírací nabídce vyberte možnost Konfigurace pracovního prostoru související s vaším účtem. Zobrazí se stránka Konfigurace pracovního prostoru.
Aktivujte kartu Nastavení ZDP.
Klikněte na tlačítko Zobrazit token v části Synchronizace adresáře na kartě Nastavení ZDP. Zobrazí se automaticky otevírané okno, které čeká na potvrzení vaší identity a do mobilní aplikace Cerby se odešle nabízené oznámení. DŮLEŽITÉ: Abyste potvrdili svoji identitu, musíte mít nainstalovanou a přihlášenou k mobilní aplikaci Cerby, abyste mohli přijímat nabízená oznámení.
Klikněte na tlačítko Já! na obrazovce Žádosti o potvrzení mobilní aplikace Cerby potvrďte vaši identitu. Automaticky otevírané okno v pracovním prostoru Cerby se zavře a zobrazí se automaticky otevírané okno Zobrazit token .
Kliknutím na tlačítko Kopírovat zkopírujte token SCIM do schránky.

Tip

Nechte automaticky otevírané okno Zobrazit token, abyste token kdykoli zkopírovali. Ke konfiguraci zřizování pomocí ID Microsoft Entra potřebujete token.

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

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

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

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

Přihlaste se do Centra pro správu Microsoft Entra jako alespoň cloudová aplikace Správa istrator.
Přejděte k podnikovým aplikacím identit>>
V seznamu aplikací vyberte Cerby.
Vyberte kartu Zřizování.
Nastavte Režim zřizování na hodnotu Automaticky.
V části Správa Přihlašovací údaje zadejte https://api.cerby.com/v1/scim/v2 jako adresu URL tenanta Cerby a ověřovací token rozhraní API SCIM, který jste předtím načetli.
Klikněte na testovací Připojení ion a ujistěte se, že se id Microsoft Entra může připojit k Cerby. Pokud připojení selže, ujistěte se, že váš účet Cerby má Správa oprávnění, a zkuste to znovu.
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.
Zvolte Uložit.
V části Mapování vyberte Synchronizovat uživatele Microsoft Entra do Cerby.

Zkontrolujte atributy uživatele, které jsou synchronizovány z Microsoft Entra ID do Cerby v části Mapování atributů . Atributy vybrané jako odpovídající vlastnosti se používají ke shodě uživatelských účtů v Cerby pro operace aktualizace. Pokud se rozhodnete změnit odpovídající cílový atribut, budete muset zajistit, aby rozhraní Cerby 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í	Požadováno společností Cerby
userName	String	✓	✓
emails[type eq "work"].value	String	✓	✓
active	Logická hodnota		✓
name.givenName	String		✓
name.familyName	String		✓
externalId	String

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

Atribut Typ Podporováno pro filtrování Požadováno společností Cerby

displayName String ✓ ✓

externalId String

členové Reference
Pokud chcete nakonfigurovat filtry rozsahu, postupujte podle pokynů uvedených v kurzu k filtrům rozsahu.
Pokud chcete povolit službu zřizování Microsoft Entra pro Cerby, změňte stav zřizování na Zapnuto v části Nastavení.
Definujte uživatele a skupiny, které chcete zřídit pro Cerby, výběrem požadovaných hodnot v oboru v části Nastavení.
Až budete připravení zřídit, klikněte na Uložit.

Atribut	Typ	Podporováno pro filtrování	Požadováno společností Cerby
displayName	String	✓	✓
externalId	String
členové	Reference

Tato operace zahájí cyklus počáteční synchronizace všech uživatelů a skupin definovaných v nabídce Rozsah v části Nastavení. Dokončení počátečního cyklu trvá déle než další 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í není v pořádku, aplikace přejde do karantény. Další informace o stavech karantény najdete tady.

Tipy na řešení potíží

Pokud potřebujete znovu vygenerovat ověřovací token rozhraní API SCIM, proveďte následující kroky:

Pošlete e-mail s žádostí týmu podpory Cerby. Tým Cerby znovu vygeneruje ověřovací token rozhraní API SCIM.
Obdržíte e-mail s odpovědí od Cerby, abyste potvrdili, že se token úspěšně vygeneroval.
Dokončete pokyny z článku o načtení ověřovacího tokenu rozhraní API SCIM z článku Cerby a načtěte nový token.

Poznámka:

Tým Cerby v současné době vyvíjí samoobslužné řešení pro opětovné vygenerování ověřovacího tokenu rozhraní API SCIM. Pokud chcete token znovu vygenerovat, musí členové týmu Cerby ověřit svoji identitu.