Använda kubelogin för att autentisera användare i Azure Kubernetes Service (AKS)

Kubelogin-pluginet i Azure är ett plugin för klient-go-uppgifter som implementerar Microsoft Entra-autentisering. Plugin-programmet kubelogin erbjuder funktioner som inte är tillgängliga i kubectl-kommandoradsverktyget. Mer information finns i kubelogin-introduktionen och kubectl-introduktionen.

Den här artikeln innehåller en översikt och exempel på hur du använder kubelogin för Microsoft Entra autentiseringsmetoder som stöds och som rekommenderas för AKS.

Kubelogin-autentisering i AKS-begränsningar

  • Grupper som skapas i Microsoft Entra inkluderas endast av deras ObjectID-värde och inte av deras visningsnamn. Kommandot sAMAccountName är endast tillgängligt för grupper som synkroniseras från den lokala Windows Server služba Active Directory.
  • Autentiseringsmetoden för tjänsthuvudnamn fungerar endast med den hanterade Microsoft Entra ID-integrationen, inte den äldre Microsoft Entra ID-integrationen.
  • Tjänstens huvudnamn kan vara medlem i högst 200 Microsoft Entra-grupper. Om du har fler än 200 grupper bör du överväga att använda programroller.
  • Autentiseringsmetoden för enhetskod fungerar inte när en princip för villkorsstyrd åtkomst i Microsoft Entra har angetts för en Microsoft Entra-klientorganisation. I det scenariot använder du interaktiv webbläsarautentisering i stället.
  • Azure CLI-autentiseringsmetoden fungerar endast med Microsoft Entra.

Så här fungerar kubelogin-autentisering i AKS

AKS-kluster som kör Kubernetes version 1.24 eller senare använder automatiskt plugin-formatet kubelogin exec. Kluster som kör Kubernetes-versioner tidigare än 1.24 kräver manuell konvertering till det här formatet.

Använd underkommandot för de flesta interaktioner med kubelogin convert-kubeconfig . Underkommandot använder kubeconfig-filen som du anger i --kubeconfig eller i KUBECONFIG miljövariabeln för att konvertera den slutliga kubeconfig-filen till exec-format baserat på den angivna autentiseringsmetoden.

De autentiseringsmetoderna som kubelogin implementerar är Microsoft Entra OAuth 2.0-tokenbeviljandeflöden. Cachebeteendet beror på autentiseringsmetoden. Autentisering med enhetskod, interaktiv webbläsarinloggning och resursägarens lösenordsuppgifter (ROPC) lagrar autentiseringsposter i kubelogin-cachekatalogen. Metoder som Azure CLI och Azure Developer CLI använder cachen som hanteras av respektive kommandoradsverktyg i stället för kubelogin-cachen.

Autentisering av enhetskod

Enhetskod är standardautentiseringsmetoden för convert-kubeconfig underkommandot. Den här autentiseringsmetoden uppmanar enhetskoden för användaren att logga in från en webbläsarsession.

Kommentar

Innan plugin-programmet kubelogin och exec introducerades stödde Azure-autentiseringsmetoden i kubectl endast enhetskodflödet. Den använde en tidigare version av ett bibliotek som genererar en token som har anspråket audience med ett spn: prefix. Det är inte kompatibelt med Microsoft Entra, som använder ett OBO-flöde (on-behalf-of). När du kör convert-kubeconfig underkommandot tar kubelogin bort prefixet spn: från målgruppsanspråket.

Parametrar för enhetskodautentisering

I följande tabell beskrivs parametrar som du kan använda med autentisering med enhetskod:

Parameter Description
-l devicecode (valfritt) Anger kubelogin-autentiseringsmetoden. Den här parametern är valfri eftersom enhetskod är standardmetoden.
--legacy Använder äldre beteende för kluster som konfigurerats med äldre Microsoft Entra ID integrering. Om kubeconfig-filen är för ett sådant kluster lägger kubelogin automatiskt till --legacy flaggan.
--cache-dir Åsidosätter standardsökvägen för tokencachekatalogen, som är ${HOME}/.kube/cache/kubelogin.

Azure CLI-autentisering

Autentiseringsmetoden Azure CLI (kommando: -l azurecli) använder den inloggade kontext som Azure CLI upprättar för att hämta åtkomsttoken. Tokenet utfärdas i samma Microsoft Entra-klientorganisation som az login. kubelogin skriver inte token till tokencachefilen eftersom Azure CLI redan hanterar dem.

Parametrar för Azure CLI-autentisering

I följande tabell beskrivs parametrar som du kan använda med Azure CLI-autentisering:

Parameter Description
-l azurecli Anger kubelogin-autentiseringsmetoden.
--azure-config-dir Anger Azure CLI-konfigurationskatalogen. Standardkatalogen är ${HOME}/.azure.

Logga in på Azure

Logga in på Azure med hjälp az login av kommandot .

az login

Interaktiv autentisering i webbläsare

