Konfigurowanie protokołu Smallstep SSH na potrzeby automatycznej aprowizacji użytkowników przy użyciu identyfikatora Entra firmy Microsoft

W tym artykule opisano kroki, które należy wykonać zarówno w Smallstep SSH, jak i Microsoft Entra ID, aby skonfigurować automatyczne udostępnianie użytkowników. Po skonfigurowaniu identyfikator Entra firmy Microsoft automatycznie aprowizuje i anuluje aprowizowanie użytkowników i grup w usłudze Smallstep SSH przy użyciu usługi aprowizacji firmy Microsoft. Aby uzyskać ważne szczegółowe informacje na temat działania tej usługi, sposobu jej działania i często zadawanych pytań, zobacz Automatyzowanie aprowizacji użytkowników i anulowania aprowizacji aplikacji SaaS przy użyciu identyfikatora Entra firmy Microsoft.

Obsługiwane możliwości

Wymagania wstępne

W scenariuszu opisanym w tym artykule przyjęto założenie, że masz już następujące wymagania wstępne:

• • Konto użytkownika Microsoft Entra z aktywną subskrypcją. Jeśli jeszcze go nie masz, możesz bezpłatnie utworzyć konto.
  • Jedna z następujących ról:
    • Administrator aplikacji
    • Administrator aplikacji w chmurze
    • Właściciel aplikacji.
• Konto Smallstep SSH.

Krok 1: Zaplanuj wdrożenie usług

1. Dowiedz się, jak działa usługa aprowizacji.
2. Określ, kto znajduje się w zakresie przydzielania zasobów.
3. Określ, jakie dane mają być mapowane między identyfikatorem Entra firmy Microsoft i protokołem Smallstep SSH.

Krok 2. Konfigurowanie protokołu Smallstep SSH w celu obsługi aprowizacji przy użyciu identyfikatora Entra firmy Microsoft

1. Zaloguj się do swojego konta smallstep SSH .

2. Przejdź do karty Użytkownicy i wybierz pozycję Microsoft Entra ID jako dostawca tożsamości.

3. Na następnej stronie podaj identyfikator dzierżawy firmy Microsoft Entra i listę dozwolonych, aby skonfigurować funkcję OIDC.

4. W sekcji Szczegóły SCIM skopiuj i zapisz swój adres URL Dzierżawcy SCIM oraz Tajny Token . Te wartości są wprowadzane w polu Adres URL dzierżawy i Sekretny token w zakładce Aprowizacja w aplikacji Smallstep SSH.

Krok 3. Dodawanie protokołu Smallstep SSH z galerii aplikacji Microsoft Entra

Dodaj usługę Smallstep SSH z galerii aplikacji Microsoft Entra, aby rozpocząć zarządzanie aprowizowaniem do usługi Smallstep SSH. Jeśli wcześniej skonfigurowano protokół Smallstep SSH na potrzeby logowania jednokrotnego, możesz użyć tej samej aplikacji. Zalecamy jednak utworzenie oddzielnej aplikacji podczas początkowego testowania integracji. Dowiedz się więcej o dodawaniu aplikacji z galerii tutaj.

Krok 4: Określenie, kto jest objęty zakresem aprowizacji

Usługa aprowizacji Microsoft Entra umożliwia definiowanie, kto ma być aprowizowany na podstawie przypisania do aplikacji lub na podstawie atrybutów użytkownika lub grupy. Jeśli zdecydujesz się określić, którzy użytkownicy zostaną przypisani do twojej aplikacji na podstawie przypisania, możesz użyć kroków do przypisywania użytkowników i grup do aplikacji. Jeśli zdecydujesz się określić zakres, kto jest aprowizowany wyłącznie na podstawie atrybutów użytkownika lub grupy, możesz użyć filtru określania zakresu.

• Zacznij od małego. Przeprowadź test z użyciem mniejszego zestawu użytkowników i grup, zanim wdrożysz to rozwiązanie dla wszystkich. Jeśli zakres aprowizacji jest ustawiony na przypisanych użytkowników i grupy, możesz to kontrolować, przypisując jednego lub dwóch użytkowników lub grup do aplikacji. Gdy zakres jest ustawiony na wszystkich użytkowników i grupy, można określić filtr określania zakresu na podstawie atrybutów.

• Jeśli potrzebujesz dodatkowych ról, możesz zaktualizować manifest aplikacji , aby dodać nowe role.

Krok 5. Skonfiguruj automatyczne udostępnianie użytkowników w usłudze Smallstep SSH

Ta sekcja zawiera instrukcje konfigurowania usługi aprowizacji firmy Microsoft w celu tworzenia, aktualizowania i wyłączania użytkowników i/lub grup w usłudze Smallstep SSH na podstawie przypisań użytkowników i/lub grup w usłudze Microsoft Entra ID.

