Skip to content

Commit 59dd1d0

Browse files
Merge branch 'release-1.18.23'
* release-1.18.23: Bumping version to 1.18.23 Add changelog entries from botocore Add user guide for SSO provider usage
2 parents 730e41d + 3217a68 commit 59dd1d0

File tree

6 files changed

+72
-3
lines changed

6 files changed

+72
-3
lines changed

Diff for: .changes/1.18.23.json

+27
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
[
2+
{
3+
"category": "``cloud9``",
4+
"description": "[``botocore``] Added DryRun parameter to CreateEnvironmentEC2 API. Added ManagedCredentialsActions parameter to UpdateEnvironment API",
5+
"type": "api-change"
6+
},
7+
{
8+
"category": "``ec2``",
9+
"description": "[``botocore``] This release adds support for EC2 ED25519 key pairs for authentication",
10+
"type": "api-change"
11+
},
12+
{
13+
"category": "``clouddirectory``",
14+
"description": "[``botocore``] Documentation updates for clouddirectory",
15+
"type": "api-change"
16+
},
17+
{
18+
"category": "``ce``",
19+
"description": "[``botocore``] This release is a new feature for Cost Categories: Split charge rules. Split charge rules enable you to allocate shared costs between your cost category values.",
20+
"type": "api-change"
21+
},
22+
{
23+
"category": "``logs``",
24+
"description": "[``botocore``] Documentation-only update for CloudWatch Logs",
25+
"type": "api-change"
26+
}
27+
]

Diff for: CHANGELOG.rst

+10
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,16 @@
22
CHANGELOG
33
=========
44

5+
1.18.23
6+
=======
7+
8+
* api-change:``cloud9``: [``botocore``] Added DryRun parameter to CreateEnvironmentEC2 API. Added ManagedCredentialsActions parameter to UpdateEnvironment API
9+
* api-change:``ec2``: [``botocore``] This release adds support for EC2 ED25519 key pairs for authentication
10+
* api-change:``clouddirectory``: [``botocore``] Documentation updates for clouddirectory
11+
* api-change:``ce``: [``botocore``] This release is a new feature for Cost Categories: Split charge rules. Split charge rules enable you to allocate shared costs between your cost category values.
12+
* api-change:``logs``: [``botocore``] Documentation-only update for CloudWatch Logs
13+
14+
515
1.18.22
616
=======
717

Diff for: boto3/__init__.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@
1818

1919

2020
__author__ = 'Amazon Web Services'
21-
__version__ = '1.18.22'
21+
__version__ = '1.18.23'
2222

2323

2424
# The default Boto3 session; autoloaded when needed.

Diff for: docs/source/guide/credentials.rst

+32
Original file line numberDiff line numberDiff line change
@@ -232,6 +232,38 @@ This provider can also be configured via environment variables:
232232

233233
These environment variables currently only apply to the assume role with web identity provider and do not apply to the general assume role provider configuration.
234234

235+
AWS Single Sign-On Provider (SSO)
236+
-----------------------------------
237+
238+
Support for the AWS Single Sign-On (SSO) credential provider was added in 1.14.0.
239+
240+
To begin using the SSO credential provider, start by using the AWS CLI V2 to configure and manage your SSO profiles and login sessions.
241+
For detailed instructions on the configuration and login process see the `AWS CLI User Guide for SSO <https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sso.html>`_.
242+
Once completed you will have one or many profiles in the shared configuration file with the following settings:
243+
244+
.. code-block:: ini
245+
246+
# In ~/.aws/config
247+
[profile my-sso-profile]
248+
sso_start_url = https://my-sso-portal.awsapps.com/start
249+
sso_region = us-east-1
250+
sso_account_id = 123456789011
251+
sso_role_name = readOnly
252+
253+
* ``sso_start_url`` - The URL that points to the organization's AWS SSO user portal.
254+
* ``sso_region`` - The AWS Region that contains the AWS SSO portal host. This is separate from, and can be a different region than the default CLI region parameter.
255+
* ``sso_account_id`` - The AWS account ID that contains the IAM role that you want to use with this profile.
256+
* ``sso_role_name`` - The name of the IAM role that defines the user's permissions when using this profile.
257+
258+
You can then specify the profile name via the ``AWS_PROFILE`` environment variable or the ``profile_name`` argument when creating a ``Session``.
259+
For example, we can create a Session using the ``my-sso-profile`` profile and any clients created from this session will use the ``my-sso-profile`` credentials:
260+
261+
.. code-block:: python
262+
263+
import boto3
264+
265+
session = boto3.Session(profile_name='my-sso-profile')
266+
s3_client = session.client('s3')
235267
236268
Boto 2 config
237269
---------------

Diff for: setup.cfg

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ universal = 0
33

44
[metadata]
55
requires_dist =
6-
botocore>=1.21.22,<1.22.0
6+
botocore>=1.21.23,<1.22.0
77
jmespath>=0.7.1,<1.0.0
88
s3transfer>=0.5.0,<0.6.0
99

Diff for: setup.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414

1515

1616
requires = [
17-
'botocore>=1.21.22,<1.22.0',
17+
'botocore>=1.21.23,<1.22.0',
1818
'jmespath>=0.7.1,<1.0.0',
1919
's3transfer>=0.5.0,<0.6.0'
2020
]

0 commit comments

Comments
 (0)