Skip to main content
Skip table of contents

Connecting AWS Monitoring

The following instructions will guide your team in setting up and configuring one or more AWS accounts to Dash continuous compliance monitoring. Teams will have to provide IAM permissions via Dash and CloudFormation to allow Dash to scan secondary AWS accounts.

What Will You Need?

  • AWS User With Administrator Permissions – (the CloudFormation template creates resources that require a higher permission set)

  • Existing Dash ComplyOps Account

  • About 5 minutes of time

Connecting An AWS Account

To connect one or more AWS accounts, take the following steps:

  1. Login to Dash ComplyOps at app.dashcomplyops.com

  2. Navigate to Compliance Center → Scan Configurations

  3. The page should look like this:

  1. Click the “Connect Account Environment” button

    1. You will be taken to the following page:

  1. Enter the following information into the fields:

    1. Account Name - A name defined by your team to identify the account you are connecting to monitoring (this can be a name of your choice)

    2. AWS Account ID - Enter the 12-digit AWS Account ID for the AWS account you want to connect to Dash monitoring. You can find this by logging into your AWS account and clicking on the top right user dropdown.

    3. Once you have entered the “Account Name” and “AWS Account ID” > Click “Run CloudFormation”

    4. In a new tab, you will be taken to AWS where you will need to login and grant Dash permission to scan this environment:

  1. In the new browser tab that just opened, please login to the AWS account using your user and password for the selected account.

    1. After logging it, you will be redirected to the CloudFormation setup page. It has already preloaded with the correct CloudFormation template and parameters.

    2. These parameters should be pre-filled and there is nothing to change on this screen.

      • Stack Name = dashscanrole

      • AWSAccountID = 452806217681

      • ExternalID = The External ID from the Dash Modal

  1. On this page, you must select the checkbox - “I acknowledge that AWS CloudFormation might create IAM resources with custom names

  2. Click the ‘Create Stack‘ button.  

  3. The CloudFormation template is now under way. It may take a few minutes until the CloudFormation template completes successfully. You will then see the status CREATE_COMPLETE.

 

  1. Now you can navigate back to the Dash Settings Page. Click the “Connect Account” button.

    1. The Dash application should recognize that you have connected the new AWS account to monitoring.

  1. You will be taken to a page for creating your first Scanset

    1. Scanset Name - Enter a name for this Scanset. This is how you will identify group of findings in Dash.

    2. Scanset Properties - Select AWS regions to scan and monitor in this Scanset

    3. Security Compliance Frameworks - Select security frameworks used for monitoring rulesets (HIPAA, SOC 2, etc)

    4. Once you have input all options click the “Save Scanset Configurations” button.

  1. Your first Scanset should now be connected.

    1. You can run an initial scan by clicking “Yes” in the popup modal

    2. You can edit this Scanset or create additional Scansets in the Compliance Center > “Scan Configurations” page mentioned in the documentation below

Creating A New Scanset

  1. Login to Dash ComplyOps at app.dashcomplyops.com

  2. Navigate to Compliance Center → Scan Configurations

  3. Since a cloud account and Scanset was created early, the page should look like this:

  1. To create a new Scanset > click the “Create New Scanset” button

    1. Note - If you want to modify regions/frameworks for an existing click edit on an existing Scanset

    2. You will see the following page:

  1. You will be prompted to select:

    1. Choose an Existing Account - To create a new Scanset for different AWS regions/security frameworks

    2. Connect New Account - To create a new Scanset for a different AWS account

  2. Select the appropriate option options for the Scanset

    1. Name - Used as a reference in Dash

    2. Scanset Properties - Cloud regions to scan and monitor

    3. Compliance Frameworks - Scan ruleset to run for the environment

  1. Click the “Save Scanset Configurations” button

  2. The new Scanset should now show up in the “Scan Configurations page list:

Editing Scansets

  1. Login to Dash ComplyOps at app.dashcomplyops.com

  2. Navigate to Compliance Center → Scan Configurations

  1. Click the “Edit” button for the Scanset you want to edit > You will be taken to the Scanset settings page

  1. You can make any changes to the name, regions, and security frameworks to scan for.

  2. Click the “Save Scanset Configurations”

  3. The Scanset is now updated, and further scans will be run with the new configuration.

Removing Scansets/Accounts

Removing a Scanset

  1. Login to Dash ComplyOps at app.dashcomplyops.com

  2. Navigate to Compliance Center → Scan Configurations

  3. Click the “Remove” button next to Scanset you want to remove

  4. Confirm that you want to remove the Scanset

Removing an Account

  1. Login to Dash ComplyOps at app.dashcomplyops.com

  2. Navigate to Compliance Center → Scan Configurations

  3. Click the “Remove Account” button next to Account you want to remove

  4. Confirm that you want to remove the Account

Note:

  • You will no longer be able to use any Scansets created under this account, unless it is reconnected.

  • You may want to remove the CloudFormation template for dashscanrole in the AWS account, to cleanup IAM role resources.

Manually Download/Install CloudFormation Template

If you are unable to use the “Run CloudFormation” function and/or the instructions above, you can download and deploy the template manually using the following steps to connect an AWS account to Dash ComplyOps monitoring:

  1. Download the IAM Role CloudFormation Template - Download CloudFormation Template

  2. Login to the AWS account you want to connect to AWS Monitoring

  3. Navigate to AWS CloudFormation in the top search

  4. Click “Create Stack” button

  5. Upload the CloudFormation template downloaded from Step #1

  6. In another tab navigate to Dash ComplyOps application

    1. Login to Dash

    2. Go to Compliance Center > Scan Configurations

    3. Click “Create New Scanset” button

    4. Click “Connect New Account” (if page is shown)

    5. You should see variables needed for the CloudFormation stack in on this application page

  7. Enter/copy the following parameters into the CloudFormation stack parameters page:

    1. Stack Name = dashscanrole (or name selected by you)

    2. AWSAccountID = 452806217681

    3. ExternalID = The External ID displayed in the Dash application

  8. Click “Create Stack”

  9. The CloudFormation template is now under way. It may take a few minutes until the CloudFormation template completes successfully. You will then see the status CREATE_COMPLETE.

  10. Now you can navigate back to the Dash application Page > Enter the following information into the fields:

    1. Account Name - A name defined by your team to identify the account you are connecting to monitoring (this can be a name of your choice)

    2. AWS Account ID - Enter the 12-digit AWS Account ID for the AWS account you want to connect to Dash monitoring. (You can find this by logging into your AWS account and clicking on the top right user dropdown.)

  1. Click the “Next Button” button.

    1. The Dash application should recognize that you have connected the new AWS account to monitoring.

  2. You will be taken to a page for creating your first Scanset

    1. Scanset Name - Enter a name for this Scanset. This is how you will identify group of findings in Dash.

    2. Scanset Properties - Select AWS regions to scan and monitor in this Scanset

    3. Security Compliance Frameworks - Select security frameworks used for monitoring rulesets (HIPAA, SOC 2, etc)

    4. Once you have input all options click the “Save Scanset Configurations” button.

  3. Your first Scanset should now be connected.

    1. You can run an initial scan by clicking “Yes” in the popup modal

    2. You can edit this Scanset or create additional Scansets in the Compliance Center > “Scan Configurations” page mentioned in this documentation

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.