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

Tento kurz popisuje kroky, které potřebujete provést v smallstep SSH a 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 na Smallstep SSH 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 SSH smallstep
  • Odebrání uživatelů přes Smallstep SSH, pokud už nevyžadují přístup
  • Zachování synchronizace atributů uživatele mezi ID Microsoft Entra a Smallstep SSH
  • Zřízení skupin a členství ve skupinách v smallstep SSH
  • Jednotné přihlašování k protokolu Smallstep SSH (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 MICROSOFT Entra ID a SSH Smallstep.

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

  1. Přihlaste se ke svému účtu Smallstep SSH .

  2. Přejděte na kartu Uživatelé a jako zprostředkovatele identity vyberte Microsoft Entra ID .

  3. Na další stránce zadejte ID tenanta Microsoft Entra a seznam povolených pro konfiguraci OIDC.

  4. V části Podrobnosti O SCIM zkopírujte a uložte adresu URL tenanta SCIM a token tajného klíče. Tyto hodnoty se zadají do pole Adresa URL tenanta a token tajného klíče na kartě Zřizování aplikace Smallstep SSH.

Poznámka: Přístup ke spravovaným hostitelům Smallstep byste museli udělit prostřednictvím skupin služby Active Directory. Můžete mít například skupinu pro uživatele ssh a jednu pro uživatele sudo. Přečtěte si další informace o řízení přístupu v rychlém startu Microsoft Entra a průvodci rychlým startem pro hostování.

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

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

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

    Odkaz Smallstep SSH v seznamu Aplikací

  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 Smallstep SSH a token tajného kódu. Klikněte na testovací Připojení ion a ujistěte se, že se Microsoft Entra ID může připojit k protokolu Smallstep SSH. Pokud připojení selže, ujistěte se, že váš účet Smallstep SSH 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 protokolem Smallstep SSH.

  10. Zkontrolujte atributy uživatele, které jsou synchronizovány z Microsoft Entra ID do Smallstep SSH v části Mapování atributů. Atributy vybrané jako odpovídající vlastnosti se používají ke shodě uživatelských účtů v protokolu Smallstep SSH pro operace aktualizace. Pokud se rozhodnete změnit odpovídající cílový atribut, budete muset zajistit, aby rozhraní SMALLSTEP SSH 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í
    userName String
    active Logická hodnota
    displayName String
    emails[type eq "work"].value String
    name.givenName String
    name.familyName String
  11. V části Mapování vyberte Synchronizovat skupiny Microsoft Entra s protokolem Smallstep SSH.

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

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

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

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

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

    Rozsah zřizování

  16. 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ů:

  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