You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 762d184
Browse filesBrowse the repository at this point in the historyBrowse files
[Identity] Prepare 1.27.0 stable release with AKS identity bindings (#49612)
* Restore Workload Identity binding mode beta
Restores changes from #43287 and the enable_azure_proxy rename from #44147.
Original commits: 4250940, 06a83c8
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Restore credential pipeline policy overrides beta
Restores the beta changes from #46072.
Original commit: 8ee83e6
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Restore Azure Developer CLI error parsing
Restores the changes from #46711.
Original commit: 2240bf9
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Start azure-identity 1.27.0b1 development
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Prepare Azure Identity 1.27.0 stable release
Promote the beta version and classifier, update the release notes, and document AKS identity binding opt-in for sync and async credentials.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 4a948ec8-c74c-4b82-86a8-03f911bd3538
* address ccr
* remove override feat for now
* Fix CA rotation test file replacement on Windows
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 72672081-9f02-41bf-9f12-845073743ebe
* account for older aiohttp versions lacking param
* forward nonconflicting kwargs from workload identity, address older aiohttp incompat
* Fix identity binding token cache endpoint and checks
Preserve the original Entra endpoint for cache bookkeeping when the binding transport rewrites the request URL. Cover prefixed proxies, retries, and CAE across all binding transports, and fix spelling and lint checks.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 971d1bd8-4d07-4f3a-a701-c01e5a94448e
---------
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 4a948ec8-c74c-4b82-86a8-03f911bd3538
Copilot-Session: 31f45d49-d082-4af0-b593-69816d20dce1
Copilot-Session: 72672081-9f02-41bf-9f12-845073743ebe
Copilot-Session: 971d1bd8-4d07-4f3a-a701-c01e5a94448e
Copy file name to clipboardExpand all lines: sdk/identity/azure-identity/CHANGELOG.md
+7-1Lines changed: 7 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,9 +1,15 @@
1
1
# Release History
2
2
3
-
## 1.26.1 (Unreleased)
3
+
## 1.27.0 (Unreleased)
4
+
5
+
### Features Added
6
+
7
+
- Added support for `WorkloadIdentityCredential` identity binding mode in AKS environments. This feature uses an AKS proxy to handle FIC exchanges on behalf of pods, addressing Entra's limit on federated identity credentials per managed identity. Enable it by constructing `WorkloadIdentityCredential` directly with `enable_azure_proxy=True`. Identity binding mode isn't supported through `DefaultAzureCredential`. ([#43287](https://github.com/Azure/azure-sdk-for-python/pull/43287), [#44147](https://github.com/Azure/azure-sdk-for-python/pull/44147))
4
8
5
9
### Bugs Fixed
6
10
11
+
- Fixed `AzureDeveloperCliCredential` to correctly parse error messages from Azure Developer CLI v1.23.7 and later, which previously caused raw JSON to surface in `ClientAuthenticationError` instead of the underlying error text. ([#46711](https://github.com/Azure/azure-sdk-for-python/pull/46711))
12
+
- Fixed persistent token cache isolation on macOS when using custom cache names or CAE-enabled caches. ([#49314](https://github.com/Azure/azure-sdk-for-python/pull/49314))
7
13
- Fixed a regression in 1.26.0 where asynchronous `OnBehalfOfCredential` instances could not reuse access or refresh tokens cached by another instance with the same user assertion. Cache entries are now isolated by user assertion, allowing safe reuse across instances, including with `TokenCachePersistenceOptions`. Existing cache entries without assertion binding require a fresh token exchange. ([#49533](https://github.com/Azure/azure-sdk-for-python/pull/49533))
[`WorkloadIdentityCredential`][workload_id_cred_ref] supports [AKS identity bindings](https://learn.microsoft.com/azure/aks/identity-bindings), which allow multiple clusters to share a federated identity credential for a user-assigned managed identity.
108
+
109
+
After configuring an identity binding and authorizing the pod's Kubernetes service account, construct `WorkloadIdentityCredential` directly with `enable_azure_proxy=True`:
110
+
111
+
```python
112
+
from azure.identity import WorkloadIdentityCredential
113
+
114
+
with WorkloadIdentityCredential(enable_azure_proxy=True) as credential:
AKS supplies the pod's identity, projected-token, proxy, SNI, and CA configuration. Identity binding mode isn't supported through `DefaultAzureCredential`. The asynchronous `WorkloadIdentityCredential` in `azure.identity.aio` supports the same option.
119
+
105
120
## Cloud configuration
106
121
107
122
Credentials default to authenticating to the Microsoft Entra endpoint for Azure Public Cloud. To access resources in other clouds, such as Azure Government or a private cloud, configure credentials with the `authority` argument. [AzureAuthorityHosts](https://aka.ms/azsdk/python/identity/docs#azure.identity.AzureAuthorityHosts) defines authorities for well-known clouds:
|WorkloadIdentityCredential authentication unavailable. The workload options are not fully configured|The `WorkloadIdentityCredential` requires `client_id`, `tenant_id` and `token_file_path` to authenticate with Microsoft Entra ID.| <ul><li>If using `DefaultAzureCredential` then:</li><ul><li>Ensure client ID is specified via the `workload_identity_client_id` keyword argument or the `AZURE_CLIENT_ID` env variable.</li><li>Ensure tenant ID is specified via the `AZURE_TENANT_ID` env variable.</li><li>Ensure token file path is specified via `AZURE_FEDERATED_TOKEN_FILE` env variable.</li><li>Ensure authority host is specified via `AZURE_AUTHORITY_HOST` env variable.</ul><li>If using `WorkloadIdentityCredential` then:</li><ul><li>Ensure tenant ID is specified via the `tenant_id` keyword argument or the `AZURE_TENANT_ID` env variable.</li><li>Ensure client ID is specified via the `client_id` keyword argument or the `AZURE_CLIENT_ID` env variable.</li><li>Ensure token file path is specified via the `token_file_path` keyword argument or the `AZURE_FEDERATED_TOKEN_FILE` environment variable. </li></ul></li><li>Consult the [product troubleshooting guide](https://azure.github.io/azure-workload-identity/docs/troubleshooting.html) for other issues.</li></ul>|
289
289
290
+
#### `ClientAuthenticationError` for applications using [Azure Kubernetes Service identity bindings](https://learn.microsoft.com/azure/aks/identity-bindings-concepts)
291
+
292
+
| Error Message |Description| Mitigation |
293
+
|---|---|---|
294
+
|<ul><li>AADSTS700211: No matching federated identity record found for presented assertion issuer ...</li><li>AADSTS700212: No matching federated identity record found for presented assertion audience 'api://AKSIdentityBinding'.</li></ul> |`WorkloadIdentityCredential` isn't configured to use the identity binding proxy|Set the `enable_azure_proxy` keyword argument to `True` when creating `WorkloadIdentityCredential`. Note that identity binding mode isn't supported when `WorkloadIdentityCredential` is used via `DefaultAzureCredential`. `WorkloadIdentityCredential` should be used directly in this scenario.|
295
+
296
+
For asynchronous identity binding requests, the credential uses aiohttp when it supports the `server_hostname` argument (aiohttp 3.9 and later). If aiohttp is missing or lacks this support, the credential falls back to Requests running in an executor thread.
297
+
298
+
Identity binding mode forwards `connection_timeout`, `read_timeout`, `connection_data_block_size`, and `use_env_settings` to its transport. It continues to select its own transport and session and uses the AKS-provided SNI and CA configuration; credential constructor options for custom transports, sessions, and TLS settings do not override that configuration.
299
+
300
+
Token caching uses the original Microsoft Entra endpoint, not the proxy URL. A path prefix in `AZURE_KUBERNETES_TOKEN_PROXY` therefore doesn't change the tenant used for cache entries or prevent token reuse.
0 commit comments