Skip to content

Commit ff903b8

Browse files
Merge pull request #234857 from MGoedtel/updateWIOverview418
update Workload Identity overview
2 parents d356d9c + d1969df commit ff903b8

File tree

1 file changed

+9
-10
lines changed

1 file changed

+9
-10
lines changed

articles/aks/workload-identity-overview.md

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,17 +2,19 @@
22
title: Use an Azure AD workload identities (preview) on Azure Kubernetes Service (AKS)
33
description: Learn about Azure Active Directory workload identity (preview) for Azure Kubernetes Service (AKS) and how to migrate your application to authenticate using this identity.
44
ms.topic: article
5-
ms.date: 03/28/2023
5+
ms.date: 04/18/2023
66

77
---
88

99
# Use Azure AD workload identity with Azure Kubernetes Service (AKS)
1010

11-
Azure AD Workload Identity leverages [Service Account Token Volume Projection](https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#serviceaccount-token-volume-projection) giving pods the ability to use a Kubernetes identity (service account), to which a Kubernetes token is issued and [OIDC federation](https://kubernetes.io/docs/reference/access-authn-authz/authentication/#openid-connect-tokens) which enables Kubernetes applications to access Azure cloud resources securely with Azure Active Directory based on annotated service accounts.
11+
Workloads deployed on an Azure Kubernetes Services (AKS) cluster require Azure Active Directory (Azure AD) application credentials or managed identities to access Azure AD protected resources, such as Azure Key Vault and Microsoft Graph. Azure AD workload identity integrates with the capabilities native to Kubernetes to federate with external identity providers.
12+
13+
[Azure AD workload identity][azure-ad-workload-identity] uses [Service Account Token Volume Projection][service-account-token-volume-projection] enabling pods to use a Kubernetes identity (that is, a service account). A Kubernetes token is issued and [OIDC federation][oidc-federation] enables Kubernetes applications to access Azure resources securely with Azure AD based on annotated service accounts.
1214

1315
Azure AD workload identity works especially well with the Azure Identity client library using the [Azure SDK][azure-sdk-download] and the [Microsoft Authentication Library][microsoft-authentication-library] (MSAL) if you're using [application registration][azure-ad-application-registration]. Your workload can use any of these libraries to seamlessly authenticate and access Azure cloud resources.
1416

15-
This article helps you understand this new authentication feature, and reviews the options available to plan your project strategy and potential migration from Pod Identity.
17+
This article helps you understand this new authentication feature, and reviews the options available to plan your project strategy and potential migration from Azure AD pod-managed identity.
1618

1719
## Dependencies
1820

@@ -68,7 +70,7 @@ The following diagram summarizes the authentication sequence using OpenID Connec
6870

6971
### Webhook Certificate Auto Rotation
7072

71-
Similar to other webhook addons, the certificate will be rotated by cluster certificate [auto rotation](https://learn.microsoft.com/azure/aks/certificate-rotation#certificate-auto-rotation) operation.
73+
Similar to other webhook addons, the certificate will be rotated by cluster certificate [auto rotation][auto-rotation] operation.
7274

7375
## Service account labels and annotations
7476

@@ -134,11 +136,11 @@ The following table summarizes our migration or deployment recommendations for w
134136
<!-- EXTERNAL LINKS -->
135137
[azure-sdk-download]: https://azure.microsoft.com/downloads/
136138
[custom-resource-definition]: https://kubernetes.io/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions/
137-
139+
[service-account-token-volume-projection]: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#serviceaccount-token-volume-projection
140+
[oidc-federation]: https://kubernetes.io/docs/reference/access-authn-authz/authentication/#openid-connect-tokens
138141
<!-- INTERNAL LINKS -->
139142
[use-azure-ad-pod-identity]: use-azure-ad-pod-identity.md
140143
[azure-ad-workload-identity]: ../active-directory/develop/workload-identities-overview.md
141-
[azure-instance-metadata-service]: ../virtual-machines/linux/instance-metadata-service.md
142144
[microsoft-authentication-library]: ../active-directory/develop/msal-overview.md
143145
[azure-ad-application-registration]: ../active-directory/develop/application-model.md#register-an-application
144146
[install-azure-cli]: /cli/azure/install-azure-cli
@@ -147,7 +149,4 @@ The following table summarizes our migration or deployment recommendations for w
147149
[deploy-configure-workload-identity-new-cluster]: workload-identity-deploy-cluster.md
148150
[tutorial-use-workload-identity]: ./learn/tutorial-kubernetes-workload-identity.md
149151
[workload-identity-migration-sidecar]: workload-identity-migrate-from-pod-identity.md
150-
[dotnet-azure-identity-client-library]: /dotnet/api/overview/azure/identity-readme
151-
[java-azure-identity-client-library]: /java/api/overview/azure/identity-readme
152-
[javascript-azure-identity-client-library]: /javascript/api/overview/azure/identity-readme
153-
[python-azure-identity-client-library]: /python/api/overview/azure/identity-readme
152+
[auto-rotation]: certificate-rotation.md#certificate-auto-rotation

0 commit comments

Comments
 (0)