Webbläsarens interaktiva (kommando: -l interactive) autentiseringsmetod öppnar automatiskt en webbläsare för att logga in användaren. När användaren har autentiserats omdirigeras webbläsaren till den lokala webbservern med hjälp av de verifierade autentiseringsuppgifterna. Den här autentiseringsmetoden följer principen för villkorsstyrd åtkomst.

Du kan använda antingen en ägartoken eller en PoP-token (Proof-of-Possession) med den här autentiseringsmetoden.

Parametrar för ägartokenautentisering

I följande tabell beskrivs parametrar som du kan använda med autentisering med ägartoken:

Parameter Description
-l interactive Anger kubelogin-autentiseringsmetoden.
--cache-dir Åsidosätter standardsökvägen för tokencachekatalogen, som är ${HOME}/.kube/cache/kubelogin.

Parametrar för PoP-tokenautentisering

I följande tabell beskrivs parametrar som du kan använda med PoP-tokenautentisering:

Parameter Description
-l interactive Anger kubelogin-autentiseringsmetoden.
--pop-enabled Aktiverar PoP-tokenautentisering.
--pop-claims Anger PoP-tokenanspråken i nyckel/värde-parformat. Exempel: u=/ARM/ID/OF/CLUSTER

Tjänstens huvudautentisering

Tjänsthuvudnamn (kommando: -l spn) autentiseringsmetod använder ett tjänsthuvudnamn för att autentisera användaren. Du kan ange autentiseringsuppgifterna genom att ange en miljövariabel eller genom att använda autentiseringsuppgifterna i ett kommandoradsargument. De autentiseringsuppgifter som stöds är ett lösenord eller ett PFX-klientcertifikat (Personal Information Exchange).

Parametrar för autentisering med tjänsthuvudprincip

I följande tabell beskrivs parametrar som du kan använda vid autentisering med tjänst-princip.

Parameter Description
-l spn Anger kubelogin-autentiseringsmetoden.
--client-id Applikations-ID (klient-ID) för tjänsthuvud.
--client-secret Klienthemligheten för serviceprincipalen.

Hanterad identitetsautentisering

Använd autentiseringsmetoden hanterad identitet (kommando: -l msi) för program som ansluter till resurser som stöder Microsoft Entra-autentisering. Exempel är åtkomst till Azure resurser som en Azure virtuell dator (VM), Virtual Machine Scale Sets eller Azure Cloud Shell.

Du kan använda standardhanterad identitet som har tilldelats resursen eller en specifik användartilldelad hanterad identitet.

Parametrar för hanterad identitetsautentisering

I följande tabell beskrivs parametrar som du kan använda med hanterad identitetsautentisering:

Parameter Description
-l msi Anger kubelogin-autentiseringsmetoden.
--client-id Program-ID (klient-ID) för den användartilldelade hanterade identiteten. Om du inte anger den här parametern används standardhanterad identitet.

Autentisering av arbetsbelastningens identitet

Autentiseringsmetoden för arbetsbelastningsidentitet (kommando: -l workloadidentity) använder identitetsuppgifter som är federerade med Microsoft Entra för att autentisera åtkomst till AKS-kluster. Metoden använder Microsoft Entra-integrerad autentisering. Det fungerar genom att ange följande miljövariabler:

Variable Description
AZURE_CLIENT_ID Microsoft Entra-applikations-ID som är federerat med arbetesidentiteten.
AZURE_TENANT_ID Klient-ID:t för Microsoft Entra.
AZURE_FEDERATED_TOKEN_FILE Filen som innehåller en signerad verifiering av arbetsbelastningsidentiteten, till exempel en Kubernetes-projekterad servicekonto-token (JWT).
AZURE_AUTHORITY_HOST Grund-URL för en Microsoft Entra-auktoritet. Exempel: https://login.microsoftonline.com/

Du kan använda en arbetsbelastningsidentitet för att komma åt Kubernetes-kluster från CI/CD-system som GitHub eller Argo CD utan att lagra autentiseringsuppgifterna för tjänstens huvudnamn i de externa systemen. Information om hur du konfigurerar OpenID Connect-federation (OIDC) från GitHub finns i OIDC-federationsexemplet.

Parametrar för autentisering av arbetsbelastningsidentitet

I följande tabell beskrivs parametrar som du kan använda med autentisering av arbetsbelastningsidentitet:

Parameter Description
-l workloadidentity Anger kubelogin-autentiseringsmetoden.

Azure CLI-autentisering för utvecklare

Autentiseringsmetoden Azure Developer CLI (kommando: -l azd) använder den inloggade kontext som Azure Developer CLI upprättar för att hämta åtkomsttoken. Tokenet utfärdas i samma Microsoft Entra-klientorganisation som azd auth login. kubelogin skriver inte token till sin tokencache eftersom Azure Developer CLI hanterar dem.

Den här autentiseringsmetoden fungerar bara med hanterade Microsoft Entra i AKS. Mer information finns i översikten Azure Developer CLI.

