# ssc-spc-ccoe-cei/aws-guardrails-cac-solution architecture

> Architecture diagram of the GitHub repository ssc-spc-ccoe-cei/aws-guardrails-cac-solution, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution
- Repository: https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution

## Overview

This repository implements AWS compliance-as-code: setup Lambdas provision the AWS Config and account infrastructure, while guardrail Lambdas assess accounts and produce AWS Config evaluations. The tree also includes audit-report and dashboard components. The graph groups related checks and setup functions rather than listing every Lambda. Evidence is limited to the README, tree, and sampled source/index; unsampled event wiring and report-generation flows are not asserted.

Main entry points: [`src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util/config.py`](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util/config.py) (Config helpers), [`src/lambda/gc01_check_dedicated_admin_account/app.py`](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/gc01_check_dedicated_admin_account/app.py) (Admin account check), [`src/lambda/gc02_check_group_access_configuration/app.py`](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/gc02_check_group_access_configuration/app.py) (Access configuration), [`src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util/organizations.py`](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util/organizations.py) (Organization helpers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_provision["Account and Config setup"]
  node_aws_config_setup["Config setup<br/>[app.py]"]
  node_aws_account_setup["Account setup<br/>[app.py]"]
  node_aws_roles["Role provisioning<br/>[app.py]"]
  node_aws_buckets["Bucket setup<br/>[app.py]"]
  node_aws_permissions["Lambda permissions<br/>[app.py]"]
end

subgraph group_assess["Guardrail assessments"]
  node_gc01_admin["Admin account check<br/>[app.py]"]
  node_gc02_access["Access configuration<br/>[app.py]"]
  node_gc05_location["Data location check<br/>[app.py]"]
  node_gc06_rest1["At-rest checks I<br/>[app.py]"]
  node_gc06_rest2["At-rest checks II<br/>[app.py]"]
  node_gc07_transit["Transit encryption<br/>[app.py]"]
  node_other_checks["Other guardrails"]
end

subgraph group_shared["Shared assessment layer"]
  node_aws_client["AWS client access<br/>[client.py]"]
  node_aws_iam["IAM helpers<br/>[iam.py]"]
  node_aws_org["Organization helpers<br/>[organizations.py]"]
  node_aws_config_helpers["Config helpers<br/>[config.py]"]
  node_aws_s3["S3 helpers<br/>[s3.py]"]
  node_aws_service_helpers["AWS service helpers<br/>[boto_util]"]
  node_utils["Guardrail utilities<br/>[__init__.py]"]
end

subgraph group_report["Reporting"]
  node_audit_report["Audit report<br/>[app.py]"]
  node_dashboard["Dashboard generation<br/>[index.js]"]
  node_dashboard_data["Dashboard data processing<br/>[dataProcessor.js]"]
  node_dashboard_charts["Chart generation<br/>[chartGenerator.js]"]
end

node_gc01_admin -->|"builds evaluations"| node_aws_config_helpers
node_gc02_access -->|"builds evaluations"| node_aws_config_helpers
node_gc06_rest1 -.->|"builds evaluations"| node_aws_config_helpers
node_gc06_rest2 -.->|"builds evaluations"| node_aws_config_helpers
node_gc07_transit -.->|"builds evaluations"| node_aws_config_helpers
node_gc01_admin -->|"uses IAM helpers"| node_aws_iam
node_gc01_admin -->|"uses org helpers"| node_aws_org
node_gc02_access -->|"uses IAM helpers"| node_aws_iam
node_gc02_access -->|"uses org helpers"| node_aws_org
node_gc05_location -.->|"uses org helpers"| node_aws_org
node_gc01_admin -->|"uses guardrail utilities"| node_utils
node_gc02_access -->|"uses guardrail utilities"| node_utils
node_gc05_location -.->|"uses guardrail utilities"| node_utils
node_aws_config_setup -.->|"configures"| node_aws_config_helpers
node_dashboard -.->|"processes data"| node_dashboard_data
node_dashboard -.->|"generates charts"| node_dashboard_charts

click node_aws_config_setup "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/aws_config_setup/app.py"
click node_aws_account_setup "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/aws_account_partitioner/app.py"
click node_aws_roles "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/aws_create_role/app.py"
click node_aws_buckets "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/aws_buckets_setup/app.py"
click node_aws_permissions "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/aws_lambda_permissions_setup/app.py"
click node_gc01_admin "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/gc01_check_dedicated_admin_account/app.py"
click node_gc02_access "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/gc02_check_group_access_configuration/app.py"
click node_gc05_location "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/gc05_check_data_location/app.py"
click node_gc06_rest1 "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/gc06_check_encryption_at_rest_part1/app.py"
click node_gc06_rest2 "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/gc06_check_encryption_at_rest_part2/app.py"
click node_gc07_transit "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/gc07_check_encryption_in_transit/app.py"
click node_other_checks "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/tree/main/src/lambda"
click node_aws_client "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util/client.py"
click node_aws_iam "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util/iam.py"
click node_aws_org "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util/organizations.py"
click node_aws_config_helpers "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util/config.py"
click node_aws_s3 "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util/s3.py"
click node_aws_service_helpers "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/tree/main/src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util"
click node_utils "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/layer/cloud_guardrails/lib/python3.12/site-packages/utils/__init__.py"
click node_audit_report "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/aws_compile_audit_report/app.py"
click node_dashboard "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/aws_generate_dashboard/index.js"
click node_dashboard_data "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/aws_generate_dashboard/lib/dataProcessor.js"
click node_dashboard_charts "https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/aws_generate_dashboard/lib/chartGenerator.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_aws_config_setup,node_aws_account_setup,node_aws_roles,node_aws_buckets,node_aws_permissions toneBlue
class node_gc01_admin,node_gc02_access,node_gc05_location,node_gc06_rest1,node_gc06_rest2,node_gc07_transit,node_other_checks toneAmber
class node_aws_client,node_aws_iam,node_aws_org,node_aws_config_helpers,node_aws_s3,node_aws_service_helpers,node_utils toneMint
class node_audit_report,node_dashboard,node_dashboard_data,node_dashboard_charts toneRose
```

## Components

### Account and Config setup

- [Config setup](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/aws_config_setup/app.py): `src/lambda/aws_config_setup/app.py`
- [Account setup](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/aws_account_partitioner/app.py): `src/lambda/aws_account_partitioner/app.py`
- [Role provisioning](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/aws_create_role/app.py): `src/lambda/aws_create_role/app.py`
- [Bucket setup](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/aws_buckets_setup/app.py): `src/lambda/aws_buckets_setup/app.py`
- [Lambda permissions](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/aws_lambda_permissions_setup/app.py): `src/lambda/aws_lambda_permissions_setup/app.py`

### Guardrail assessments

- [Admin account check](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/gc01_check_dedicated_admin_account/app.py): `src/lambda/gc01_check_dedicated_admin_account/app.py`
- [Access configuration](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/gc02_check_group_access_configuration/app.py): `src/lambda/gc02_check_group_access_configuration/app.py`
- [Data location check](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/gc05_check_data_location/app.py): `src/lambda/gc05_check_data_location/app.py`
- [At-rest checks I](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/gc06_check_encryption_at_rest_part1/app.py): `src/lambda/gc06_check_encryption_at_rest_part1/app.py`
- [At-rest checks II](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/gc06_check_encryption_at_rest_part2/app.py): `src/lambda/gc06_check_encryption_at_rest_part2/app.py`
- [Transit encryption](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/gc07_check_encryption_in_transit/app.py): `src/lambda/gc07_check_encryption_in_transit/app.py`
- [Other guardrails](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/tree/main/src/lambda): `src/lambda`

### Shared assessment layer

- [AWS client access](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util/client.py): `src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util/client.py`
- [IAM helpers](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util/iam.py): `src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util/iam.py`
- [Organization helpers](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util/organizations.py): `src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util/organizations.py`
- [Config helpers](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util/config.py): `src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util/config.py`
- [S3 helpers](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util/s3.py): `src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util/s3.py`
- [AWS service helpers](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/tree/main/src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util): `src/layer/cloud_guardrails/lib/python3.12/site-packages/boto_util`
- [Guardrail utilities](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/layer/cloud_guardrails/lib/python3.12/site-packages/utils/__init__.py): `src/layer/cloud_guardrails/lib/python3.12/site-packages/utils/__init__.py`

### Reporting

- [Audit report](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/aws_compile_audit_report/app.py): `src/lambda/aws_compile_audit_report/app.py`
- [Dashboard generation](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/aws_generate_dashboard/index.js): `src/lambda/aws_generate_dashboard/index.js`
- [Dashboard data processing](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/aws_generate_dashboard/lib/dataProcessor.js): `src/lambda/aws_generate_dashboard/lib/dataProcessor.js`
- [Chart generation](https://github.com/ssc-spc-ccoe-cei/aws-guardrails-cac-solution/blob/main/src/lambda/aws_generate_dashboard/lib/chartGenerator.js): `src/lambda/aws_generate_dashboard/lib/chartGenerator.js`

## Connections

- Admin account check → Config helpers: builds evaluations (evidence: `src/lambda/gc01_check_dedicated_admin_account/app.py`)
- Access configuration → Config helpers: builds evaluations (evidence: `src/lambda/gc02_check_group_access_configuration/app.py`)
- At-rest checks I → Config helpers: builds evaluations (evidence: `src/lambda/gc06_check_encryption_at_rest_part1/app.py`)
- At-rest checks II → Config helpers: builds evaluations (evidence: `src/lambda/gc06_check_encryption_at_rest_part2/app.py`)
- Transit encryption → Config helpers: builds evaluations (evidence: `src/lambda/gc07_check_encryption_in_transit/app.py`)
- Admin account check → IAM helpers: uses IAM helpers (evidence: `src/lambda/gc01_check_dedicated_admin_account/app.py`)
- Admin account check → Organization helpers: uses org helpers (evidence: `src/lambda/gc01_check_dedicated_admin_account/app.py`)
- Access configuration → IAM helpers: uses IAM helpers (evidence: `src/lambda/gc02_check_group_access_configuration/app.py`)
- Access configuration → Organization helpers: uses org helpers (evidence: `src/lambda/gc02_check_group_access_configuration/app.py`)
- Data location check → Organization helpers: uses org helpers (evidence: `src/lambda/gc05_check_data_location/app.py`)
- Admin account check → Guardrail utilities: uses guardrail utilities (evidence: `src/lambda/gc01_check_dedicated_admin_account/app.py`)
- Access configuration → Guardrail utilities: uses guardrail utilities (evidence: `src/lambda/gc02_check_group_access_configuration/app.py`)
- Data location check → Guardrail utilities: uses guardrail utilities (evidence: `src/lambda/gc05_check_data_location/app.py`)
- Config setup → Config helpers: configures
- Dashboard generation → Dashboard data processing: processes data
- Dashboard generation → Chart generation: generates charts
