Connect Your Cloud Account

GRAX can be installed automatically in your own cloud accounts in a matter of minutes. Here are the steps and permissions required.

AWS

GRAX can connect to your AWS account one of two ways:

  • AWS Cross Account Role
  • AWS Console User

Create an AWS Account

GRAX requires a standalone AWS account. You can create one in 2 minutes through AWS Organizations or through the AWS home page.

Create a cross account role to GRAX AWS account

You can set up the role in two clicks with the AWS Quick Create Wizard. Click through the wizard, then find the ARN on the Outputs tab.

To create it manually:

  1. Click on Roles -> Create Role
  2. Under trusted entity type select AWS Account
  3. Under An AWS account ID, select Another AWS account and enter 999875163122. This account is managed by GRAX, Inc.
  4. Select Require external ID
  5. Enter the External ID provided by GRAX
    • It is a random token like va/C3SU15+k/bm/N5aLiC+z40MdT8jS+HafSQdd5uzI=
  6. Click Next
  7. For Permissions Policies select AdministratorAccess
  8. Click Next
  9. Enter the name GRAX for the role, and click Create Role
  10. Click on the Role you just created
  11. Edit and set Maximum session duration to 4 hours
  12. Finally share the Role ARN with GRAX

Share your role ARN with GRAX

Contact GRAX Support with:

  • Subject: GRAX Installer Cross Account Access Role
  • Product: Infrastructure
  • Description:
We created the cross account role.

ARN: arn:aws:iam::468434328104:role/GRAX

When you've shared those details, GRAX can assume the role and install your backends.

Create a AWS Console User

  1. Click on Users -> Add User
  2. For User name enter GRAX
  3. Select Enable console access
    • Leave the defaults to auto-generate a password that must be reset upon sign-in
  4. Under Set Permissions select Attach policies directly and AdministratorAccess
  5. Under Review and create select Create user
  6. Stay on Retrieve password - GRAX needs the URL, username, and password you just created

Share your User with GRAX

Contact GRAX Support with:

  • Subject: GRAX Installer User
  • Product: Infrastructure
  • Description:
We created the console user.

URL: https://468434328104.signin.aws.amazon.com/console
User Name: GRAX
Console Password: oHcZEXAMPLE

When you've shared those details, GRAX can log into the account and install your backends.

Further Reading

See also the Connect Account FAQ.