Skip to content

Commit 6ef7a60

Browse files
committed
Breaking announcement temp
1 parent 23e25d7 commit 6ef7a60

File tree

3 files changed

+46
-2
lines changed

3 files changed

+46
-2
lines changed
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
22
"id": "0b5b53ab-70c0-4c1b-a445-8663ae86d6d1",
33
"type": "misc",
4-
"description": "Change precedence of profile chain to: Static credentials, Assume role with source profile OR Assume role with naned provider, Web identity token, SSO session, Legacy SSO, Process"
4+
"description": "The order of credentials resolution in config files has been updated to: static credentials, assume role with source profile OR assume role with named provider, web identity token, SSO session, legacy SSO, process"
55
}
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
22
"id": "99a099e1-26c1-4ba1-b0d3-435609ea4e94",
33
"type": "misc",
4-
"description": "Change order of credentials provider chain to: System properties, Environment variables, Web identity tokens, Profile, ECS, EC2"
4+
"description": "The order of credentials resolution in the credentials provider chain has been updated to: system properties, environment variables, web identity tokens, profile, ECS, EC2"
55
}

.changes/announcement.md

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
An upcoming release of the **AWS SDK for Kotlin** will change the order of
2+
credentials resolution for the [default credentials provider chain](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/credential-providers.html#default-credential-provider-chain)
3+
and the order of credentials resolution for the AWS shared config files.
4+
5+
# Release date
6+
7+
This feature will ship with the **v1.4.x** release on xx/xx/xxxx.
8+
9+
# What's changing
10+
11+
The SDK will be changing the order in which credentials are resolved when
12+
using the default credentials provider chain. The new order will be:
13+
14+
1. System properties
15+
2. Environment variables
16+
3. Assume role with web identity token
17+
4. Shared credentials and config files (profile)
18+
5. Amazon ECS container credentials
19+
6. Amazon EC2 Instance Metadata Service
20+
21+
The [default credentials provider chain documentation](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/credential-providers.html#default-credential-provider-chain)
22+
contains more details on each credential source.
23+
24+
The SDK will also be changing the order in which credentials are resolved from
25+
in the shared credentials and config files. The new order will be:
26+
27+
1. Static credentials
28+
2. Assume role with source profile OR assume role with named provider (mutually exclusive)
29+
3. Web identity token
30+
4. SSO session
31+
5. Legacy SSO
32+
6. Process
33+
34+
# How to migrate
35+
36+
1. Upgrade all of your AWS SDK for Kotlin dependencies to **v.1.4.x**.
37+
2. Verify that the changes to the default credentials provider chain and credentials files do not introduce any issues in your program.
38+
3. If issues arise review the new credentials resolution order and adjust your configuration as needed.
39+
40+
# Feedback
41+
42+
If you have any questions concerning this change, please feel free to engage
43+
with us in this discussion. If you encounter a bug with these changes, please
44+
[file an issue](https://github.com/awslabs/aws-sdk-kotlin/issues/new/choose).

0 commit comments

Comments
 (0)