Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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"
- Använda miljövariabler
- Använda kommandoradsargument
- Använda ett klientcertifikat
- Använda en PoP-token med miljövariabler
convert-kubeconfigKör underkommandot för att konvertera kubeconfig-filen för att använda exec-plugin-programmet.kubelogin convert-kubeconfig -l spnAnge 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
Logga in med hjälp av CLI för Azure Developer.
azd auth loginKonvertera 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>
Relaterat innehåll
- Lär dig hur du integrerar AKS med Microsoft Entra i artikeln om Microsoft Entra-integrering .
- Information om hur du kommer igång med hanterade identiteter i AKS finns i Använda en hanterad identitet i AKS.
- Information om hur du kommer igång med arbetsbelastningsidentiteter i AKS finns i Använda en arbetsbelastningsidentitet i AKS.