Skip to content

Commit 8cbf423

Browse files
Add troubleshooting guide for authentication to AKS using external identity providers
1 parent 4f6b579 commit 8cbf423

1 file changed

Lines changed: 6 additions & 6 deletions

File tree

support/azure/azure-kubernetes/security/troubleshoot-aks-control-plane-authentication-external-identity-providers.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Troubleshoot AKS control plane authentication using external identity providers
3-
description: Helps you troubleshoot authentication issues when accessing the Azure Kubernetes Service control plane using external identity providers like Google Identity or GitHub Actions OIDC.
3+
description: Helps you troubleshoot authentication issues when accessing the Azure Kubernetes Service control plane using external identity providers
44
ms.reviewer: shasb
55
ms.service: azure-kubernetes-service
66
ms.topic: troubleshooting-general
@@ -16,11 +16,11 @@ zone_pivot_group_filename: aks-external-identity-provider
1616
:::
1717
-->
1818

19-
This article helps you troubleshoot authentication issues when accessing the Azure Kubernetes Service (AKS) control plane using external identity providers such as Google Identity or GitHub Actions OIDC through the JWT authenticator feature.
19+
This article helps you troubleshoot authentication issues when accessing the Azure Kubernetes Service (AKS) control plane using external identity providers.
2020

2121
## Prerequisites
2222

23-
- Azure CLI version 2.61.0 or later. Run `az --version` to find the version. If you need to install or upgrade, see [Install Azure CLI](/cli/azure/install-azure-cli).
23+
- Azure CLI version 2.61.0 or later. To find the version run `az --version` . If you need to install or upgrade, see [Install Azure CLI](/cli/azure/install-azure-cli).
2424
- A tool to connect to the Kubernetes cluster, such as the `kubectl` tool. To install `kubectl` using the Azure CLI, run the [az aks install-cli](/cli/azure/aks#az-aks-install-cli) command.
2525
- The JWT authenticator configuration file used for your AKS cluster.
2626
- Access to [jwt.ms][jwt-ms] or a similar JWT token decoder tool for debugging tokens.
@@ -34,7 +34,7 @@ Ensure your identity provider is correctly configured and accessible:
3434
::: zone pivot="github"
3535

3636
1. Verify your GitHub repository has Actions enabled.
37-
2. Confirm the OIDC provider settings are correctly configured in your workflow.
37+
2. Confirm the OpenID Connect (OIDC) provider settings are correctly configured in your workflow.
3838
3. Ensure the audience claim in your workflow matches the authenticator configuration.
3939

4040
::: zone-end
@@ -175,7 +175,7 @@ Example configuration:
175175

176176
### Step 4: Decode and verify JWT tokens
177177

178-
Obtain and inspect the JWT token to verify claims:
178+
To verify claims obtain and inspect the JWT token:
179179

180180
::: zone pivot="github"
181181

@@ -206,7 +206,7 @@ Obtain and inspect the JWT token to verify claims:
206206
2. Decode the token at [jwt.ms][jwt-ms] and verify:
207207
- The `iss` claim matches your issuer URL exactly
208208
- The `aud` claim matches your configured audience
209-
- The token is not expired (`exp` claim)
209+
- The token isn't expired (`exp` claim)
210210
- Required claims for username and groups are present
211211
- Claims match the format expected by your CEL expressions
212212

0 commit comments

Comments
 (0)