Add Okta as a trusted source for AWS roles

After you configure Okta as the Amazon Web Services (AWS) account identity provider, you create or update existing IAM roles for Okta to retrieve and assign to users. Okta can only provide single sign-on (SSO) for users with roles that have been configured to grant access to the Okta SAML identity provider you configured in Add Okta as a trusted source for AWS roles.

  1. On the AWS Management Console, click Roles in the left pane.
  2. Click Create New Role.
  3. Click SAML 2.0 federation.
  4. Select Okta from the SAML provider drop-down list and then select Allow programmatic and AWS Management Console access.
  5. Click Next: Permissions.
  6. Select a permissions policy and click Next: Tags.
  7. Optional. Add descriptive tags for the role and click Next: Review.
  8. Enter a role name in the Role name field, add an optional description for the role, and click Create Role.
  9. Click the role name you created, click the Trust Relationship tab and then click Edit trust relationship.
  10. Select one of these options to permit Generate the AWS API access key SSO:
    • If the policy document is empty, you can copy and paste the provided policy and replace <COPY & PASTE SAML ARN VALUE HERE> with the Amazon Resource Name (ARN) value you copied from Add Okta as a trusted source for AWS roles.

{

"Version": "2012-10-17",

"Statement": [

{

"Effect": "Allow",

"Principal": {

"Federated": "<COPY & PASTE SAML ARN VALUE HERE>"

},

"Action": "sts:AssumeRoleWithSAML",

"Condition": {

"StringEquals": {

"SAML:aud": "https://signin.aws.amazon.com/saml"

}

}

}

]

}

    • Modify your existing policy document to include Generate the AWS API access key SSO access. You need to include everything within the Statement code block — including the configurations for Effect, Principal, Actions, and Conditions. Replace <COPY & PASTE SAML ARN VALUE HERE> with the ARN value you copied when you completed Add Okta as a trusted source for AWS roles.

  1. Click Update Trust Policy.

Next steps