PingOne Privilege

Onboarding Amazon Web Services (AWS) accounts

When you add an AWS account to PingOne Privilege, its resources are discovered automatically and can be managed for just-in-time (JIT) developer access.

To onboard either a single AWS account or an entire AWS Organization Unit (OU):

  1. In the PingOne Privilege admin console, go to Cloud > Clouds.

  2. Click Add Account Wizard.

    The Add Account modal displays.

    • Ensure the AWS icon is selected.

    • In the Name and Description fields, enter identifying details for the connection. Click Next.

    • For an Organization Unit (OU), click Yes. Otherwise, click No. Click Next

      aws 1
  3. Copy the provided CloudFormation (CFN) template.

  4. In your AWS management account, deploy the CloudFormation template.

    aws 2

    You must have sufficient IAM permissions to create roles and other required resources. During deployment, provide the following parameters when prompted:

    • AutoProxyDeploy: Select Enabled to deploy the proxy infrastructure automatically in your VPC.

    • ExternalID: Enter a unique, memorable string that acts as a shared secret.

    • OrgID (OU Only): Enter the ID of the AWS Organization Unit you are onboarding.

  5. After the CloudFormation stack is successfully created, go to its Outputs tab and copy the generated values.

  6. In the PingOne Privilege admin console, go to Cloud > Clouds.

  7. Enter the values copied from the CloudFormation stack outputs:

    • Cross Account Role ARN: The ARN of the role created by the template.

    • External ID: The same unique string you provided as a parameter.

    • Organization Unit (OU) ID (OU Only): The ID of the onboarded OU.

      aws 3
  8. Select Verify & Add Account.

Result

The AWS account or OU now opens in the Cloud Accounts list.

Validation

To ensure the onboarding process was successful:

  1. Sign on the AWS console for the onboarded account.

  2. Go to the IAM service.

  3. Select Identity providers.

  4. Verify that an identity provider exists with the name Procyon-<Your Teant Name>-<AWS Account Name>.