12 KiB
12 KiB
Release History
1.2.1 (2023-01-26)
Other Changes
- Upgrade MSAL to v0.8.1
1.3.0-beta.2 (2023-01-10)
Features Added
- Added
OnBehalfOfCredentialto support the on-behalf-of flow (#16642)
Bugs Fixed
AzureCLICredentialreports token expiration in local time (should be UTC)
Other Changes
AzureCLICredentialimposes its default timeout only when theContextpassed toGetToken()has no deadline- Added
NewCredentialUnavailableError(). This function constructs an error indicating a credential can't authenticate and an encompassingChainedTokenCredentialshould try its next credential, if any.
1.3.0-beta.1 (2022-12-13)
Features Added
WorkloadIdentityCredentialandDefaultAzureCredentialsupport Workload Identity Federation on Kubernetes.DefaultAzureCredentialsupport requires environment variable configuration as set by the Workload Identity webhook. (#15615)
1.2.0 (2022-11-08)
Other Changes
- This version includes all fixes and features from 1.2.0-beta.*
1.2.0-beta.3 (2022-10-11)
Features Added
ManagedIdentityCredentialcaches tokens in memory
Bugs Fixed
ClientCertificateCredentialsends only the leaf cert for SNI authentication
1.2.0-beta.2 (2022-08-10)
Features Added
- Added
ClientAssertionCredentialto enable applications to authenticate with custom client assertions
Other Changes
- Updated AuthenticationFailedError with links to TROUBLESHOOTING.md for relevant errors
- Upgraded
microsoft-authentication-library-for-gorequirement to v0.6.0
1.2.0-beta.1 (2022-06-07)
Features Added
EnvironmentCredentialreads certificate passwords fromAZURE_CLIENT_CERTIFICATE_PASSWORD(#17099)
1.1.0 (2022-06-07)
Features Added
ClientCertificateCredentialandClientSecretCredentialsupport ESTS-R. First-party applications can set environment variableAZURE_REGIONAL_AUTHORITY_NAMEwith a region name. (#15605)
1.0.1 (2022-06-07)
Other Changes
- Upgrade
microsoft-authentication-library-for-gorequirement to v0.5.1 (#18176)
1.0.0 (2022-05-12)
Features Added
DefaultAzureCredentialreads environment variableAZURE_CLIENT_IDfor the client ID of a user-assigned managed identity (#17293)
Breaking Changes
- Removed
AuthorizationCodeCredential. UseInteractiveBrowserCredentialinstead to authenticate a user with the authorization code flow. - Instances of
AuthenticationFailedErrorare now returned by pointer. GetToken()returnsazcore.AccessTokenby value
Bugs Fixed
AzureCLICredentialpanics after receiving an unexpected error type (#17490)
Other Changes
GetToken()returns an error when the caller specifies no scope- Updated to the latest versions of
golang.org/x/crypto,azcoreandinternal
0.14.0 (2022-04-05)
Breaking Changes
- This module now requires Go 1.18
- Removed
AuthorityHost. Credentials are now configured for sovereign or private clouds with the API inazcore/cloud, for example:// before opts := azidentity.ClientSecretCredentialOptions{AuthorityHost: azidentity.AzureGovernment} cred, err := azidentity.NewClientSecretCredential(tenantID, clientID, secret, &opts) // after import "github.com/Azure/azure-sdk-for-go/sdk/azcore/cloud" opts := azidentity.ClientSecretCredentialOptions{} opts.Cloud = cloud.AzureGovernment cred, err := azidentity.NewClientSecretCredential(tenantID, clientID, secret, &opts)
0.13.2 (2022-03-08)
Bugs Fixed
- Prevented a data race in
DefaultAzureCredentialandChainedTokenCredential(#17144)
Other Changes
- Upgraded App Service managed identity version from 2017-09-01 to 2019-08-01 (#17086)
0.13.1 (2022-02-08)
Features Added
EnvironmentCredentialsupports certificate SNI authentication whenAZURE_CLIENT_SEND_CERTIFICATE_CHAINis "true". (#16851)
Bugs Fixed
ManagedIdentityCredential.GetToken()now returns an error when configured for a user assigned identity in Azure Cloud Shell (which doesn't support such identities) (#16946)
Other Changes
NewDefaultAzureCredential()logs non-fatal errors. These errors are also included in the error returned byDefaultAzureCredential.GetToken()when it's unable to acquire a token from any source. (#15923)
0.13.0 (2022-01-11)
Breaking Changes
- Replaced
AuthenticationFailedError.RawResponse()with a field having the same name - Unexported
CredentialUnavailableError - Instances of
ChainedTokenCredentialwill now skip looping through the list of source credentials and re-use the first successful credential on subsequent calls toGetToken.- If
ChainedTokenCredentialOptions.RetrySourcesis true,ChainedTokenCredentialwill continue to try all of the originally provided credentials each time theGetTokenmethod is called. ChainedTokenCredential.successfulCredentialwill contain a reference to the last successful credential.DefaultAzureCredenialwill also re-use the first successful credential on subsequent calls toGetToken.DefaultAzureCredential.chain.successfulCredentialwill also contain a reference to the last successful credential.
- If
Other Changes
ManagedIdentityCredentialno longer probes IMDS before requesting a token from it. Also, an error response from IMDS no longer disables a credential instance. Following an error, a credential instance will continue to send requests to IMDS as necessary.- Adopted MSAL for user and service principal authentication
- Updated
azcorerequirement to 0.21.0
0.12.0 (2021-11-02)
Breaking Changes
- Raised minimum go version to 1.16
- Removed
NewAuthenticationPolicy()from credentials. Clients should instead use azcore'sruntime.NewBearerTokenPolicy()to construct a bearer token authorization policy. - The
AuthorityHostfield in credential options structs is now a custom type,AuthorityHost, with underlying typestring NewChainedTokenCredentialhas a new signature to accommodate a placeholder options struct:// before cred, err := NewChainedTokenCredential(credA, credB) // after cred, err := NewChainedTokenCredential([]azcore.TokenCredential{credA, credB}, nil)- Removed
ExcludeAzureCLICredential,ExcludeEnvironmentCredential, andExcludeMSICredentialfromDefaultAzureCredentialOptions NewClientCertificateCredentialrequires a[]*x509.Certificateandcrypto.PrivateKeyinstead of a path to a certificate file. AddedParseCertificatesto simplify getting these in common cases:// before cred, err := NewClientCertificateCredential("tenant", "client-id", "/cert.pem", nil) // after certData, err := os.ReadFile("/cert.pem") certs, key, err := ParseCertificates(certData, password) cred, err := NewClientCertificateCredential(tenantID, clientID, certs, key, nil)- Removed
InteractiveBrowserCredentialOptions.ClientSecretand.Port - Removed
AADAuthenticationFailedError - Removed
idparameter ofNewManagedIdentityCredential(). User assigned identities are now specified byManagedIdentityCredentialOptions.ID:// before cred, err := NewManagedIdentityCredential("client-id", nil) // or, for a resource ID opts := &ManagedIdentityCredentialOptions{ID: ResourceID} cred, err := NewManagedIdentityCredential("/subscriptions/...", opts) // after clientID := ClientID("7cf7db0d-...") opts := &ManagedIdentityCredentialOptions{ID: clientID} // or, for a resource ID resID: ResourceID("/subscriptions/...") opts := &ManagedIdentityCredentialOptions{ID: resID} cred, err := NewManagedIdentityCredential(opts) DeviceCodeCredentialOptions.UserPrompthas a new type:func(context.Context, DeviceCodeMessage) error- Credential options structs now embed
azcore.ClientOptions. In addition to changing literal initialization syntax, this change renamesHTTPClientfields toTransport. - Renamed
LogCredentialtoEventCredential AzureCLICredentialno longer reads the environment variableAZURE_CLI_PATHNewManagedIdentityCredentialno longer reads environment variablesAZURE_CLIENT_IDandAZURE_RESOURCE_ID. UseManagedIdentityCredentialOptions.IDinstead.- Unexported
AuthenticationFailedErrorandCredentialUnavailableErrorstructs. In their place are two interfaces having the same names.
Bugs Fixed
AzureCLICredential.GetTokenno longer mutates itsopts.Scopes
Features Added
- Added connection configuration options to
DefaultAzureCredentialOptions AuthenticationFailedError.RawResponse()returns the HTTP response motivating the error, if available
Other Changes
NewDefaultAzureCredential()returns*DefaultAzureCredentialinstead of*ChainedTokenCredential- Added
TenantIDfield toDefaultAzureCredentialOptionsandAzureCLICredentialOptions
0.11.0 (2021-09-08)
Breaking Changes
- Unexported
AzureCLICredentialOptions.TokenProviderand its type,AzureCLITokenProvider
Bug Fixes
ManagedIdentityCredential.GetTokenreturnsCredentialUnavailableErrorwhen IMDS has no assigned identity, signalingDefaultAzureCredentialto try other credentials
0.10.0 (2021-08-30)
Breaking Changes
- Update based on
azcorerefactor #15383
0.9.3 (2021-08-20)
Bugs Fixed
ManagedIdentityCredential.GetTokenno longer mutates itsopts.Scopes
Other Changes
- Bumps version of
azcoretov0.18.1
0.9.2 (2021-07-23)
Features Added
- Adding support for Service Fabric environment in
ManagedIdentityCredential - Adding an option for using a resource ID instead of client ID in
ManagedIdentityCredential
0.9.1 (2021-05-24)
Features Added
- Add LICENSE.txt and bump version information
0.9.0 (2021-05-21)
Features Added
- Add support for authenticating in Azure Stack environments
- Enable user assigned identities for the IMDS scenario in
ManagedIdentityCredential - Add scope to resource conversion in
GetToken()onManagedIdentityCredential
0.8.0 (2021-01-20)
Features Added
- Updating documentation
0.7.1 (2021-01-04)
Features Added
- Adding port option to
InteractiveBrowserCredential
0.7.0 (2020-12-11)
Features Added
- Add
redirectURIparameter back to authentication code flow
0.6.1 (2020-12-09)
Features Added
- Updating query parameter in
ManagedIdentityCredentialand updating datetime string for parsing managed identity access tokens.
0.6.0 (2020-11-16)
Features Added
- Remove
RedirectURLparameter from auth code flow to align with the MSAL implementation which relies on the native client redirect URL.
0.5.0 (2020-10-30)
Features Added
- Flattening credential options
0.4.3 (2020-10-21)
Features Added
- Adding Azure Arc support in
ManagedIdentityCredential
0.4.2 (2020-10-16)
Features Added
- Typo fixes
0.4.1 (2020-10-16)
Features Added
- Ensure authority hosts are only HTTPs
0.4.0 (2020-10-16)
Features Added
- Adding options structs for credentials
0.3.0 (2020-10-09)
Features Added
- Update
DeviceCodeCredentialcallback
0.2.2 (2020-10-09)
Features Added
- Add
AuthorizationCodeCredential
0.2.1 (2020-10-06)
Features Added
- Add
InteractiveBrowserCredential
0.2.0 (2020-09-11)
Features Added
- Refactor
azidentityon top ofazcorerefactor - Updated policies to conform to
policy.Policyinterface changes. - Updated non-retriable errors to conform to
azcore.NonRetriableError. - Fixed calls to
Request.SetBody()to include content type. - Switched endpoints to string types and removed extra parsing code.
0.1.1 (2020-09-02)
Features Added
- Add
AzureCLICredentialtoDefaultAzureCredentialchain
0.1.0 (2020-07-23)
Features Added
- Initial Release. Azure Identity library that provides Azure Active Directory token authentication support for the SDK.