Integrate an AWS account or organization

Learn how to complete an AWS integration in the Apono UI

Overview

Apono offers AWS users a simple way to centralize cloud management through our platform. Through a single integration, you can manage multiple AWS services across various accounts and organizations.



Integrate an AWS account

Prerequisites

  • Apono connector installed in your AWS account
  • To sync and manage access to EC2 servers, make sure you add the AmazonSSMManagedInstanceCore policy to the connector's IAM role

Integration

Integrating an Amazon account

Integrating an Amazon account

Follow these steps to integrate Apono with your AWS account:

  1. On the Catalog tab, click AWS. The Add a new integration page appears.

  2. Click Amazon Account. The account settings appear below.

  3. From the dropdown menu, select a connector. Choosing a connector links Apono to all the services available on the account where the connector is located.

    πŸ’‘

    If the desired connector is not listed, click + Add new connector and follow the instructions for creating an Apono connector.

  4. Under Select resource types, click one or more resource types and cloud services to sync with Apono.

    πŸ“˜

    Apono automatically discovers and syncs all the instances in the environment. After syncing, you can manage Access Flows to these resources.

  5. Click Next. The Complete setup page appears.

  6. Enter a unique, alphanumeric, user-friendly Integration Name. This name is used to identify this integration when constructing an access flow.

  7. From the Region dropdown menu, select the region in which your organization runs. You may only select one region.

  8. Click Connect.


After connecting your AWS account to Apono, you will be redirected to the Connected tab to view your integrations. The new AWS integration will initialize once it completes its first data fetch. Upon completion, the integration will be marked Active.

Now that you have completed this integration, you can create access flows that grant permission to AWS IAM resources, such as AWS Roles.



Integrate an AWS organization

Prerequisites


Integration

Integrating an Amazon organization

Integrating an Amazon organization

Follow these steps to integrate Apono with your AWS organization:

  1. On the Catalog tab, click AWS. The Add a new integration page appears.

  2. Click Amazon Organization. The account settings appear below.

  3. From the dropdown menu, select a connector. Choosing a connector links Apono to all the services available on the account where the connector is located.

    πŸ’‘

    If the desired connector is not listed, click + Add new connector and follow the instructions for creating an AWS connector.

  4. Under Select resource types, click one or more resource types and cloud services to sync with Apono.

    πŸ“˜

    Apono automatically discovers and syncs all the instances in the environment. After syncing, you can manage Access Flows to these resources.

  5. Click Next. The Complete setup page appears.

  6. Enter a unique, alphanumeric, user-friendly Integration Name. This name is used to identify this integration when constructing an access flow.

  7. From the Region dropdown menu, select the region in which your organization runs. You may only select one region.

  8. From the AWS SSO Region dropdown menu, select the region for which your single sign-on is configured. You may only select one region.

    πŸ“˜

    AWS SSO Region defaults to the same value as your Region field.

  9. Under SSO Portal, enter your single sign-on URL.

    1. This is required for Apono to generate a sign-in link for end users to use their granted access.
  10. (For connectors with delegate permissions) Under Manage Account Role, enter the ARN (step 5) of the role you are to assume.

  11. Click Connect.


After connecting your AWS account to Apono, you will be redirected to the Connected tab to view your integrations. The new AWS integration will initialize once it completes its first data fetch. Upon completion, the integration will be marked Active.

Now that you have completed this integration, you can create access flows that grant permission to AWS IAM resources, such as AWS Roles.



Troubleshooting

Please refer to our troubleshooting guide if you encounter errors while integrating.