Aby skonfigurować automatyczne udostępnianie użytkowników dla Smallstep SSH w Microsoft Entra ID:

1. Zaloguj się do centrum administracyjnego firmy Microsoft Entra co najmniej jako administrator aplikacji w chmurze.

2. Przejdź do aplikacji Entra ID>Dla przedsiębiorstw

   

3. Na liście aplikacji wybierz pozycję Smallstep SSH.

   

4. Wybierz kartę Provisioning.

   

5. Wybierz + Nową konfigurację.

   

6. W polu Adres URL dzierżawy wprowadź adres URL dzierżawy Smallstep SSH i tajny token. Wybierz pozycję Testuj połączenie , aby upewnić się, że identyfikator Entra firmy Microsoft może nawiązać połączenie z protokołem SSH smallstep. Jeśli połączenie nie powiedzie się, upewnij się, że konto smallstep SSH ma wymagane uprawnienia administratora i spróbuj ponownie.

   

7. Wybierz pozycję Utwórz , aby utworzyć konfigurację.

8. Wybierz Właściwości na stronie Przegląd.

9. W polu Wiadomość e-mail z powiadomieniem wprowadź adres e-mail osoby, która powinna otrzymywać powiadomienia o błędach aprowizacji, a następnie zaznacz pole wyboru Wyślij powiadomienie e-mail w przypadku wystąpienia błędu .

   

10. Wybierz Mapowanie atrybutów w panelu po lewej stronie i wybierz użytkownicy.

11. Przejrzyj atrybuty użytkownika, które są synchronizowane z identyfikatora Entra firmy Microsoft do protokołu Smallstep SSH w sekcji Mapowanie atrybutów . Atrybuty wybrane jako Pasujące właściwości są używane do dopasowania kont użytkowników w Smallstep SSH na potrzeby operacji aktualizacji. Jeśli zdecydujesz się zmienić pasujący atrybut docelowy, musisz upewnić się, że interfejs API Smallstep SSH obsługuje filtrowanie użytkowników na podstawie tego atrybutu. Wybierz przycisk Zapisz , aby zatwierdzić wszelkie zmiany.

    Atrybut	Typ	Obsługa filtrowania
    userName	Sznurek	✓
    aktywny	logiczny
    nazwa wyświetlana	Sznurek
    emails[typ eq "praca"].wartość	Sznurek
    nazwa.imię	Sznurek
    imię.nazwisko	Sznurek

12. Przejrzyj atrybuty grupy synchronizowane z identyfikatora Entra firmy Microsoft do protokołu Smallstep SSH w sekcji Mapowanie atrybutów . Atrybuty wybrane jako właściwości dopasowania są używane do dopasowywania grup w Smallstep SSH podczas operacji aktualizacji. Wybierz przycisk Zapisz , aby zatwierdzić wszelkie zmiany.

    Atrybut	Typ	Wsparcie przy filtrowaniu
    nazwa wyświetlana	Sznurek	✓
    Członkowie	Źródło

13. Aby skonfigurować filtry określania zakresu, zapoznaj się z instrukcjami podanymi w artykule Określanie filtrów zakresu.

14. Użyj prowizjonowania na żądanie, aby zweryfikować synchronizację z niewielką liczbą użytkowników przed wdrożeniem na szerszą skalę w organizacji.

15. Gdy wszystko będzie gotowe do aprowizacji, wybierz pozycję Rozpocznij aprowizację na stronie Przegląd .

Krok 6. Monitorowanie wdrożenia

Po skonfigurowaniu aprowizacji użyj następujących zasobów, aby monitorować wdrożenie:

1. Użyj dzienników przydzielania , aby określić, którzy użytkownicy zostali pomyślnie przydzieleni lub dla których proces przydzielania się nie powiódł.
2. Sprawdź pasek postępu , aby zobaczyć stan cyklu wdrażania i sprawdzić, jak blisko jest do zakończenia.
3. Jeśli konfiguracja aprowizacji wydaje się być w złej kondycji, aplikacja przechodzi do kwarantanny. Dowiedz się więcej o stanach kwarantanny z artykułu dotyczącego statusu kwarantanny podczas aprowizacji aplikacji.

Dodatkowe zasoby

• Zarządzanie aprowizowaniem konta użytkownika dla aplikacji dla przedsiębiorstw
• Co to jest dostęp do aplikacji i logowanie jednokrotne przy użyciu identyfikatora Microsoft Entra ID?

Powiązana zawartość

• Dowiedz się, jak przeglądać dzienniki i pobierać raporty dotyczące działań aprowizacji