AWS Manual Setup in Spotto
Most people should connect with Launch Stack. Set up manually when you need:
- a custom role name or path;
- a billing bucket in a separate account, or a legacy Cost and Usage Report;
- policies reviewed and applied through your own change process.
You type the details that Launch Stack would discover. Where Do I Find This? beside each field, and find your AWS IDs, show where each one is.
Step 1: Open The Setup
- Open Connectors > Cloud Accounts, select Create, then AWS.
- Under Manual Setup, select Organization or Single Account.
The page has four steps: Accounts, Billing, Deploy Access and Strategy. Next takes you through them, and Create appears on the last step.
To change a saved account or organization later, select the edit icon on its row in Cloud Accounts. The same steps appear as tabs.
Step 2: Enter The Accounts
| Field | Notes |
|---|---|
| Organization Name · Organization ID | Organizations only. Both required. |
| Account ID · Account Name | One row per account. Both required. Enter the management account first. |
| Management Account ID | Organizations with more than one account. |
| IAM Role ARN | Filled in as arn:aws:iam::<account-id>:role/SpottoReadOnlyRole. Select Use a Custom Role ARN only for a different name or path. |
For many accounts, select Paste Account IDs and paste them separated by new lines, commas or spaces.
Optionally:
- select Organization Commitments Planning on the management account, for Reserved Instance and Savings Plans planning across the organization;
- under Excluded Accounts, select Add Exclusion for accounts you're leaving out on purpose, so the gap is explained later.
Step 3: Add Billing
Billing is required: Create stays unavailable until the account that holds the bill has a validated billing source. Member accounts don't need their own. Add it before you deploy the roles, so they get billing access the first time.
On Billing, select Add Billing Source and enter the export details. See add a billing source.
Step 4: Deploy The Role In Each Account
On Deploy Access, choose a method:
| Method | In Spotto | In AWS |
|---|---|---|
| CloudFormation | For each account, select Get Template, then Download CloudFormation Template. | Create a stack from the file. |
| Manual IAM | For each account, select Generate Role Instructions, then Copy Role Instructions. | Create the role by hand. |
Each account's role differs slightly, depending on what it does:
All roles trust the same External ID. It's fixed for your company, so roles you've already deployed don't change when you add accounts.
For many member accounts, deploy the hosted member account StackSet from the management account instead of one stack per account.
Create A Stack From The Downloaded Template
- Sign in to the account and open CloudFormation. Any Region works for a role-only template.
- Select Create stack, then With new resources (standard).
- Choose Upload a template file, select the file, then select Next.
- Enter a stack name, such as
SpottoReadOnlyRole, then select Next twice. - Tick the IAM acknowledgement and select Submit.
- Wait for
CREATE_COMPLETE.
When an account's billing or purposes change, download its new template and update the stack with Replace existing template.
Deploy The Role Manually
-
In the account's IAM console, create a role named
SpottoReadOnlyRolewith Custom trust policy, and paste the trust policy from the role instructions. -
Attach the two AWS managed policies (Add permissions > Attach policies):
Policy ARN ViewOnlyAccess arn:aws:iam::aws:policy/job-function/ViewOnlyAccessSecurityAudit arn:aws:iam::aws:policy/SecurityAuditFrom the CLI:
aws iam attach-role-policy --role-name SpottoReadOnlyRole --policy-arn <ARN>, once for each. -
Add each inline policy with the exact name and JSON shown:
SpottoReadOnlyAccess, plusSpottoBillingExportReadandSpottoCommitmentsPlanningwhere listed.
If your standards require it, you can create the inline policies as customer managed policies instead. Each fits within the managed-policy size limit.
When an account's billing changes, generate its instructions again and replace SpottoReadOnlyAccess. Don't add a second copy: its S3 deny changes with billing. See permissions.
Step 5: Create And Check The Status
After deploying the roles, select Check Details to check the configuration without saving. New or changed billing sources are checked live in AWS: Spotto reads the authoritative export definition, checks its destination and bucket encryption, and tests storage access. See what the preflight checks, including the limits when no files have arrived.
Select Create, or Update for a saved configuration, to repeat those checks and save. A failed preflight saves nothing and starts no scan. After a successful save, Spotto returns you to Cloud Accounts and checks each account in the background:
Open the account or organization again to see AWS Setup Status:
| Status | Meaning |
|---|---|
| Not Started or Validating | Still checking. The panel refreshes on its own. |
| Ready | Every role and billing source passed. |
| Partially Ready | Some accounts or billing sources need attention, each with its fix. |
| Failed | Nothing passed yet. The fix is listed for each account. |
After you fix something in AWS, select Retry Validation. For each message, see troubleshooting. To change, sync or remove accounts later, see manage connected AWS accounts.