Skip to main content

Onboarding an AWS account

There are two available methods to integrate an AWS account:

  • CloudFormation

  • Manual

CloudFormation method (Recommended)

AWS CloudFormation is a service that helps you model and set up AWS resources so that you can spend less time managing resources and more time using the application.

Follow these steps to integrate the AWS account using the CloudFormation method:

  1. Under Select a connection method, select the CloudFormation method.

    Important

    Do not close this browser tab during the integration.

  2. Open a new browser tab or window and log in to AWS Account with an administrator account.

  3. Go back to the GravityZone Cloud Security Scan Configuration browser page.

  4. Click Launch CloudFormation Stack.

    CSPM_AWS_integration_4_425527_en.png

    The Create stack page will be displayed in a new browser window. The information is automatically filled in for multiple sections of the page.

  5. In the Create stack page, scroll down to the Capabilities section.

    CSPM_AWS_integration_1_425527_en.png
  6. Check the I acknowledge that AWS CloudFormation might create IAM resources. checkbox and click Create Stack.

    The Stack will now appear in your AWS account:

    CSPM_AWS_integration_2_425527_en.png
  7. Wait until the CloudFormation Stack status shows CREATE_COMPLETE.

  8. Go to the Outputs tab.

  9. Copy the information from the Value column.

    CSPM_AWS_integration_3_425527_en.png
  10. Go back to the Scan Configuration browser page.

  11. Paste the key under Paste Role ARN here.

  12. Type in a descriptive name for the account under Account name.

  13. Click Add account.

Manual method (for advanced users)

You can adjust and limit to what degree you want GravityZone Cloud Security to monitor your AWS cloud assets.

To use the manual integration method, follow these steps:

  1. Under Select a connection method, select the Manual method.

    Important

    Do not close this browser tab during integration.

  2. Open a new browser tab or window and log in to AWS Account in a new browser window with an administrator account.

  3. Go to the IAM >Roles section and click Create role.

    The Select trusted entity window is displayed.

  4. Under Trusted entity type, select AWS Account.

  5. In the An AWS account section, select Another AWS account.

  6. Go back to the Scan Configuration browser page and copy the Account ID.

  7. Under Account ID, paste the information copied at step 6.

  8. Check the Require external ID box.

  9. Go back to the Scan Configuration browser page and copy the External ID.

  10. In the External ID box, paste the information copied at step 9.

    Note

    Make sure the Require MFA checkbox is unchecked.

  11. Click Next.

    CSPM_AWS_integration_M_1_425527_en_copy.png

    The Add permissions window is displayed.

  12. Under Permission policies, select the box next to SecurityAudit.

  13. Click Next.

    CSPM_AWS_integration_M_2_425527_en.png

    The Create Role window will be displayed.

  14. Fill in the information under the Role details section:

    • Under Role name type in a descriptive name such as gravityzone-cloud-scanner.

    • Type in a clear description for the role.

  15. Scroll down to the bottom of the page and click Create role.

    The Roles page is displayed.

  16. Search for the newly created role by name and click it.

    CSPM_AWS_integration_M_5_425527_en.png

    The Role page is displayed.

  17. Click the Edit button under the Summary section.

    CSPM_AWS_integration_M_6_425527_en.png

    The Edit description and session duration window is displayed.

  18. Set the Maximum session duration to 4 hours and Save changes.

  19. Click the Copy button under ARN in the the Summary section.

    CSPM_AWS_integration_M_4_425527_en.png
  20. Go back to the Scan Configuration browser page.

  21. Paste the ARN you copied under Paste Role ARN here.

  22. Type in a descriptive name for the account under Account name.

  23. Click Add account.