Konfigurera Smallstep SSH för automatisk användaretablering med Microsoft Entra-ID

Den här artikeln beskriver de steg du behöver utföra i både Smallstep SSH och Microsoft Entra ID för att konfigurera automatisk användaretablering. När det konfigureras etablerar och avetablerar Microsoft Entra-ID automatiskt användare och grupper till Smallstep SSH med hjälp av Microsoft Entra-etableringstjänsten. Viktig information om vad den här tjänsten gör, hur den fungerar och vanliga frågor finns i Automatisera användaretablering och avetablering till SaaS-program med Microsoft Entra-ID.

Funktioner som stöds

Förutsättningar

Scenariot som beskrivs i den här artikeln förutsätter att du redan har följande förutsättningar:

• • Ett Microsoft Entra-användarkonto med en aktiv prenumeration. Om du inte redan har ett kan du skapa ett konto kostnadsfritt.
  • En av följande roller:
    • Programadministratör
    • Molnprogramadministratör
    • Applikationsägare
• Ett Smallstep SSH-konto .

Steg 1: Planera din försörjningsdistribution

1. Lär dig mer om hur försörjningstjänsten fungerar.
2. Ta reda på vem som är inom :s område för försörjning av.
3. Ta reda på vilka data som ska mappas mellan Microsoft Entra ID och Smallstep SSH.

Steg 2: Konfigurera Smallstep SSH för att stödja etablering med Microsoft Entra ID

1. Logga in på ditt Smallstep SSH-konto .

2. Gå till fliken Användare och välj Microsoft Entra-ID som identitetsprovider.

3. På nästa sida anger du ditt Klient-ID för Microsoft Entra och listan över tillåtna för att konfigurera OIDC.

4. Under SCIM-detaljer kopierar och sparar du din Tenant-URL och hemliga tokenet. Dessa värden anges i fältet Klient-URL och hemlig token på fliken Etablering i ditt Smallstep SSH-program.

Steg 3: Lägg till Smallstep SSH från Microsoft Entra-programgalleriet

Lägg till Smallstep SSH från Microsoft Entra-programgalleriet för att börja hantera tilldelning till Smallstep SSH. Om du tidigare har konfigurerat Smallstep SSH för enkel inloggning kan du använda samma program. Vi rekommenderar dock att du skapar en separat app när du testar integreringen från början. Lär dig mer om att lägga till ett program från galleriet här.

Steg 4: Definiera vilka som omfattas av provisioner

Med Microsoft Entra-etableringstjänsten kan du omfångsbegränsa vem som etableras baserat på tilldelning till programmet, eller baserat på attribut för användaren eller gruppen. Om du väljer att avgränsa vem som får åtkomst till din app baserat på tilldelning kan du använda stegen för att tilldela användare och grupper till applikationen. Om du väljer att bestämma vem som försörjs enbart baserat på användarens eller gruppens attribut kan du använda ett omfångsfilter.

• Börja litet. Testa med en liten uppsättning användare och grupper innan du distribuerar till alla. När omfånget för etablering är inställt på tilldelade användare och grupper kan du styra detta genom att tilldela en eller två användare eller grupper till appen. När omfånget är inställt på alla användare och grupper, kan du ange ett attributbaserat omfångsfilter.

• Om du behöver extra roller kan du uppdatera programmanifestet för att lägga till nya roller.

Steg 5: Konfigurera automatisk användaretablering till Smallstep SSH

Det här avsnittet vägleder dig genom stegen för att konfigurera Microsoft Entra-etableringstjänsten för att skapa, uppdatera och inaktivera användare och/eller grupper i Smallstep SSH baserat på användar- och/eller grupptilldelningar i Microsoft Entra-ID.

Så här konfigurerar du automatisk användaretablering för Smallstep SSH i Microsoft Entra-ID:

1. Logga in på administrationscentret för Microsoft Entra som minst en molnprogramadministratör.

2. Bläddra till Entra ID>Enterprise-appar

   

3. I programlistan väljer du Smallstep SSH.

   

4. Välj fliken Provisioning.

   

5. Välj + Ny konfiguration.

   

6. I fältet Klient-URL anger du din Smallstep SSH-klient-URL och hemliga token. Välj Testa anslutning för att se till att Microsoft Entra ID kan ansluta till Smallstep SSH. Om anslutningen misslyckas kontrollerar du att ditt Smallstep SSH-konto har nödvändiga administratörsbehörigheter och försök igen.

   

7. Välj Skapa för att skapa konfigurationen.

8. Välj Egenskaper på sidan Översikt .

9. I fältet Notifierings-e-postadress anger du e-postadressen till en person som ska få meddelanden om provisioneringsfel och markerar kryssrutan Skicka ett e-postmeddelande när ett fel inträffar.

   

10. Välj Attributmappning i den vänstra panelen och välj användare.

11. Granska de användarattribut som synkroniseras från Microsoft Entra-ID till Smallstep SSH i avsnittet Attributmappning . De attribut som valts som Matchande egenskaper används för att matcha användarkontona i Smallstep SSH för uppdateringsåtgärder. Om du väljer att ändra det matchande målattributet måste du se till att Smallstep SSH-API:et stöder filtrering av användare baserat på det attributet. Välj knappen Spara för att checka in eventuella ändringar.

    Attribut	Typ	Stöds för filtrering
    användarnamn	Sträng	✓
    aktiv	Boolesk
    visningsnamn	Sträng
    e-postmeddelanden[typ = "arbete"].värde	Sträng
    namn.tilltalsnamn	Sträng
    namn.efternamn	Sträng

12. Granska de gruppattribut som synkroniseras från Microsoft Entra-ID till Smallstep SSH i avsnittet Attributmappning . Attributen som valts som Matchande egenskaper används för att matcha grupperna i Smallstep SSH för uppdateringsåtgärder. Välj knappen Spara för att checka in eventuella ändringar.

    Attribut	Typ	Stöds för filtrering
    visningsnamn	Sträng	✓
    medlemmar	Hänvisning

13. Information om hur du konfigurerar omfångsfilter finns i anvisningarna i artikeln Omfångsfilter.

14. Använd etablering på begäran för att verifiera synkronisering med ett litet antal användare innan du distribuerar mer allmänt i din organisation.

15. När du är redo att konfigurera väljer du Starta konfiguration på sidan Översikt.

Steg 6: Övervaka distributionen

När du har konfigurerat etableringen använder du följande resurser för att övervaka distributionen:

1. Använd etableringsloggarna för att avgöra vilka användare som har etablerats framgångsrikt eller misslyckats
2. Kontrollera förloppsindikatorn för att se statusen för tilldelningscykeln och hur nära den är att slutföras
3. Om etableringskonfigurationen verkar vara i ett feltillstånd hamnar programmet i karantän. Läs mer om karantänstatus i artikeln provisionering av applikationens karantänstatus.

Ytterligare resurser

• Hantera användarkontoetablering för Enterprise-appar
• Vad är programåtkomst och enkel inloggning med Microsoft Entra-ID?

Relaterat innehåll

• Lär dig att granska loggar och få rapporter om försörjningsaktivitet