CloudFormation

To manually connect your AWS Account using the CloudFormation option, you will need to:

  1. Log Into Your AWS Management Console
  2. In Open Raven, Go to Configuration and AWS Accounts and Add New Account
  3. Enter Your AWS Account ID
  4. Select “Create Manually” and Click “Next”
  5. Choose “Create with CloudFormation”
  6. Download the CloudFormation Template
  7. In AWS Management Console, Create Stack
  8. Specify Stack Details
  9. Skip the “Configure stack options” Page
  10. Review Stack
  11. Validate the Connection

Let's get started.

Note: In this example, we will be adding an AWS Organization to Open Raven.

Step 1. Log Into your AWS Management Console

To add your AWS Account to Open Raven, you will first need to log into your AWS Management Console.

Step 2. In Open Raven, Go to Configuration and AWS Accounts and Add New Account

In a separate tab, log into your Open Raven account.

Select "Configuration" from the navigation menu on the left side of the page.

Then, select “AWS Accounts” from that same navigation menu.

Next, click on the blue “Add AWS Account” button on the upper right side to start connecting your account.

Step 3. Enter Your AWS Account ID

Enter your 12-digit AWS Account ID (which you’ll find in your AWS Management Console).

Do not make any changes to the Open Raven Org ID and External ID fields. Both are static values and should remain exactly as they are.

Step 4. Select “Create Manually” and Click “Next”

Next, click “Create Manually” and then “Next.”

Step 5. Choose “Create with CloudFormation”

You will now see three options:

Click on the “Create with CloudFormation” option to use CloudFormation to deploy the required AWS IAM Role.

Step 6. Download the CloudFormation Template

Click “Download CloudFormation template.”

The template will go to your Downloads folder.

Step 7. In AWS Management Console, Create Stack

Go to your AWS Management Console that you have already preloaded in another tab. Under “AWS services,” click on “CloudFormation.”

On the upper right side, click “Create stack” and then click on “with new resources (standard).”

You will now be redirected to the “Create Stack page.” In the “Specify Template” section, click “Upload a template file” (under “Specify template.”)

Then, click on “Choose file” and find the Open Raven file you previously downloaded.

Click “Next.”

Step 8. Specify Stack Details

A “Specify stack details” page will open.

Under “Parameters,” fill out OrgId and ExternalId.

To find OrgId and ExternalId, go back to the tab with Open Raven and copy Open Raven Org ID and External ID.

Under “Stack name,” give the stack a name, for example, “openraven-manual.”

Click “Next.”

Step 9. Skip the “Configure stack options” Page

You will now see a “Configure stack options” page. You don’t need to fill out anything here. Instead, click “Next.”

Step 10. Review the Stack

You will be redirected to a page that lets you review your stack.

Scroll down and under “Capabilities” enable “I acknowledge that AWS CloudFormation might create IAM resources with custom names.”

Click “Create stack.” It will take a few seconds for the stack to be created. You can click the refresh button on the upper right side to track progress and see when the stack is ready. When the stack goes from “CREATE_IN_PROGRESS” (blue) to “CREATE_COMPLETE” (green) on the left side, it has been successfully created.

Step 11. Validate the Connection

Once the stack is created, go back to Open Raven and click on “I created the connection.”

You should now see all the accounts in your organization under “AWS Accounts” with the status “Found.”

🚧

Any questions?

If you have questions while connecting your AWS Account to Open Raven or need assistance, please contact the Open Raven support team via email at [email protected]


What’s Next