---
title: How do I connect new AWS accounts to my existing Opscompass tenant?
description: Once a user has been invited to Opscompass they can add an organization to be monitored by Opscompass as long as they are an administrator in AWS.
---

[Skip to content](https://kb.opscompass.com/knowledge/how-do-i-connect-new-aws-accounts-to-my-existing-opscompass-tenant#main-content)

[![Opscompass](https://kb.opscompass.com/hubfs/opscompass-logo-2024-web-small.svg)](https://opscompass.com)

- [Home](https://opscompass.com/)
- [Why Opscompass](https://opscompass.com/why-opscompass/)
- Product
  
  Show submenu for Product

    - [Inventory](https://opscompass.com/inventory/)
    - [Configuration Drift](https://opscompass.com/product/configuration-drift/)
    - [Compliance](https://opscompass.com/product/compliance/)
    - [Licenses](https://opscompass.com/solutions/licenses/)
- Solutions
  
  Show submenu for Solutions

    - [Hybrid and Multi-Cloud Visibility](https://opscompass.com/solutions/multi-cloud-visibility/)
- [About Us](https://opscompass.com/company/)

Open main navigation

Close main navigation

- [Home](https://opscompass.com/)
- [Why Opscompass](https://opscompass.com/why-opscompass/)
- Product
  
  Show submenu for Product

    - [Inventory](https://opscompass.com/inventory/)
    - [Configuration Drift](https://opscompass.com/product/configuration-drift/)
    - [Compliance](https://opscompass.com/product/compliance/)
    - [Licenses](https://opscompass.com/solutions/licenses/)
- Solutions
  
  Show submenu for Solutions

    - [Hybrid and Multi-Cloud Visibility](https://opscompass.com/solutions/multi-cloud-visibility/)
- [About Us](https://opscompass.com/company/)
- [Get a Demo](https://opscompass.com/demo/)

[Get a Demo](https://opscompass.com/demo/)

 What are you looking for?

- There are no suggestions because the search field is empty.

1. [Help Center](https://kb.opscompass.com/knowledge)
2. [Getting Started](https://kb.opscompass.com/knowledge/getting-started)
3. [Connecting Cloud Accounts](https://kb.opscompass.com/knowledge/getting-started#connecting-cloud-accounts)

# How do I connect new AWS accounts to my existing Opscompass tenant?

## Once a user has been invited to Opscompass they can add an organization to be monitored by Opscompass as long as they are an administrator in AWS.

1\) From the Opscompass dashboard, click "Add Account"  
![Screenshot 2023-09-21 at 10.28.48 AM](https://kb.opscompass.com/hs-fs/hubfs/Screenshot%202023-09-21%20at%2010.28.48%20AM.png?width=688&height=405&name=Screenshot%202023-09-21%20at%2010.28.48%20AM.png)

2.) Click the "Connect Amazon Web Services" button. 

![Screenshot 2023-09-22 at 1.04.26 PM](https://kb.opscompass.com/hs-fs/hubfs/Screenshot%202023-09-22%20at%201.04.26%20PM.png?width=688&height=256&name=Screenshot%202023-09-22%20at%201.04.26%20PM.png)

3.) Create the "Opscompass Viewer IAM Role" which will launch a CloudFormation template.

![Screenshot 2023-09-22 at 1.05.05 PM](https://kb.opscompass.com/hs-fs/hubfs/Screenshot%202023-09-22%20at%201.05.05%20PM.png?width=688&height=300&name=Screenshot%202023-09-22%20at%201.05.05%20PM.png)

4.) Before you "Create stack" on this CloudFormation template confirm the ExternalID parameter from the previous screen matches. 

![Image of the Create stack AWS page](https://kb.opscompass.com/hs-fs/hubfs/3-1.png?width=688&name=3-1.png)

5.) Upon completion of the stack creation, navigate to the newly created OpsCompassViewer Role (link provided on screen for convenience).

![Screenshot 2023-09-22 at 1.05.05 PM](https://kb.opscompass.com/hs-fs/hubfs/Screenshot%202023-09-22%20at%201.05.05%20PM.png?width=688&height=300&name=Screenshot%202023-09-22%20at%201.05.05%20PM.png)

6.) Copy the Role ARN at the top as well as the External ID Value (found in "Trust relationships").

![Image of the AWS Summary page](https://kb.opscompass.com/hs-fs/hubfs/5-3.png?width=688&name=5-3.png)

7.) Paste the Role ARN and External ID Value (from step 6) into Opscompass and "Connect".

![Screenshot 2023-09-22 at 1.05.05 PM](https://kb.opscompass.com/hs-fs/hubfs/Screenshot%202023-09-22%20at%201.05.05%20PM.png?width=688&height=300&name=Screenshot%202023-09-22%20at%201.05.05%20PM.png)

8a.) \*Optional\* For the full event based scanning experience, set up Opscompass to be notified of changes in near real time.

Note: If this step is skipped, APIs will be polled approximately every 8 hours. 

![Image of the inventory scanning modal](https://kb.opscompass.com/hs-fs/hubfs/7-2.png?width=473&name=7-2.png)

8b.) "Create stack" for event forwarding. 

![Image of the Event Capturing page](https://kb.opscompass.com/hs-fs/hubfs/8-2.png?width=688&name=8-2.png)

 

Opscompass will begin to scan the environment. You will see the account added to the dashboard, resources populated in the inventory and mapped to the compliance frameworks associated with your Opscompass account.

- [About Opscompass](https://kb.opscompass.com/knowledge/about-opscompass#main-content)

    - [Company Information](https://kb.opscompass.com/knowledge/about-opscompass#company-information)
- [Getting Started](https://kb.opscompass.com/knowledge/getting-started#main-content)

    - [Logging In](https://kb.opscompass.com/knowledge/getting-started#logging-in)
    - [Connecting Cloud Accounts](https://kb.opscompass.com/knowledge/getting-started#connecting-cloud-accounts)
    - [Users and Teams](https://kb.opscompass.com/knowledge/getting-started#users-and-teams)
- [Opscompass CLI](https://kb.opscompass.com/knowledge/opscompass-cli#main-content)

    - [Getting Started](https://kb.opscompass.com/knowledge/opscompass-cli#getting-started)
    - [Resources](https://kb.opscompass.com/knowledge/opscompass-cli#resources)
    - [Accounts](https://kb.opscompass.com/knowledge/opscompass-cli#accounts)
    - [Compliance](https://kb.opscompass.com/knowledge/opscompass-cli#compliance)
    - [Licensing](https://kb.opscompass.com/knowledge/opscompass-cli#licensing)
    - [Examples](https://kb.opscompass.com/knowledge/opscompass-cli#examples)
    - [AI Skills](https://kb.opscompass.com/knowledge/opscompass-cli#ai-skills)
- [Opscompass FAQs](https://kb.opscompass.com/knowledge/opscompass-faqs#main-content)

    - [General](https://kb.opscompass.com/knowledge/opscompass-faqs#general)
- [New Features](https://kb.opscompass.com/knowledge/new-features)
- [Account Management](https://kb.opscompass.com/knowledge/account-management)
- [Compliance](https://kb.opscompass.com/knowledge/compliance)
- [Documents](https://kb.opscompass.com/knowledge/documents)
- [Drift](https://kb.opscompass.com/knowledge/drift)
- [Inventory](https://kb.opscompass.com/knowledge/inventory)
- [Licenses](https://kb.opscompass.com/knowledge/licenses#main-content)

    - [Oracle](https://kb.opscompass.com/knowledge/licenses#oracle)
    - [SQL Server](https://kb.opscompass.com/knowledge/licenses#sql-server)
- [Navigation and Dashboard](https://kb.opscompass.com/knowledge/navigation-and-dashboard)
- [Opscompass Integrations](https://kb.opscompass.com/knowledge/opscompass-integrations)
- [Tutorials](https://kb.opscompass.com/knowledge/tutorials#main-content)

    - [CLI](https://kb.opscompass.com/knowledge/tutorials#cli)

[![Opscompass](https://kb.opscompass.com/hubfs/opscompass-logo-2024-web-small.svg "Opscompass")](http://opscompass.com)

<https://opscompass.com/contact/> <https://www.linkedin.com/company/opscompass/>

Copyright © 2025, Opscompass