This repository hosts the CloudFormation templates for Fix SaaS cross-account access, available at https://fixpublic.s3.amazonaws.com/aws/fix-role-global.yaml.
The repository aims to provide a publicly auditable history of the Fix CloudFormation template.
The stack sets up a cross-account access role, allowing Fix to access your AWS account. This role, created within your AWS account and assumable by Fix, enables security scans in your account. Additionally, a SNS message is generated to trigger a callback to Fix, notifying us of the role's name, the account ID in which the role was created, and the ARN of the stack. This information verifies the successful creation and assumability of the role by Fix.
The CloudFormation template requires the following parameters:
| Parameter | Description |
|---|---|
WorkspaceId |
Your Fix-assigned Workspace ID |
ExternalId |
Your Fix-assigned External ID |
These parameters are generated and provided by Fix, accessible within your Fix account settings, and are pre-populated when using the links in the Fix application.
The CloudFormation template creates the following resources:
FixCrossAccountAccessRole(AWS::IAM::Role): This cross-account access role enables Fix to access your AWS account.FixAccountCallback(Custom::Function): This custom resource triggers a SNS message callback to Fix, though it does not create an actual resource in the AWS account.
The role is established with a trust policy allowing Fix to assume the role. For enhanced security, it utilizes an external ID. The role grants the AWS managed permission ReadOnlyAccess as well as pricing and organization list permissions. It also revokes unnecessary permissions that are part of ReadOnlyAccess but not used by Fix.
The SNS callback submits the following information to Fix:
{
"workspace_id": "<your Fix workspace ID>",
"external_id": "<your Fix external ID>",
"role_name": "<the name of the created role>",
"stack_id": "<the ARN of the created stack>"
}Fix leverages the workspace_id and external_id to authenticate the request's origin. The role_name is used to construct the ARN that Fix will assume when performing security scans, while the stack_id is used to retrieve the user's account_id from its ARN.