Documentation is now available for the Fall 2020 Update release!

Install AWS integration using IAM

Describes how to set up an AWS integration using IAM 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. IAM is a web service that helps in securely controlling access to AWS services. For more information, see What is IAM?

Workflow

Process Flow - Installing AWS integration with IAM credentials

Process Flow - Install AWS integration with IAM credentials

AWS configuration

To configure AWS integration:

  1. Sign in to your root account in the AWS management console.
  2. On the navigation bar, click your account name, and then choose My Security Credentials.
  3. From the Identity and Access Management navigation pane, click Users > Add user and give a suitable name to the new user.
    Familiarize yourself with Creating users on AWS console.
  4. 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.
  5. 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).
  6. (Optional) Add metadata to the user by attaching tags as key-value pairs and click Next: Review to see the details.
  7. Click Create user.
    The page displays the user’s access key ID and secret access keys.
  8. 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.
    • Account Number: Provide the root account number.
    • Access Key: Provide Access Key generated in the AWS console.
    • Security Key: Provide Security Key generated in the AWS console.
    • 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 displays the credentials of the AWS account integration and discovery profiles.