Documentation is now available for the Fall 2020 Update release!

Install AWS integration using IAM AssumeRole

Describes how to set up an AWS integration using IAM AssumeRole credentials to discover and monitor AWS services.

Leave Feedback

When an AWS account is created, you are signed-in as a root user (a single sign-in entity) with unrestricted access to the subscribed AWS services, using an email and password unique to your organization. As a best practice, avoid using the root user account for basic tasks. Use Identity and Access Management (IAM) credentials to authorize OpsRamp to manage your resources.

Install the AWS integration on the OpsRamp console using Identity and Access Management (IAM) access key ID and secret access key with AssumeRole. IAM is a web service that helps in securely controlling access to AWS services. For more information, see What is IAM?

IAM role helps you establish a trust relationship between the trusting account and a trusted account. The trusting account owns the AWS services to be accessed and the trusted account contains the users who need access to the services. This operation provides temporary security credentials that enable access to AWS services in your account. To learn more, view Providing access to AWS accounts owned by third parties.

Prerequisites

  • You have an AWS root account (trusting account).
  • Create another AWS account (trusted account).

Workflow

Process Flow - Installing AWS integrations with IAM AssumeRole credentials

Process Flow - Install AWS integration with IAM AssumeRole credentials

AWS configuration

To install AWS with IAM AssumeRole credentials:
Step 1: Configure the trusting account.

  1. Sign into your AWS management console with your root account credentials and create a new role.
  2. Select the role type as Another AWS account.
  3. In the Account ID field, provide the AWS account ID to which you want to grant access, the trusted account.
  4. Click Next: Permissions.
  5. Click Create Policy.
  6. On the Create Policy page, click the JSON tab and paste the policy snippet given in the Appendix.
    To learn more about permission policy, refer to Creating IAM Policies (console).
  7. Click Review Policy and give a suitable name to the policy.
  8. Review the role and then click Create role.
    The details of the role created are displayed.
  9. Copy the Role ARN at a safe location in a text editor such as Notepad.

Step 2: Configure the trusted account.

  1. Sign in to your trusted account in AWS management console.
  2. From the navigation pane, click Users > Add user and give a suitable name to the new user.
    For details, see AWS documentation on Creating users on AWS console.
  3. Select programmatic access as a type of access and click Next: Permissions.
    Note: Programmatic access is for the users who require access to the API, AWS CLI, or Tools for Windows PowerShell. The programmatic access option creates an access key and security access key for each new user. On the Set permissions page, specify how you want to assign permissions to the user and click Next: Tags.
    Refer to Creating IAM Policies (console).
  4. (Optional) Add metadata to the user by attaching tags as key-value pairs and click Next: Review to see the details.
  5. Click Create user.
    The page displays the user’s access key ID and secret access keys.
  6. Save the access keys by clicking Download.csv at a safe location.

OpsRamp configuration

To configure AWS integration:

  1. Go to Setup > Integrations > Integrations.
  2. Click All Clients and from the drop-down list, select a client.
    The Available Integrations page opens.
  3. From the Available Integrations page, click Public Cloud and then click AWS.
  4. Click Install.
  5. On the Install AWS Integration page:
    • Name: Give a suitable name for the integration.
    • Region(s): Select the AWS region from the drop-down list. The services that belong to the selected region are onboarded.
      Note: You can select multiple regions to onboard the services. If you select two regions A and B, and if you are not authorized to access region B, then onboarding fails for both regions A and B.
    • AWSType: Select IAM with AssumeRole.
    • Account Number: Provide the account number of the trusted account.
    • Access Key: Provide Access Key generated in the AWS console of the trusted account.
    • Security Key: Provide Security Key generated in the AWS console of the trusted account.
    • AssumeRole ARN: Provide the AssumeRole ARN of the trusting account saved from Step 1.
    • External ID: (Optional) Provide the External ID if you want to grant access through this option.
    • Install All Linked Accounts: Select the check-box if you have landing zones configured for your AWS account and want to onboard the child account(s) under the root (trusting) account.
    • Click Install.
      The AWS icon appears in the list of installed integrations with the details such as installed time, installed by, and enable status.
  6. Click the AWS icon.
    The AWS integration page opens and the credentials and discovery profiles are displayed.