AWS SSO OIDC
IAM Identity Center OpenID Connect (OIDC) is a web service that enables a client (such as CLI or a native application) to register with IAM Identity Center.…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
IAM Identity Center OpenID Connect (OIDC) is a web service that enables a client (such as CLI or a
native application) to register with IAM Identity Center. The service also enables the client to fetch the
user’s access token upon successful authentication and authorization with IAM Identity Center.
API namespaces
IAM Identity Center uses the sso and identitystore API namespaces. IAM Identity Center
OpenID Connect uses the sso-oauth namespace.
Considerations for using this guide
Before you begin using this guide, we recommend that you first review the following
important information about how the IAM Identity Center OIDC service works.
The IAM Identity Center OIDC service currently implements only the portions of the OAuth 2.0 Device
Authorization Grant standard ( https://tools.ietf.org/html/rfc8628 ) that are necessary to enable single
sign-on authentication with the CLI.
With older versions of the CLI, the service only emits OIDC access tokens, so to
obtain a new token, users must explicitly re-authenticate. To access the OIDC flow that
supports token refresh and doesn’t require re-authentication, update to the latest CLI
version (1.27.10 for CLI V1 and 2.9.0 for CLI V2) with support for OIDC token refresh
and configurable IAM Identity Center session durations. For more information, see Configure Amazon Web Services access portal session duration .
The access tokens provided by this service grant access to all Amazon Web Services account
entitlements assigned to an IAM Identity Center user, not just a particular application.
The documentation in this guide does not describe the mechanism to convert the access
token into Amazon Web Services Auth (“sigv4”) credentials for use with IAM-protected Amazon Web Services service
endpoints. For more information, see GetRoleCredentials in the IAM Identity Center Portal API Reference
Guide .
For general information about IAM Identity Center, see What is
IAM Identity Center? in the IAM Identity Center User Guide .
Endpoints 3
- POSTCreate token with iAM
/token?aws_iam=tCreates and returns access and refresh tokens for authorized client applications that are authenticated using any IAM entity, such as a service role or user.… - POSTRegister client
/client/registerRegisters a public client with IAM Identity Center. This allows clients to perform authorization using the authorization code grant with Proof Key for Code… - POSTStart device authorization
/device_authorizationInitiates device authorization by requesting a pair of verification codes from the authorization service.
API details
- Base URL
https://oidc.{region}.amazonaws.com- Authentication
- AWS Signature Version 4 (requests signed with your AWS access key)
- Operations
- 3 operations on 3 pathsPOST 3
- Description format
- AWS Smithy model, API version
2019-06-10 - Links
- Documentation · OpenAPI document
- Listed from
- AWS Smithy API model (aws/api-models-aws) (Apache-2.0)
How to test the AWS SSO OIDC in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the AWS SSO OIDC collection, without the publisher's secrets.
- Add your credentialsThis API uses AWS Signature Version 4 (requests signed with your AWS access key). Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Create token with iAM” (POST /token?aws_iam=t), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the AWS SSO OIDC?
IAM Identity Center OpenID Connect (OIDC) is a web service that enables a client (such as CLI or a native application) to register with IAM Identity Center.… It is listed under Developer tools and has 3 endpoints.
Who publishes the AWS SSO OIDC?
It is listed from Amazon Web Services, Inc.'s public API description (an OpenAPI document), not published by Amazon Web Services, Inc. on Swastik Codes. Anyone who controls amazonaws.com can claim the profile by adding a DNS TXT record.
What is the base URL of the AWS SSO OIDC?
Requests go to https://oidc.{region}.amazonaws.com. Endpoint paths are added to this base URL.
How do I authenticate with the AWS SSO OIDC?
With AWS Signature Version 4 (requests signed with your AWS access key).
How many endpoints does the AWS SSO OIDC have?
3 operations on 3 paths (3 POST).
Is forking the AWS SSO OIDC free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.