Azure-pipelines-autentisering

Autentiseringsmetoden Azure-pipelines (kommando: -l azurepipelines) använder en Azure Resource Manager tjänstanslutning och pipelinens systemåtkomsttoken för att autentisera. Den här metoden fungerar bara i Azure-pipelines. Pipelinen måste ha en Azure Resource Manager tjänstanslutning och tillåta skript att komma åt OAuth-token.

När du använder en AzureCLI@2-uppgift med en Azure Resource Manager-tjänstanslutning kan kubelogin använda klientorganisations-ID, klient-ID och tjänstanslutnings-ID som Azure-pipelines tillhandahåller som miljövariabler. Mer information finns i Azure-pipelines tjänstanslutningar.

Varning

kubelogin stöder även ropc-autentiseringsmetoden (resource owner password credential). Microsoft rekommenderar att du inte använder ROPC eftersom det är inkompatibelt med multifaktorautentisering och vissa hybrididentitetsscenarier. Mer information finns i vägledningen för Microsofts identitetsplattform ROPC.

Exportera sökväg för kubeconfig-fil

Innan du kör convert-kubeconfig underkommandot exporterar du kubeconfig-filsökvägen till KUBECONFIG miljövariabeln. Till exempel:

export KUBECONFIG=/path/to/kubeconfig

Konvertera kubeconfig-filen

convert-kubeconfig Kör underkommandot för att konvertera kubeconfig-filen för att använda exec-plugin-programmet för den valda autentiseringsmetoden.

kubelogin convert-kubeconfig
kubelogin convert-kubeconfig -l azurecli
# Bearer token authentication
kubelogin convert-kubeconfig -l interactive

# Proof-of-Possession (PoP) token authentication
kubelogin convert-kubeconfig -l interactive --pop-enabled --pop-claims "u=/ARM/ID/OF/CLUSTER"
  1. convert-kubeconfig Kör underkommandot för att konvertera kubeconfig-filen för att använda exec-plugin-programmet.

    kubelogin convert-kubeconfig -l spn
    
  2. Ange miljövariablerna för klient-ID och klienthemlighet eller klientcertifikat. Till exempel:

    export AZURE_CLIENT_ID=<service-principal-client-id>
    export AZURE_CLIENT_SECRET=<service-principal-client-secret>
    
# Default managed identity authentication
kubelogin convert-kubeconfig -l msi

# Specific managed identity authentication
kubelogin convert-kubeconfig -l msi --client-id <managed-identity-client-id>
kubelogin convert-kubeconfig -l workloadidentity

Konvertera kubeconfig-filen med hjälp av Azure Developer CLI

  1. Logga in med hjälp av CLI för Azure Developer.

    azd auth login
    
  2. Konvertera kubeconfig-filen till att använda cli-autentiseringsmetoden Azure Developer.

    kubelogin convert-kubeconfig -l azd
    

Konvertera kubeconfig-filen i Azure-pipelines

I en AzureCLI@2 uppgift som använder en Azure Resource Manager tjänstanslutning konverterar du kubeconfig-filen till att använda Azure-pipelines autentisering.

kubelogin convert-kubeconfig -l azurepipelines

Ta bort cachelagrade token

Ta bort cachelagrade token med kommandot kubelogin remove-cache-dir.

kubelogin remove-cache-dir

Hämta nodinformation

Hämta nodinformation med hjälp kubectl get av kommandot .

kubectl get nodes

Så här använder du kubelogin-program-ID:t med AKS

AKS använder ett par Microsoft Entra-program från första part. De här program-ID:na är desamma i alla miljöer.

Application Applikations-ID (GUID) Används i
AKS-serverprogram (--server-id) 6dae42f8-4368-4678-94ff-3960e28e3630 Token-målgruppen för alla kubelogin-autentiseringsmetoder som stöds vid åtkomst till AKS.
OFFENTLIGT AKS-klientprogram (--client-id) 80faf920-1908-4b52-b5ef-a8e7bedfc67a Enhetskod, interaktiv webbläsare och ROPC-autentisering.

När du anropar kubelogin get-token direkt för AKS anger du PROGRAM-ID för AKS-server med --server-id. För lägesspecifika parametrar, se kubelogin-referensenget-token.

Kommentar

Det offentliga klientprogram-ID:t för AKS i det här avsnittet är värdet --client-id för enhetskodautentisering, interaktiv autentisering i webbläsare och ROPC-autentisering. För tjänsthuvudnamn och hanterad identitetsautentisering --client-id identifierar tjänstens huvudnamn eller användartilldelade hanterade identitet i stället.

Hämta till exempel en token med hjälp av enhetskodautentisering och AKS-program-ID:n:

kubelogin get-token \
    --login devicecode \
    --server-id 6dae42f8-4368-4678-94ff-3960e28e3630 \
    --client-id 80faf920-1908-4b52-b5ef-a8e7bedfc67a \
    --tenant-id <microsoft-entra-tenant-id>