Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/bug_report.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -19,6 +19,7 @@ Please provide details about your deployment to help us reproduce the issue.
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Medium
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] Stand-alone / Custom
Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/documentation-suggestion.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -20,4 +20,4 @@ Where should this documentation live? e.g., existing file in `docs/`, a new file
Please provide a draft or outline of the content you would like to add.

## Compliance Context (if applicable)
Does this documentation relate to a specific compliance regime (FedRAMP High, IL5) or NIST control?
Does this documentation relate to a specific compliance regime (FedRAMP Moderate, FedRAMP High, IL5) or NIST control?
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/feature_request.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -22,6 +22,7 @@ A clear and concise description of what you want to happen.
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Medium
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] All / General
Expand Down
3 changes: 2 additions & 1 deletion .github/pull_request_template.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -14,6 +14,7 @@ Fixes # (GitHub issue id)
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Moderate
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] General / All
Expand All@@ -32,7 +33,7 @@ Fixes # (GitHub issue id)

### Security
- [ ] My change adheres to GCP security best practices and the principle of least privilege.
- [ ] I have ensured compliance with the targeted regime (FedRAMP High, IL5, etc.).
- [ ] I have ensured compliance with the targeted regime (FedRAMP Moderate, FedRAMP High, IL5, etc.).

### Testing
- [ ] I have tested my changes locally.
Expand Down
4 changes: 2 additions & 2 deletions GEMINI.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -4,7 +4,7 @@

Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF), providing Infrastructure as Code (IaC) to help Google Cloud Platform
(GCP) customers create secure and compliant landing zones. It has a strong focus on environments requiring Assured Workload overlays, such
as FedRAMP High, IL4, and IL5, and includes documentation mapping NIST 800-53r5 controls to accelerate Authorization to Operate (ATO)
as FedRAMP Moderate, FedRAMP High, IL4, and IL5, and includes documentation mapping NIST 800-53r5 controls to accelerate Authorization to Operate (ATO)
processes.

**Key Technologies:** Terraform, Google Cloud Platform (GCP)
Expand DownExpand Up@@ -35,7 +35,7 @@ outputs, and any dependencies.
Consistency in naming variables, resources, modules, and files is crucial.

5. **Security:** Adhere to GCP security best practices and the principle of least privilege in all configurations. Ensure compliance with
the targeted regime (FedRAMP High, IL5, etc.).
the targeted regime (FedRAMP Moderate, FedRAMP High, IL5, etc.).

## Key Codebase Resources

Expand Down
14 changes: 7 additions & 7 deletions README.md
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
## Introduction

Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF) repository, aimed at providing Infrastructure as Code (IaC) for Google Cloud Platform (GCP) customers who need to create a landing zone environment with the Assured Workload overlays. In addition to the IaC, there is [documentation available](./docs/path-to-authorization.md) for both FedRAMP High (FRH), Department of Defense (DoD) Impact Level 4 (IL4) and DoD Impact Level (IL5) compliance regimes that provide a mapping of National Institute of Standards and Technology (NIST) 800-53r5 controls to enable projects that leverage the Stellar Engine codebase to accelerate the speed at which an Authorization to Operate (ATO) can be attained.
Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF) repository, aimed at providing Infrastructure as Code (IaC) for Google Cloud Platform (GCP) customers who need to create a landing zone environment with the Assured Workload overlays. In addition to the IaC, there is [documentation available](/docs/path-to-authorization.md) for FedRAMP High (FRH), FedRAMP Moderate (FRM), Department of Defense (DoD) Impact Level 4 (IL4) and DoD Impact Level (IL5) compliance regimes that provide a mapping of National Institute of Standards and Technology (NIST) 800-53r5 controls to enable projects that leverage the Stellar Engine codebase to accelerate the speed at which an Authorization to Operate (ATO) can be attained.

## Getting Started

Expand All@@ -14,7 +14,7 @@ This repository provides **end-to-end blueprints** and a **suite of Terraform mo

The target audience for Stellar Engine is organizations and teams that operate in regulated industries or require robust compliance and security frameworks. Below are a few examples of these such users:

- **Government Agencies:** Agencies and contractors, such as those that work with FRH, IL4, and IL5 environments. <br />
- **Government Agencies:** Agencies and contractors, such as those that work with FRM, FRH, IL4, and IL5 environments. <br />
- **Regulated Industries:** Regulated industries often face overlapping compliance and security requirements; Stellar Engine can simplify that. <br />
- **Educational and Research Institutions:** Universities and research organizations working on government-funded projects that require secure and compliant cloud environments. <br />

Expand DownExpand Up@@ -45,26 +45,26 @@ The suite of modules in this repository is designed for rapid composition and re

All modules share a similar interface where each module tries to stay close to the underlying provider resources, support IAM together with resource creation and modification, offer the option of creating multiple resources where it makes sense (e.g. not for projects), and be completely free of side-effects (e.g. no external commands).

A well-defined naming standard is used across Stellar Engine to ensure adherence to Google Cloud's best practices, naming requirements, and naming collision avoidance for global resources. The Google Cloud naming standard documentation is [here](./documentation/naming-convention.md) and will be used before the Stellar Engine deployment begins by choosing a naming standard that will flow through the Google Cloud infrastructure state.
A well-defined naming standard is used across Stellar Engine to ensure adherence to Google Cloud's best practices, naming requirements, and naming collision avoidance for global resources. The Google Cloud naming standard documentation is [here](/docs/naming-convention.md) and will be used before the Stellar Engine deployment begins by choosing a naming standard that will flow through the Google Cloud infrastructure state.

The current modules support most of the core foundational and networking components used to design end-to-end infrastructure, with more modules in active development for specialized compute, security, and data scenarios.

For more information and usage examples see each module's README file, as well as any associated blueprints.

## End-to-End Blueprints

Stellar Engine currently offers blueprints that are compliant with [FRH](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-high) and [IL5](https://github.com/google/stellar-engine/tree/main/blueprints/il5) baselines. </br>
Stellar Engine currently offers blueprints that are compliant with [FRM](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-moderate), [FRH](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-high), and [IL5](https://github.com/google/stellar-engine/tree/main/blueprints/il5) baselines. </br>
These blueprints range from full end-to-end services like a Cloud Native Access Point (CNAP), to ad-hoc services that are designed to be molded to users' individual use cases.

For more information, please look at each blueprint's README file.

## Cybersecurity Documentation

In addition to the IaC, Stellar Engine provides supporting documentation that maps NIST 800-53r5 controls for users leveraging the IaC. This documentation is designed to streamline achieving ATO by providing generalized templates. All documentation can be requested [here](https://forms.gle/zdv7Gip4opmdhBqk7). For how to utilize these documents, please see the following [Path to Authorization](./docs/path-to-authorization.md) guide.
In addition to the IaC, Stellar Engine provides supporting documentation that maps NIST 800-53r5 controls for users leveraging the IaC. This documentation is designed to streamline achieving ATO by providing generalized templates. All documentation can be requested [here](https://forms.gle/zdv7Gip4opmdhBqk7). For how to utilize these documents, please see the following [Path to Authorization](/docs/path-to-authorization.md) guide.

## Detailed Deployment Guide

The Stellar Engine Cloud Foundation Fabric Detailed Deployment Guide (DDG) outlines a structured process for deploying a secure, compliant infrastructure on GCP using IaC. Designed to support compliance with standards such as FRH, IL4, and IL5, the guide enables organizations to create a foundational "landing zone" with Assured Workload overlays. It includes mappings of NIST 800-53r5 controls to streamline achieving ATO. The deployment process is divided into stages, each focusing on specific components like resource management, networking, and security configuration.
The Stellar Engine Cloud Foundation Fabric Detailed Deployment Guide (DDG) outlines a structured process for deploying a secure, compliant infrastructure on GCP using IaC. Designed to support compliance with standards such as FRM, FRH, IL4, and IL5, the guide enables organizations to create a foundational "landing zone" with Assured Workload overlays. It includes mappings of NIST 800-53r5 controls to streamline achieving ATO. The deployment process is divided into stages, each focusing on specific components like resource management, networking, and security configuration.

Key stages include Stage 0 (Bootstrap), which initializes the infrastructure, creates core Google Cloud Projects, and sets up service accounts; Stage 1 (Resource Management), which organizes Google Cloud Folders and Google Cloud Projects for tenants; and Stage 2 (Network Creation), which configures networking, including advanced setups like Palo Alto NGFWs for IL5 environments. The final stage, Stage 3 (Security and Audit Account Configuration), establishes security protocols, including Customer Managed Encryption Keys (CMEK) requirements and logging for audit purposes. Each stage requires detailed configuration of Terraform variables and adherence to prerequisites like IAM roles, service account setups, and enabling Google Cloud services.

Expand All@@ -82,7 +82,7 @@ For more information, please look at the [TDD](./docs/tdd.md).

## Security Best Practices Guide

The Stellar Engine Security Best Practices Guide (SBPG) outlines a robust framework for deploying secure and compliant GCP infrastructure. Designed for organizations requiring adherence to FRH and IL5 standards, it employs IaC principles via Terraform. The Stellar Engine facilitates the automated creation of a baseline GCP environment, supporting modular deployment of both Google and approved third-party services. Its hierarchical architecture ensures effective organization, leveraging role-based access control (RBAC), strict IAM policies, and a hub-and-spoke VPC networking design for isolation and scalability.
The Stellar Engine Security Best Practices Guide (SBPG) outlines a robust framework for deploying secure and compliant GCP infrastructure. Designed for organizations requiring adherence to FRM, FRH, and IL5 standards, it employs IaC principles via Terraform. The Stellar Engine facilitates the automated creation of a baseline GCP environment, supporting modular deployment of both Google and approved third-party services. Its hierarchical architecture ensures effective organization, leveraging role-based access control (RBAC), strict IAM policies, and a hub-and-spoke VPC networking design for isolation and scalability.

The document emphasizes best practices in identity and access management, security monitoring, and compliance. IAM configurations focus on the principle of least privilege, with automation enabling minimal human interaction during setup. Security features include encryption-at-rest, TLS enforcement, and centralized logging and monitoring through audit logs, VPC flow logs, and other diagnostics. The system supports Assured Workloads, providing region-specific data residency and compliance settings to meet regulatory requirements.

Expand Down
2 changes: 1 addition & 1 deletion blueprints/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -45,7 +45,7 @@ For more information, please see the individual README files in each blueprint's
| [Secret Manager](./fedramp-high/secret-manager/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |
| [Shielded VM Project](./il5/shielded-vm-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [Vertex MLOps](./fedramp-high/vertex-mlops/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |
| [VPC Peering Project](./il5/vpc-peering-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [VPC Peering Project](./stand-alone/vpc-peering-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [Workflows](./fedramp-high/workflows/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |

<br>
Expand Down
1 change: 0 additions & 1 deletion blueprints/il5/compute-engine/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -119,4 +119,3 @@ keyrings-keys = {
## Verification of a successful deployment?

- Go to the Compute Engine in the GCP Console. Select the VM. Check the Presistent Disk Encryption
![GCP Compute Engine Instance Presistent Disk Encryption](./images/vm-disk-1.png?raw=true "GCP Compute Engine Instance Presistent Disk Encryption")
2 changes: 1 addition & 1 deletion blueprints/third-party-solutions/gitlab/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -242,7 +242,7 @@ following [link](https://docs.gitlab.com/omnibus/settings/ssl/#configure-https-m
If you want to deploy from your Cloud Shell, click on the image below, sign in
if required and when the prompt appears, click on “confirm”.

[![Open Cloudshell](../../../assets/images/cloud-shell-button.png)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fcloud-foundation-fabric&cloudshell_workspace=blueprints%2Fthird-party-solutions%2Fwordpress%2Fcloudrun)
![Open Cloudshell](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fcloud-foundation-fabric&cloudshell_workspace=blueprints%2Fthird-party-solutions%2Fwordpress%2Fcloudrun)

Otherwise, in your console of choice:

Expand Down
8 changes: 4 additions & 4 deletions docs/ddg.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -20,7 +20,7 @@ environment with the Assured Workload overlays. The project has been confirmed
to work with (DISA) Impact Level 5 (IL5), Impact Level 4 (IL4), and FedRAMP
High, but will function as a starting point for any other Assured Workloads
overlay. In addition to the IaC, there is documentation available for both the
IL5and FedRAMP High compliance regimes that provide a mapping of National
IL5, FedRAMP High, and FedRAMP Moderate compliance regimes that provide a mapping of National
Institute of Standards and Technology (NIST) 800-53r5 controls to enable
projects that leverage the Stellar Engine codebase to accelerate the speed at
which an Authorization to Operate (ATO) can be attained. These responses are
Expand DownExpand Up@@ -67,7 +67,7 @@ To make using this deployment guide easier, the variables described below need t
| :------------------------------------ | :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <strong>Billing Account</strong> | `billing_account.id` | The billing account to use for the deployment of the environments. <a href='https://console.cloud.google.com/billing'>Console Link</a> |
| <strong>Bootstrap Project ID</strong> | `bootstrap_project` | The bootstrap project id (created below) |
| <strong>Compliance Regime</strong> | `assured_workloads.regime` | The <a href='https://assuredworkloads.googleapis.com/$discovery/rest?version=v1'>compliance regime</a> for this environment, (confirmed working in IL4, IL5, FEDRAMP_HIGH, and COMPLIANCE_REGIME_UNSPECIFIED) |
| <strong>Compliance Regime</strong> | `assured_workloads.regime` | The <a href='https://assuredworkloads.googleapis.com/$discovery/rest?version=v1'>compliance regime</a> for this environment, (confirmed working in IL4, IL5, FEDRAMP_MODERATE, FEDRAMP_HIGH, and COMPLIANCE_REGIME_UNSPECIFIED) |
| <strong>Customer ID</strong> | `organization.customer_id` | The Google Workspace Directory Customer ID. <br/>Run <strong>gcloud organizations list</strong> to view. |
| <strong>Domain Name</strong> | `organization.domain` | The primary Fully Qualified Domain Name (FQDN). Run <strong>gcloud organizations list</strong> to view (make sure you have authorized as per prerequisites below) |
| <strong>Alert Email</strong> | `alert_email` | The email address used for logging alerts notifications. |
Expand DownExpand Up@@ -207,7 +207,7 @@ billing_account = {
id = "`<billing_account_id>`" # taken from Google Cloud Console Billing Accounts -> Manage Billing Account
}
# region configuration - this will automatically populate locations for GCS, BigQuery, KMS, and logging buckets
# Default to us-east4 for IL5/FedRAMP compliance - adjust as needed
# Default to us-east4 for IL5/FedRAMP High/Moderate compliance - adjust as needed
regions = {
primary = "`<region>`"
}
Expand DownExpand Up@@ -391,7 +391,7 @@ gcloud storage cp gs://${FAST_PREFIX}-prod-iac-core-outputs-0/tfvars/0-bootstrap

## Stage 2 - Network Creation

## FedRAMP High - Stage 2.1 Networking
## FedRAMP High / Moderate - Stage 2.1 Networking

### Steps

Expand Down
8 changes: 4 additions & 4 deletions docs/path-to-authorization.md
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
# Path to Authorization

_Impact Level 5 (H-H-X)& FedRAMP High_
_Impact Level 5 (H-H-X), FedRAMP High & FedRAMP Moderate_

**Created Date:**

Expand DownExpand Up@@ -67,7 +67,7 @@ privacy risks
managed, and authorized for operation or use.
- [Impact Level 5 Authorization
Boundary](https://forms.gle/zdv7Gip4opmdhBqk7)
- [FedRAMP High Authorization
- [FedRAMP High & Moderate Authorization
Boundary](https://forms.gle/zdv7Gip4opmdhBqk7)
- Regularly assess the security and privacy risks at the organization level
and system level. Update risk assessment results on an on-going basis.
Expand DownExpand Up@@ -111,10 +111,10 @@ risk assessment(s)
frequency in which the controls are monitored?
- [Security Control Traceability Matrix (SCTM)
Templates](https://forms.gle/zdv7Gip4opmdhBqk7)
(IL5 H-H-Xand FedRAMP High Baselines)
(IL5 H-H-X, FedRAMP High, and FedRAMP Moderate Baselines)
- [Policies and Procedures
Templates](https://forms.gle/zdv7Gip4opmdhBqk7)
(IL5 HHXand FedRAMP High Baselines)
(IL5 HHX, FedRAMP High, and FedRAMP Moderate Baselines)

[**Step 3;
Implement**](https://csrc.nist.gov/Projects/risk-management/about-rmf/implement-step):
Expand Down
Loading
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/bug_report.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -19,6 +19,7 @@ Please provide details about your deployment to help us reproduce the issue.
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Medium
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] Stand-alone / Custom
Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/documentation-suggestion.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -20,4 +20,4 @@ Where should this documentation live? e.g., existing file in `docs/`, a new file
Please provide a draft or outline of the content you would like to add.

## Compliance Context (if applicable)
Does this documentation relate to a specific compliance regime (FedRAMP High, IL5) or NIST control?
Does this documentation relate to a specific compliance regime (FedRAMP Moderate, FedRAMP High, IL5) or NIST control?
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/feature_request.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -22,6 +22,7 @@ A clear and concise description of what you want to happen.
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Medium
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] All / General
Expand Down
3 changes: 2 additions & 1 deletion .github/pull_request_template.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -14,6 +14,7 @@ Fixes # (GitHub issue id)
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Moderate
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] General / All
Expand All@@ -32,7 +33,7 @@ Fixes # (GitHub issue id)

### Security
- [ ] My change adheres to GCP security best practices and the principle of least privilege.
- [ ] I have ensured compliance with the targeted regime (FedRAMP High, IL5, etc.).
- [ ] I have ensured compliance with the targeted regime (FedRAMP Moderate, FedRAMP High, IL5, etc.).

### Testing
- [ ] I have tested my changes locally.
Expand Down
4 changes: 2 additions & 2 deletions GEMINI.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -4,7 +4,7 @@

Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF), providing Infrastructure as Code (IaC) to help Google Cloud Platform
(GCP) customers create secure and compliant landing zones. It has a strong focus on environments requiring Assured Workload overlays, such
as FedRAMP High, IL4, and IL5, and includes documentation mapping NIST 800-53r5 controls to accelerate Authorization to Operate (ATO)
as FedRAMP Moderate, FedRAMP High, IL4, and IL5, and includes documentation mapping NIST 800-53r5 controls to accelerate Authorization to Operate (ATO)
processes.

**Key Technologies:** Terraform, Google Cloud Platform (GCP)
Expand DownExpand Up@@ -35,7 +35,7 @@ outputs, and any dependencies.
Consistency in naming variables, resources, modules, and files is crucial.

5. **Security:** Adhere to GCP security best practices and the principle of least privilege in all configurations. Ensure compliance with
the targeted regime (FedRAMP High, IL5, etc.).
the targeted regime (FedRAMP Moderate, FedRAMP High, IL5, etc.).

## Key Codebase Resources

Expand Down
14 changes: 7 additions & 7 deletions README.md
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
## Introduction

Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF) repository, aimed at providing Infrastructure as Code (IaC) for Google Cloud Platform (GCP) customers who need to create a landing zone environment with the Assured Workload overlays. In addition to the IaC, there is [documentation available](./docs/path-to-authorization.md) for both FedRAMP High (FRH), Department of Defense (DoD) Impact Level 4 (IL4) and DoD Impact Level (IL5) compliance regimes that provide a mapping of National Institute of Standards and Technology (NIST) 800-53r5 controls to enable projects that leverage the Stellar Engine codebase to accelerate the speed at which an Authorization to Operate (ATO) can be attained.
Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF) repository, aimed at providing Infrastructure as Code (IaC) for Google Cloud Platform (GCP) customers who need to create a landing zone environment with the Assured Workload overlays. In addition to the IaC, there is [documentation available](/docs/path-to-authorization.md) for FedRAMP High (FRH), FedRAMP Moderate (FRM), Department of Defense (DoD) Impact Level 4 (IL4) and DoD Impact Level (IL5) compliance regimes that provide a mapping of National Institute of Standards and Technology (NIST) 800-53r5 controls to enable projects that leverage the Stellar Engine codebase to accelerate the speed at which an Authorization to Operate (ATO) can be attained.

## Getting Started

Expand All@@ -14,7 +14,7 @@ This repository provides **end-to-end blueprints** and a **suite of Terraform mo

The target audience for Stellar Engine is organizations and teams that operate in regulated industries or require robust compliance and security frameworks. Below are a few examples of these such users:

- **Government Agencies:** Agencies and contractors, such as those that work with FRH, IL4, and IL5 environments. <br />
- **Government Agencies:** Agencies and contractors, such as those that work with FRM, FRH, IL4, and IL5 environments. <br />
- **Regulated Industries:** Regulated industries often face overlapping compliance and security requirements; Stellar Engine can simplify that. <br />
- **Educational and Research Institutions:** Universities and research organizations working on government-funded projects that require secure and compliant cloud environments. <br />

Expand DownExpand Up@@ -45,26 +45,26 @@ The suite of modules in this repository is designed for rapid composition and re

All modules share a similar interface where each module tries to stay close to the underlying provider resources, support IAM together with resource creation and modification, offer the option of creating multiple resources where it makes sense (e.g. not for projects), and be completely free of side-effects (e.g. no external commands).

A well-defined naming standard is used across Stellar Engine to ensure adherence to Google Cloud's best practices, naming requirements, and naming collision avoidance for global resources. The Google Cloud naming standard documentation is [here](./documentation/naming-convention.md) and will be used before the Stellar Engine deployment begins by choosing a naming standard that will flow through the Google Cloud infrastructure state.
A well-defined naming standard is used across Stellar Engine to ensure adherence to Google Cloud's best practices, naming requirements, and naming collision avoidance for global resources. The Google Cloud naming standard documentation is [here](/docs/naming-convention.md) and will be used before the Stellar Engine deployment begins by choosing a naming standard that will flow through the Google Cloud infrastructure state.

The current modules support most of the core foundational and networking components used to design end-to-end infrastructure, with more modules in active development for specialized compute, security, and data scenarios.

For more information and usage examples see each module's README file, as well as any associated blueprints.

## End-to-End Blueprints

Stellar Engine currently offers blueprints that are compliant with [FRH](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-high) and [IL5](https://github.com/google/stellar-engine/tree/main/blueprints/il5) baselines. </br>
Stellar Engine currently offers blueprints that are compliant with [FRM](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-moderate), [FRH](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-high), and [IL5](https://github.com/google/stellar-engine/tree/main/blueprints/il5) baselines. </br>
These blueprints range from full end-to-end services like a Cloud Native Access Point (CNAP), to ad-hoc services that are designed to be molded to users' individual use cases.

For more information, please look at each blueprint's README file.

## Cybersecurity Documentation

In addition to the IaC, Stellar Engine provides supporting documentation that maps NIST 800-53r5 controls for users leveraging the IaC. This documentation is designed to streamline achieving ATO by providing generalized templates. All documentation can be requested [here](https://forms.gle/zdv7Gip4opmdhBqk7). For how to utilize these documents, please see the following [Path to Authorization](./docs/path-to-authorization.md) guide.
In addition to the IaC, Stellar Engine provides supporting documentation that maps NIST 800-53r5 controls for users leveraging the IaC. This documentation is designed to streamline achieving ATO by providing generalized templates. All documentation can be requested [here](https://forms.gle/zdv7Gip4opmdhBqk7). For how to utilize these documents, please see the following [Path to Authorization](/docs/path-to-authorization.md) guide.

## Detailed Deployment Guide

The Stellar Engine Cloud Foundation Fabric Detailed Deployment Guide (DDG) outlines a structured process for deploying a secure, compliant infrastructure on GCP using IaC. Designed to support compliance with standards such as FRH, IL4, and IL5, the guide enables organizations to create a foundational "landing zone" with Assured Workload overlays. It includes mappings of NIST 800-53r5 controls to streamline achieving ATO. The deployment process is divided into stages, each focusing on specific components like resource management, networking, and security configuration.
The Stellar Engine Cloud Foundation Fabric Detailed Deployment Guide (DDG) outlines a structured process for deploying a secure, compliant infrastructure on GCP using IaC. Designed to support compliance with standards such as FRM, FRH, IL4, and IL5, the guide enables organizations to create a foundational "landing zone" with Assured Workload overlays. It includes mappings of NIST 800-53r5 controls to streamline achieving ATO. The deployment process is divided into stages, each focusing on specific components like resource management, networking, and security configuration.

Key stages include Stage 0 (Bootstrap), which initializes the infrastructure, creates core Google Cloud Projects, and sets up service accounts; Stage 1 (Resource Management), which organizes Google Cloud Folders and Google Cloud Projects for tenants; and Stage 2 (Network Creation), which configures networking, including advanced setups like Palo Alto NGFWs for IL5 environments. The final stage, Stage 3 (Security and Audit Account Configuration), establishes security protocols, including Customer Managed Encryption Keys (CMEK) requirements and logging for audit purposes. Each stage requires detailed configuration of Terraform variables and adherence to prerequisites like IAM roles, service account setups, and enabling Google Cloud services.

Expand All@@ -82,7 +82,7 @@ For more information, please look at the [TDD](./docs/tdd.md).

## Security Best Practices Guide

The Stellar Engine Security Best Practices Guide (SBPG) outlines a robust framework for deploying secure and compliant GCP infrastructure. Designed for organizations requiring adherence to FRH and IL5 standards, it employs IaC principles via Terraform. The Stellar Engine facilitates the automated creation of a baseline GCP environment, supporting modular deployment of both Google and approved third-party services. Its hierarchical architecture ensures effective organization, leveraging role-based access control (RBAC), strict IAM policies, and a hub-and-spoke VPC networking design for isolation and scalability.
The Stellar Engine Security Best Practices Guide (SBPG) outlines a robust framework for deploying secure and compliant GCP infrastructure. Designed for organizations requiring adherence to FRM, FRH, and IL5 standards, it employs IaC principles via Terraform. The Stellar Engine facilitates the automated creation of a baseline GCP environment, supporting modular deployment of both Google and approved third-party services. Its hierarchical architecture ensures effective organization, leveraging role-based access control (RBAC), strict IAM policies, and a hub-and-spoke VPC networking design for isolation and scalability.

The document emphasizes best practices in identity and access management, security monitoring, and compliance. IAM configurations focus on the principle of least privilege, with automation enabling minimal human interaction during setup. Security features include encryption-at-rest, TLS enforcement, and centralized logging and monitoring through audit logs, VPC flow logs, and other diagnostics. The system supports Assured Workloads, providing region-specific data residency and compliance settings to meet regulatory requirements.

Expand Down
2 changes: 1 addition & 1 deletion blueprints/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -45,7 +45,7 @@ For more information, please see the individual README files in each blueprint's
| [Secret Manager](./fedramp-high/secret-manager/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |
| [Shielded VM Project](./il5/shielded-vm-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [Vertex MLOps](./fedramp-high/vertex-mlops/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |
| [VPC Peering Project](./il5/vpc-peering-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [VPC Peering Project](./stand-alone/vpc-peering-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [Workflows](./fedramp-high/workflows/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |

<br>
Expand Down
1 change: 0 additions & 1 deletion blueprints/il5/compute-engine/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -119,4 +119,3 @@ keyrings-keys = {
## Verification of a successful deployment?

- Go to the Compute Engine in the GCP Console. Select the VM. Check the Presistent Disk Encryption
![GCP Compute Engine Instance Presistent Disk Encryption](./images/vm-disk-1.png?raw=true "GCP Compute Engine Instance Presistent Disk Encryption")
2 changes: 1 addition & 1 deletion blueprints/third-party-solutions/gitlab/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -242,7 +242,7 @@ following [link](https://docs.gitlab.com/omnibus/settings/ssl/#configure-https-m
If you want to deploy from your Cloud Shell, click on the image below, sign in
if required and when the prompt appears, click on “confirm”.

[![Open Cloudshell](../../../assets/images/cloud-shell-button.png)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fcloud-foundation-fabric&cloudshell_workspace=blueprints%2Fthird-party-solutions%2Fwordpress%2Fcloudrun)
![Open Cloudshell](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fcloud-foundation-fabric&cloudshell_workspace=blueprints%2Fthird-party-solutions%2Fwordpress%2Fcloudrun)

Otherwise, in your console of choice:

Expand Down
8 changes: 4 additions & 4 deletions docs/ddg.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -20,7 +20,7 @@ environment with the Assured Workload overlays. The project has been confirmed
to work with (DISA) Impact Level 5 (IL5), Impact Level 4 (IL4), and FedRAMP
High, but will function as a starting point for any other Assured Workloads
overlay. In addition to the IaC, there is documentation available for both the
IL5and FedRAMP High compliance regimes that provide a mapping of National
IL5, FedRAMP High, and FedRAMP Moderate compliance regimes that provide a mapping of National
Institute of Standards and Technology (NIST) 800-53r5 controls to enable
projects that leverage the Stellar Engine codebase to accelerate the speed at
which an Authorization to Operate (ATO) can be attained. These responses are
Expand DownExpand Up@@ -67,7 +67,7 @@ To make using this deployment guide easier, the variables described below need t
| :------------------------------------ | :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <strong>Billing Account</strong> | `billing_account.id` | The billing account to use for the deployment of the environments. <a href='https://console.cloud.google.com/billing'>Console Link</a> |
| <strong>Bootstrap Project ID</strong> | `bootstrap_project` | The bootstrap project id (created below) |
| <strong>Compliance Regime</strong> | `assured_workloads.regime` | The <a href='https://assuredworkloads.googleapis.com/$discovery/rest?version=v1'>compliance regime</a> for this environment, (confirmed working in IL4, IL5, FEDRAMP_HIGH, and COMPLIANCE_REGIME_UNSPECIFIED) |
| <strong>Compliance Regime</strong> | `assured_workloads.regime` | The <a href='https://assuredworkloads.googleapis.com/$discovery/rest?version=v1'>compliance regime</a> for this environment, (confirmed working in IL4, IL5, FEDRAMP_MODERATE, FEDRAMP_HIGH, and COMPLIANCE_REGIME_UNSPECIFIED) |
| <strong>Customer ID</strong> | `organization.customer_id` | The Google Workspace Directory Customer ID. <br/>Run <strong>gcloud organizations list</strong> to view. |
| <strong>Domain Name</strong> | `organization.domain` | The primary Fully Qualified Domain Name (FQDN). Run <strong>gcloud organizations list</strong> to view (make sure you have authorized as per prerequisites below) |
| <strong>Alert Email</strong> | `alert_email` | The email address used for logging alerts notifications. |
Expand DownExpand Up@@ -207,7 +207,7 @@ billing_account = {
id = "`<billing_account_id>`" # taken from Google Cloud Console Billing Accounts -> Manage Billing Account
}
# region configuration - this will automatically populate locations for GCS, BigQuery, KMS, and logging buckets
# Default to us-east4 for IL5/FedRAMP compliance - adjust as needed
# Default to us-east4 for IL5/FedRAMP High/Moderate compliance - adjust as needed
regions = {
primary = "`<region>`"
}
Expand DownExpand Up@@ -391,7 +391,7 @@ gcloud storage cp gs://${FAST_PREFIX}-prod-iac-core-outputs-0/tfvars/0-bootstrap

## Stage 2 - Network Creation

## FedRAMP High - Stage 2.1 Networking
## FedRAMP High / Moderate - Stage 2.1 Networking

### Steps

Expand Down
8 changes: 4 additions & 4 deletions docs/path-to-authorization.md
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
# Path to Authorization

_Impact Level 5 (H-H-X)& FedRAMP High_
_Impact Level 5 (H-H-X), FedRAMP High & FedRAMP Moderate_

**Created Date:**

Expand DownExpand Up@@ -67,7 +67,7 @@ privacy risks
managed, and authorized for operation or use.
- [Impact Level 5 Authorization
Boundary](https://forms.gle/zdv7Gip4opmdhBqk7)
- [FedRAMP High Authorization
- [FedRAMP High & Moderate Authorization
Boundary](https://forms.gle/zdv7Gip4opmdhBqk7)
- Regularly assess the security and privacy risks at the organization level
and system level. Update risk assessment results on an on-going basis.
Expand DownExpand Up@@ -111,10 +111,10 @@ risk assessment(s)
frequency in which the controls are monitored?
- [Security Control Traceability Matrix (SCTM)
Templates](https://forms.gle/zdv7Gip4opmdhBqk7)
(IL5 H-H-Xand FedRAMP High Baselines)
(IL5 H-H-X, FedRAMP High, and FedRAMP Moderate Baselines)
- [Policies and Procedures
Templates](https://forms.gle/zdv7Gip4opmdhBqk7)
(IL5 HHXand FedRAMP High Baselines)
(IL5 HHX, FedRAMP High, and FedRAMP Moderate Baselines)

[**Step 3;
Implement**](https://csrc.nist.gov/Projects/risk-management/about-rmf/implement-step):
Expand Down
Loading
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { // Force GitHub README to respect dark mode (function() { var style = document.createElement('style'); style.textContent = ' .markdown-body { color-scheme: dark light; } .markdown-body pre { background: #161b22 !important; } .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; } .markdown-body table th, .markdown-body table td { border-color: #30363d !important; } .markdown-body img { background: #0d1117; } .markdown-body blockquote { border-left-color: #8b949e; } .markdown-body hr { border-color: #30363d; } '; document.head.appendChild(style); })(); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/bug_report.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -19,6 +19,7 @@ Please provide details about your deployment to help us reproduce the issue.
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Medium
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] Stand-alone / Custom
Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/documentation-suggestion.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -20,4 +20,4 @@ Where should this documentation live? e.g., existing file in `docs/`, a new file
Please provide a draft or outline of the content you would like to add.

## Compliance Context (if applicable)
Does this documentation relate to a specific compliance regime (FedRAMP High, IL5) or NIST control?
Does this documentation relate to a specific compliance regime (FedRAMP Moderate, FedRAMP High, IL5) or NIST control?
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/feature_request.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -22,6 +22,7 @@ A clear and concise description of what you want to happen.
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Medium
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] All / General
Expand Down
3 changes: 2 additions & 1 deletion .github/pull_request_template.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -14,6 +14,7 @@ Fixes # (GitHub issue id)
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Moderate
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] General / All
Expand All@@ -32,7 +33,7 @@ Fixes # (GitHub issue id)

### Security
- [ ] My change adheres to GCP security best practices and the principle of least privilege.
- [ ] I have ensured compliance with the targeted regime (FedRAMP High, IL5, etc.).
- [ ] I have ensured compliance with the targeted regime (FedRAMP Moderate, FedRAMP High, IL5, etc.).

### Testing
- [ ] I have tested my changes locally.
Expand Down
4 changes: 2 additions & 2 deletions GEMINI.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -4,7 +4,7 @@

Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF), providing Infrastructure as Code (IaC) to help Google Cloud Platform
(GCP) customers create secure and compliant landing zones. It has a strong focus on environments requiring Assured Workload overlays, such
as FedRAMP High, IL4, and IL5, and includes documentation mapping NIST 800-53r5 controls to accelerate Authorization to Operate (ATO)
as FedRAMP Moderate, FedRAMP High, IL4, and IL5, and includes documentation mapping NIST 800-53r5 controls to accelerate Authorization to Operate (ATO)
processes.

**Key Technologies:** Terraform, Google Cloud Platform (GCP)
Expand DownExpand Up@@ -35,7 +35,7 @@ outputs, and any dependencies.
Consistency in naming variables, resources, modules, and files is crucial.

5. **Security:** Adhere to GCP security best practices and the principle of least privilege in all configurations. Ensure compliance with
the targeted regime (FedRAMP High, IL5, etc.).
the targeted regime (FedRAMP Moderate, FedRAMP High, IL5, etc.).

## Key Codebase Resources

Expand Down
14 changes: 7 additions & 7 deletions README.md
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
## Introduction

Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF) repository, aimed at providing Infrastructure as Code (IaC) for Google Cloud Platform (GCP) customers who need to create a landing zone environment with the Assured Workload overlays. In addition to the IaC, there is [documentation available](./docs/path-to-authorization.md) for both FedRAMP High (FRH), Department of Defense (DoD) Impact Level 4 (IL4) and DoD Impact Level (IL5) compliance regimes that provide a mapping of National Institute of Standards and Technology (NIST) 800-53r5 controls to enable projects that leverage the Stellar Engine codebase to accelerate the speed at which an Authorization to Operate (ATO) can be attained.
Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF) repository, aimed at providing Infrastructure as Code (IaC) for Google Cloud Platform (GCP) customers who need to create a landing zone environment with the Assured Workload overlays. In addition to the IaC, there is [documentation available](/docs/path-to-authorization.md) for FedRAMP High (FRH), FedRAMP Moderate (FRM), Department of Defense (DoD) Impact Level 4 (IL4) and DoD Impact Level (IL5) compliance regimes that provide a mapping of National Institute of Standards and Technology (NIST) 800-53r5 controls to enable projects that leverage the Stellar Engine codebase to accelerate the speed at which an Authorization to Operate (ATO) can be attained.

## Getting Started

Expand All@@ -14,7 +14,7 @@ This repository provides **end-to-end blueprints** and a **suite of Terraform mo

The target audience for Stellar Engine is organizations and teams that operate in regulated industries or require robust compliance and security frameworks. Below are a few examples of these such users:

- **Government Agencies:** Agencies and contractors, such as those that work with FRH, IL4, and IL5 environments. <br />
- **Government Agencies:** Agencies and contractors, such as those that work with FRM, FRH, IL4, and IL5 environments. <br />
- **Regulated Industries:** Regulated industries often face overlapping compliance and security requirements; Stellar Engine can simplify that. <br />
- **Educational and Research Institutions:** Universities and research organizations working on government-funded projects that require secure and compliant cloud environments. <br />

Expand DownExpand Up@@ -45,26 +45,26 @@ The suite of modules in this repository is designed for rapid composition and re

All modules share a similar interface where each module tries to stay close to the underlying provider resources, support IAM together with resource creation and modification, offer the option of creating multiple resources where it makes sense (e.g. not for projects), and be completely free of side-effects (e.g. no external commands).

A well-defined naming standard is used across Stellar Engine to ensure adherence to Google Cloud's best practices, naming requirements, and naming collision avoidance for global resources. The Google Cloud naming standard documentation is [here](./documentation/naming-convention.md) and will be used before the Stellar Engine deployment begins by choosing a naming standard that will flow through the Google Cloud infrastructure state.
A well-defined naming standard is used across Stellar Engine to ensure adherence to Google Cloud's best practices, naming requirements, and naming collision avoidance for global resources. The Google Cloud naming standard documentation is [here](/docs/naming-convention.md) and will be used before the Stellar Engine deployment begins by choosing a naming standard that will flow through the Google Cloud infrastructure state.

The current modules support most of the core foundational and networking components used to design end-to-end infrastructure, with more modules in active development for specialized compute, security, and data scenarios.

For more information and usage examples see each module's README file, as well as any associated blueprints.

## End-to-End Blueprints

Stellar Engine currently offers blueprints that are compliant with [FRH](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-high) and [IL5](https://github.com/google/stellar-engine/tree/main/blueprints/il5) baselines. </br>
Stellar Engine currently offers blueprints that are compliant with [FRM](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-moderate), [FRH](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-high), and [IL5](https://github.com/google/stellar-engine/tree/main/blueprints/il5) baselines. </br>
These blueprints range from full end-to-end services like a Cloud Native Access Point (CNAP), to ad-hoc services that are designed to be molded to users' individual use cases.

For more information, please look at each blueprint's README file.

## Cybersecurity Documentation

In addition to the IaC, Stellar Engine provides supporting documentation that maps NIST 800-53r5 controls for users leveraging the IaC. This documentation is designed to streamline achieving ATO by providing generalized templates. All documentation can be requested [here](https://forms.gle/zdv7Gip4opmdhBqk7). For how to utilize these documents, please see the following [Path to Authorization](./docs/path-to-authorization.md) guide.
In addition to the IaC, Stellar Engine provides supporting documentation that maps NIST 800-53r5 controls for users leveraging the IaC. This documentation is designed to streamline achieving ATO by providing generalized templates. All documentation can be requested [here](https://forms.gle/zdv7Gip4opmdhBqk7). For how to utilize these documents, please see the following [Path to Authorization](/docs/path-to-authorization.md) guide.

## Detailed Deployment Guide

The Stellar Engine Cloud Foundation Fabric Detailed Deployment Guide (DDG) outlines a structured process for deploying a secure, compliant infrastructure on GCP using IaC. Designed to support compliance with standards such as FRH, IL4, and IL5, the guide enables organizations to create a foundational "landing zone" with Assured Workload overlays. It includes mappings of NIST 800-53r5 controls to streamline achieving ATO. The deployment process is divided into stages, each focusing on specific components like resource management, networking, and security configuration.
The Stellar Engine Cloud Foundation Fabric Detailed Deployment Guide (DDG) outlines a structured process for deploying a secure, compliant infrastructure on GCP using IaC. Designed to support compliance with standards such as FRM, FRH, IL4, and IL5, the guide enables organizations to create a foundational "landing zone" with Assured Workload overlays. It includes mappings of NIST 800-53r5 controls to streamline achieving ATO. The deployment process is divided into stages, each focusing on specific components like resource management, networking, and security configuration.

Key stages include Stage 0 (Bootstrap), which initializes the infrastructure, creates core Google Cloud Projects, and sets up service accounts; Stage 1 (Resource Management), which organizes Google Cloud Folders and Google Cloud Projects for tenants; and Stage 2 (Network Creation), which configures networking, including advanced setups like Palo Alto NGFWs for IL5 environments. The final stage, Stage 3 (Security and Audit Account Configuration), establishes security protocols, including Customer Managed Encryption Keys (CMEK) requirements and logging for audit purposes. Each stage requires detailed configuration of Terraform variables and adherence to prerequisites like IAM roles, service account setups, and enabling Google Cloud services.

Expand All@@ -82,7 +82,7 @@ For more information, please look at the [TDD](./docs/tdd.md).

## Security Best Practices Guide

The Stellar Engine Security Best Practices Guide (SBPG) outlines a robust framework for deploying secure and compliant GCP infrastructure. Designed for organizations requiring adherence to FRH and IL5 standards, it employs IaC principles via Terraform. The Stellar Engine facilitates the automated creation of a baseline GCP environment, supporting modular deployment of both Google and approved third-party services. Its hierarchical architecture ensures effective organization, leveraging role-based access control (RBAC), strict IAM policies, and a hub-and-spoke VPC networking design for isolation and scalability.
The Stellar Engine Security Best Practices Guide (SBPG) outlines a robust framework for deploying secure and compliant GCP infrastructure. Designed for organizations requiring adherence to FRM, FRH, and IL5 standards, it employs IaC principles via Terraform. The Stellar Engine facilitates the automated creation of a baseline GCP environment, supporting modular deployment of both Google and approved third-party services. Its hierarchical architecture ensures effective organization, leveraging role-based access control (RBAC), strict IAM policies, and a hub-and-spoke VPC networking design for isolation and scalability.

The document emphasizes best practices in identity and access management, security monitoring, and compliance. IAM configurations focus on the principle of least privilege, with automation enabling minimal human interaction during setup. Security features include encryption-at-rest, TLS enforcement, and centralized logging and monitoring through audit logs, VPC flow logs, and other diagnostics. The system supports Assured Workloads, providing region-specific data residency and compliance settings to meet regulatory requirements.

Expand Down
2 changes: 1 addition & 1 deletion blueprints/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -45,7 +45,7 @@ For more information, please see the individual README files in each blueprint's
| [Secret Manager](./fedramp-high/secret-manager/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |
| [Shielded VM Project](./il5/shielded-vm-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [Vertex MLOps](./fedramp-high/vertex-mlops/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |
| [VPC Peering Project](./il5/vpc-peering-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [VPC Peering Project](./stand-alone/vpc-peering-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [Workflows](./fedramp-high/workflows/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |

<br>
Expand Down
1 change: 0 additions & 1 deletion blueprints/il5/compute-engine/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -119,4 +119,3 @@ keyrings-keys = {
## Verification of a successful deployment?

- Go to the Compute Engine in the GCP Console. Select the VM. Check the Presistent Disk Encryption
![GCP Compute Engine Instance Presistent Disk Encryption](./images/vm-disk-1.png?raw=true "GCP Compute Engine Instance Presistent Disk Encryption")
2 changes: 1 addition & 1 deletion blueprints/third-party-solutions/gitlab/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -242,7 +242,7 @@ following [link](https://docs.gitlab.com/omnibus/settings/ssl/#configure-https-m
If you want to deploy from your Cloud Shell, click on the image below, sign in
if required and when the prompt appears, click on “confirm”.

[![Open Cloudshell](../../../assets/images/cloud-shell-button.png)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fcloud-foundation-fabric&cloudshell_workspace=blueprints%2Fthird-party-solutions%2Fwordpress%2Fcloudrun)
![Open Cloudshell](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fcloud-foundation-fabric&cloudshell_workspace=blueprints%2Fthird-party-solutions%2Fwordpress%2Fcloudrun)

Otherwise, in your console of choice:

Expand Down
8 changes: 4 additions & 4 deletions docs/ddg.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -20,7 +20,7 @@ environment with the Assured Workload overlays. The project has been confirmed
to work with (DISA) Impact Level 5 (IL5), Impact Level 4 (IL4), and FedRAMP
High, but will function as a starting point for any other Assured Workloads
overlay. In addition to the IaC, there is documentation available for both the
IL5and FedRAMP High compliance regimes that provide a mapping of National
IL5, FedRAMP High, and FedRAMP Moderate compliance regimes that provide a mapping of National
Institute of Standards and Technology (NIST) 800-53r5 controls to enable
projects that leverage the Stellar Engine codebase to accelerate the speed at
which an Authorization to Operate (ATO) can be attained. These responses are
Expand DownExpand Up@@ -67,7 +67,7 @@ To make using this deployment guide easier, the variables described below need t
| :------------------------------------ | :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <strong>Billing Account</strong> | `billing_account.id` | The billing account to use for the deployment of the environments. <a href='https://console.cloud.google.com/billing'>Console Link</a> |
| <strong>Bootstrap Project ID</strong> | `bootstrap_project` | The bootstrap project id (created below) |
| <strong>Compliance Regime</strong> | `assured_workloads.regime` | The <a href='https://assuredworkloads.googleapis.com/$discovery/rest?version=v1'>compliance regime</a> for this environment, (confirmed working in IL4, IL5, FEDRAMP_HIGH, and COMPLIANCE_REGIME_UNSPECIFIED) |
| <strong>Compliance Regime</strong> | `assured_workloads.regime` | The <a href='https://assuredworkloads.googleapis.com/$discovery/rest?version=v1'>compliance regime</a> for this environment, (confirmed working in IL4, IL5, FEDRAMP_MODERATE, FEDRAMP_HIGH, and COMPLIANCE_REGIME_UNSPECIFIED) |
| <strong>Customer ID</strong> | `organization.customer_id` | The Google Workspace Directory Customer ID. <br/>Run <strong>gcloud organizations list</strong> to view. |
| <strong>Domain Name</strong> | `organization.domain` | The primary Fully Qualified Domain Name (FQDN). Run <strong>gcloud organizations list</strong> to view (make sure you have authorized as per prerequisites below) |
| <strong>Alert Email</strong> | `alert_email` | The email address used for logging alerts notifications. |
Expand DownExpand Up@@ -207,7 +207,7 @@ billing_account = {
id = "`<billing_account_id>`" # taken from Google Cloud Console Billing Accounts -> Manage Billing Account
}
# region configuration - this will automatically populate locations for GCS, BigQuery, KMS, and logging buckets
# Default to us-east4 for IL5/FedRAMP compliance - adjust as needed
# Default to us-east4 for IL5/FedRAMP High/Moderate compliance - adjust as needed
regions = {
primary = "`<region>`"
}
Expand DownExpand Up@@ -391,7 +391,7 @@ gcloud storage cp gs://${FAST_PREFIX}-prod-iac-core-outputs-0/tfvars/0-bootstrap

## Stage 2 - Network Creation

## FedRAMP High - Stage 2.1 Networking
## FedRAMP High / Moderate - Stage 2.1 Networking

### Steps

Expand Down
8 changes: 4 additions & 4 deletions docs/path-to-authorization.md
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
# Path to Authorization

_Impact Level 5 (H-H-X)& FedRAMP High_
_Impact Level 5 (H-H-X), FedRAMP High & FedRAMP Moderate_

**Created Date:**

Expand DownExpand Up@@ -67,7 +67,7 @@ privacy risks
managed, and authorized for operation or use.
- [Impact Level 5 Authorization
Boundary](https://forms.gle/zdv7Gip4opmdhBqk7)
- [FedRAMP High Authorization
- [FedRAMP High & Moderate Authorization
Boundary](https://forms.gle/zdv7Gip4opmdhBqk7)
- Regularly assess the security and privacy risks at the organization level
and system level. Update risk assessment results on an on-going basis.
Expand DownExpand Up@@ -111,10 +111,10 @@ risk assessment(s)
frequency in which the controls are monitored?
- [Security Control Traceability Matrix (SCTM)
Templates](https://forms.gle/zdv7Gip4opmdhBqk7)
(IL5 H-H-Xand FedRAMP High Baselines)
(IL5 H-H-X, FedRAMP High, and FedRAMP Moderate Baselines)
- [Policies and Procedures
Templates](https://forms.gle/zdv7Gip4opmdhBqk7)
(IL5 HHXand FedRAMP High Baselines)
(IL5 HHX, FedRAMP High, and FedRAMP Moderate Baselines)

[**Step 3;
Implement**](https://csrc.nist.gov/Projects/risk-management/about-rmf/implement-step):
Expand Down
Loading
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { // Highlight search terms from Google/DuckDuckGo/Bing referrer (function() { var ref = document.referrer; var terms = []; if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) { var url = new URL(ref); var q = url.searchParams.get('q') || url.searchParams.get('p'); if (q) { terms = q.split(/\s+/).filter(function(t) { return t.length > 2; }); } } if (terms.length === 0) return; var style = document.createElement('style'); style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }'; document.head.appendChild(style); function highlight(node) { if (node.nodeType === 3) { // text node var text = node.textContent; var found = false; terms.forEach(function(term) { var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/bug_report.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -19,6 +19,7 @@ Please provide details about your deployment to help us reproduce the issue.
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Medium
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] Stand-alone / Custom
Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/documentation-suggestion.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -20,4 +20,4 @@ Where should this documentation live? e.g., existing file in `docs/`, a new file
Please provide a draft or outline of the content you would like to add.

## Compliance Context (if applicable)
Does this documentation relate to a specific compliance regime (FedRAMP High, IL5) or NIST control?
Does this documentation relate to a specific compliance regime (FedRAMP Moderate, FedRAMP High, IL5) or NIST control?
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/feature_request.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -22,6 +22,7 @@ A clear and concise description of what you want to happen.
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Medium
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] All / General
Expand Down
3 changes: 2 additions & 1 deletion .github/pull_request_template.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -14,6 +14,7 @@ Fixes # (GitHub issue id)
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Moderate
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] General / All
Expand All@@ -32,7 +33,7 @@ Fixes # (GitHub issue id)

### Security
- [ ] My change adheres to GCP security best practices and the principle of least privilege.
- [ ] I have ensured compliance with the targeted regime (FedRAMP High, IL5, etc.).
- [ ] I have ensured compliance with the targeted regime (FedRAMP Moderate, FedRAMP High, IL5, etc.).

### Testing
- [ ] I have tested my changes locally.
Expand Down
4 changes: 2 additions & 2 deletions GEMINI.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -4,7 +4,7 @@

Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF), providing Infrastructure as Code (IaC) to help Google Cloud Platform
(GCP) customers create secure and compliant landing zones. It has a strong focus on environments requiring Assured Workload overlays, such
as FedRAMP High, IL4, and IL5, and includes documentation mapping NIST 800-53r5 controls to accelerate Authorization to Operate (ATO)
as FedRAMP Moderate, FedRAMP High, IL4, and IL5, and includes documentation mapping NIST 800-53r5 controls to accelerate Authorization to Operate (ATO)
processes.

**Key Technologies:** Terraform, Google Cloud Platform (GCP)
Expand DownExpand Up@@ -35,7 +35,7 @@ outputs, and any dependencies.
Consistency in naming variables, resources, modules, and files is crucial.

5. **Security:** Adhere to GCP security best practices and the principle of least privilege in all configurations. Ensure compliance with
the targeted regime (FedRAMP High, IL5, etc.).
the targeted regime (FedRAMP Moderate, FedRAMP High, IL5, etc.).

## Key Codebase Resources

Expand Down
14 changes: 7 additions & 7 deletions README.md
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
## Introduction

Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF) repository, aimed at providing Infrastructure as Code (IaC) for Google Cloud Platform (GCP) customers who need to create a landing zone environment with the Assured Workload overlays. In addition to the IaC, there is [documentation available](./docs/path-to-authorization.md) for both FedRAMP High (FRH), Department of Defense (DoD) Impact Level 4 (IL4) and DoD Impact Level (IL5) compliance regimes that provide a mapping of National Institute of Standards and Technology (NIST) 800-53r5 controls to enable projects that leverage the Stellar Engine codebase to accelerate the speed at which an Authorization to Operate (ATO) can be attained.
Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF) repository, aimed at providing Infrastructure as Code (IaC) for Google Cloud Platform (GCP) customers who need to create a landing zone environment with the Assured Workload overlays. In addition to the IaC, there is [documentation available](/docs/path-to-authorization.md) for FedRAMP High (FRH), FedRAMP Moderate (FRM), Department of Defense (DoD) Impact Level 4 (IL4) and DoD Impact Level (IL5) compliance regimes that provide a mapping of National Institute of Standards and Technology (NIST) 800-53r5 controls to enable projects that leverage the Stellar Engine codebase to accelerate the speed at which an Authorization to Operate (ATO) can be attained.

## Getting Started

Expand All@@ -14,7 +14,7 @@ This repository provides **end-to-end blueprints** and a **suite of Terraform mo

The target audience for Stellar Engine is organizations and teams that operate in regulated industries or require robust compliance and security frameworks. Below are a few examples of these such users:

- **Government Agencies:** Agencies and contractors, such as those that work with FRH, IL4, and IL5 environments. <br />
- **Government Agencies:** Agencies and contractors, such as those that work with FRM, FRH, IL4, and IL5 environments. <br />
- **Regulated Industries:** Regulated industries often face overlapping compliance and security requirements; Stellar Engine can simplify that. <br />
- **Educational and Research Institutions:** Universities and research organizations working on government-funded projects that require secure and compliant cloud environments. <br />

Expand DownExpand Up@@ -45,26 +45,26 @@ The suite of modules in this repository is designed for rapid composition and re

All modules share a similar interface where each module tries to stay close to the underlying provider resources, support IAM together with resource creation and modification, offer the option of creating multiple resources where it makes sense (e.g. not for projects), and be completely free of side-effects (e.g. no external commands).

A well-defined naming standard is used across Stellar Engine to ensure adherence to Google Cloud's best practices, naming requirements, and naming collision avoidance for global resources. The Google Cloud naming standard documentation is [here](./documentation/naming-convention.md) and will be used before the Stellar Engine deployment begins by choosing a naming standard that will flow through the Google Cloud infrastructure state.
A well-defined naming standard is used across Stellar Engine to ensure adherence to Google Cloud's best practices, naming requirements, and naming collision avoidance for global resources. The Google Cloud naming standard documentation is [here](/docs/naming-convention.md) and will be used before the Stellar Engine deployment begins by choosing a naming standard that will flow through the Google Cloud infrastructure state.

The current modules support most of the core foundational and networking components used to design end-to-end infrastructure, with more modules in active development for specialized compute, security, and data scenarios.

For more information and usage examples see each module's README file, as well as any associated blueprints.

## End-to-End Blueprints

Stellar Engine currently offers blueprints that are compliant with [FRH](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-high) and [IL5](https://github.com/google/stellar-engine/tree/main/blueprints/il5) baselines. </br>
Stellar Engine currently offers blueprints that are compliant with [FRM](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-moderate), [FRH](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-high), and [IL5](https://github.com/google/stellar-engine/tree/main/blueprints/il5) baselines. </br>
These blueprints range from full end-to-end services like a Cloud Native Access Point (CNAP), to ad-hoc services that are designed to be molded to users' individual use cases.

For more information, please look at each blueprint's README file.

## Cybersecurity Documentation

In addition to the IaC, Stellar Engine provides supporting documentation that maps NIST 800-53r5 controls for users leveraging the IaC. This documentation is designed to streamline achieving ATO by providing generalized templates. All documentation can be requested [here](https://forms.gle/zdv7Gip4opmdhBqk7). For how to utilize these documents, please see the following [Path to Authorization](./docs/path-to-authorization.md) guide.
In addition to the IaC, Stellar Engine provides supporting documentation that maps NIST 800-53r5 controls for users leveraging the IaC. This documentation is designed to streamline achieving ATO by providing generalized templates. All documentation can be requested [here](https://forms.gle/zdv7Gip4opmdhBqk7). For how to utilize these documents, please see the following [Path to Authorization](/docs/path-to-authorization.md) guide.

## Detailed Deployment Guide

The Stellar Engine Cloud Foundation Fabric Detailed Deployment Guide (DDG) outlines a structured process for deploying a secure, compliant infrastructure on GCP using IaC. Designed to support compliance with standards such as FRH, IL4, and IL5, the guide enables organizations to create a foundational "landing zone" with Assured Workload overlays. It includes mappings of NIST 800-53r5 controls to streamline achieving ATO. The deployment process is divided into stages, each focusing on specific components like resource management, networking, and security configuration.
The Stellar Engine Cloud Foundation Fabric Detailed Deployment Guide (DDG) outlines a structured process for deploying a secure, compliant infrastructure on GCP using IaC. Designed to support compliance with standards such as FRM, FRH, IL4, and IL5, the guide enables organizations to create a foundational "landing zone" with Assured Workload overlays. It includes mappings of NIST 800-53r5 controls to streamline achieving ATO. The deployment process is divided into stages, each focusing on specific components like resource management, networking, and security configuration.

Key stages include Stage 0 (Bootstrap), which initializes the infrastructure, creates core Google Cloud Projects, and sets up service accounts; Stage 1 (Resource Management), which organizes Google Cloud Folders and Google Cloud Projects for tenants; and Stage 2 (Network Creation), which configures networking, including advanced setups like Palo Alto NGFWs for IL5 environments. The final stage, Stage 3 (Security and Audit Account Configuration), establishes security protocols, including Customer Managed Encryption Keys (CMEK) requirements and logging for audit purposes. Each stage requires detailed configuration of Terraform variables and adherence to prerequisites like IAM roles, service account setups, and enabling Google Cloud services.

Expand All@@ -82,7 +82,7 @@ For more information, please look at the [TDD](./docs/tdd.md).

## Security Best Practices Guide

The Stellar Engine Security Best Practices Guide (SBPG) outlines a robust framework for deploying secure and compliant GCP infrastructure. Designed for organizations requiring adherence to FRH and IL5 standards, it employs IaC principles via Terraform. The Stellar Engine facilitates the automated creation of a baseline GCP environment, supporting modular deployment of both Google and approved third-party services. Its hierarchical architecture ensures effective organization, leveraging role-based access control (RBAC), strict IAM policies, and a hub-and-spoke VPC networking design for isolation and scalability.
The Stellar Engine Security Best Practices Guide (SBPG) outlines a robust framework for deploying secure and compliant GCP infrastructure. Designed for organizations requiring adherence to FRM, FRH, and IL5 standards, it employs IaC principles via Terraform. The Stellar Engine facilitates the automated creation of a baseline GCP environment, supporting modular deployment of both Google and approved third-party services. Its hierarchical architecture ensures effective organization, leveraging role-based access control (RBAC), strict IAM policies, and a hub-and-spoke VPC networking design for isolation and scalability.

The document emphasizes best practices in identity and access management, security monitoring, and compliance. IAM configurations focus on the principle of least privilege, with automation enabling minimal human interaction during setup. Security features include encryption-at-rest, TLS enforcement, and centralized logging and monitoring through audit logs, VPC flow logs, and other diagnostics. The system supports Assured Workloads, providing region-specific data residency and compliance settings to meet regulatory requirements.

Expand Down
2 changes: 1 addition & 1 deletion blueprints/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -45,7 +45,7 @@ For more information, please see the individual README files in each blueprint's
| [Secret Manager](./fedramp-high/secret-manager/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |
| [Shielded VM Project](./il5/shielded-vm-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [Vertex MLOps](./fedramp-high/vertex-mlops/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |
| [VPC Peering Project](./il5/vpc-peering-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [VPC Peering Project](./stand-alone/vpc-peering-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [Workflows](./fedramp-high/workflows/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |

<br>
Expand Down
1 change: 0 additions & 1 deletion blueprints/il5/compute-engine/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -119,4 +119,3 @@ keyrings-keys = {
## Verification of a successful deployment?

- Go to the Compute Engine in the GCP Console. Select the VM. Check the Presistent Disk Encryption
![GCP Compute Engine Instance Presistent Disk Encryption](./images/vm-disk-1.png?raw=true "GCP Compute Engine Instance Presistent Disk Encryption")
2 changes: 1 addition & 1 deletion blueprints/third-party-solutions/gitlab/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -242,7 +242,7 @@ following [link](https://docs.gitlab.com/omnibus/settings/ssl/#configure-https-m
If you want to deploy from your Cloud Shell, click on the image below, sign in
if required and when the prompt appears, click on “confirm”.

[![Open Cloudshell](../../../assets/images/cloud-shell-button.png)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fcloud-foundation-fabric&cloudshell_workspace=blueprints%2Fthird-party-solutions%2Fwordpress%2Fcloudrun)
![Open Cloudshell](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fcloud-foundation-fabric&cloudshell_workspace=blueprints%2Fthird-party-solutions%2Fwordpress%2Fcloudrun)

Otherwise, in your console of choice:

Expand Down
8 changes: 4 additions & 4 deletions docs/ddg.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -20,7 +20,7 @@ environment with the Assured Workload overlays. The project has been confirmed
to work with (DISA) Impact Level 5 (IL5), Impact Level 4 (IL4), and FedRAMP
High, but will function as a starting point for any other Assured Workloads
overlay. In addition to the IaC, there is documentation available for both the
IL5and FedRAMP High compliance regimes that provide a mapping of National
IL5, FedRAMP High, and FedRAMP Moderate compliance regimes that provide a mapping of National
Institute of Standards and Technology (NIST) 800-53r5 controls to enable
projects that leverage the Stellar Engine codebase to accelerate the speed at
which an Authorization to Operate (ATO) can be attained. These responses are
Expand DownExpand Up@@ -67,7 +67,7 @@ To make using this deployment guide easier, the variables described below need t
| :------------------------------------ | :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <strong>Billing Account</strong> | `billing_account.id` | The billing account to use for the deployment of the environments. <a href='https://console.cloud.google.com/billing'>Console Link</a> |
| <strong>Bootstrap Project ID</strong> | `bootstrap_project` | The bootstrap project id (created below) |
| <strong>Compliance Regime</strong> | `assured_workloads.regime` | The <a href='https://assuredworkloads.googleapis.com/$discovery/rest?version=v1'>compliance regime</a> for this environment, (confirmed working in IL4, IL5, FEDRAMP_HIGH, and COMPLIANCE_REGIME_UNSPECIFIED) |
| <strong>Compliance Regime</strong> | `assured_workloads.regime` | The <a href='https://assuredworkloads.googleapis.com/$discovery/rest?version=v1'>compliance regime</a> for this environment, (confirmed working in IL4, IL5, FEDRAMP_MODERATE, FEDRAMP_HIGH, and COMPLIANCE_REGIME_UNSPECIFIED) |
| <strong>Customer ID</strong> | `organization.customer_id` | The Google Workspace Directory Customer ID. <br/>Run <strong>gcloud organizations list</strong> to view. |
| <strong>Domain Name</strong> | `organization.domain` | The primary Fully Qualified Domain Name (FQDN). Run <strong>gcloud organizations list</strong> to view (make sure you have authorized as per prerequisites below) |
| <strong>Alert Email</strong> | `alert_email` | The email address used for logging alerts notifications. |
Expand DownExpand Up@@ -207,7 +207,7 @@ billing_account = {
id = "`<billing_account_id>`" # taken from Google Cloud Console Billing Accounts -> Manage Billing Account
}
# region configuration - this will automatically populate locations for GCS, BigQuery, KMS, and logging buckets
# Default to us-east4 for IL5/FedRAMP compliance - adjust as needed
# Default to us-east4 for IL5/FedRAMP High/Moderate compliance - adjust as needed
regions = {
primary = "`<region>`"
}
Expand DownExpand Up@@ -391,7 +391,7 @@ gcloud storage cp gs://${FAST_PREFIX}-prod-iac-core-outputs-0/tfvars/0-bootstrap

## Stage 2 - Network Creation

## FedRAMP High - Stage 2.1 Networking
## FedRAMP High / Moderate - Stage 2.1 Networking

### Steps

Expand Down
8 changes: 4 additions & 4 deletions docs/path-to-authorization.md
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
# Path to Authorization

_Impact Level 5 (H-H-X)& FedRAMP High_
_Impact Level 5 (H-H-X), FedRAMP High & FedRAMP Moderate_

**Created Date:**

Expand DownExpand Up@@ -67,7 +67,7 @@ privacy risks
managed, and authorized for operation or use.
- [Impact Level 5 Authorization
Boundary](https://forms.gle/zdv7Gip4opmdhBqk7)
- [FedRAMP High Authorization
- [FedRAMP High & Moderate Authorization
Boundary](https://forms.gle/zdv7Gip4opmdhBqk7)
- Regularly assess the security and privacy risks at the organization level
and system level. Update risk assessment results on an on-going basis.
Expand DownExpand Up@@ -111,10 +111,10 @@ risk assessment(s)
frequency in which the controls are monitored?
- [Security Control Traceability Matrix (SCTM)
Templates](https://forms.gle/zdv7Gip4opmdhBqk7)
(IL5 H-H-Xand FedRAMP High Baselines)
(IL5 H-H-X, FedRAMP High, and FedRAMP Moderate Baselines)
- [Policies and Procedures
Templates](https://forms.gle/zdv7Gip4opmdhBqk7)
(IL5 HHXand FedRAMP High Baselines)
(IL5 HHX, FedRAMP High, and FedRAMP Moderate Baselines)

[**Step 3;
Implement**](https://csrc.nist.gov/Projects/risk-management/about-rmf/implement-step):
Expand Down
Loading
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/bug_report.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -19,6 +19,7 @@ Please provide details about your deployment to help us reproduce the issue.
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Medium
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] Stand-alone / Custom
Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/documentation-suggestion.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -20,4 +20,4 @@ Where should this documentation live? e.g., existing file in `docs/`, a new file
Please provide a draft or outline of the content you would like to add.

## Compliance Context (if applicable)
Does this documentation relate to a specific compliance regime (FedRAMP High, IL5) or NIST control?
Does this documentation relate to a specific compliance regime (FedRAMP Moderate, FedRAMP High, IL5) or NIST control?
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/feature_request.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -22,6 +22,7 @@ A clear and concise description of what you want to happen.
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Medium
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] All / General
Expand Down
3 changes: 2 additions & 1 deletion .github/pull_request_template.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -14,6 +14,7 @@ Fixes # (GitHub issue id)
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Moderate
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] General / All
Expand All@@ -32,7 +33,7 @@ Fixes # (GitHub issue id)

### Security
- [ ] My change adheres to GCP security best practices and the principle of least privilege.
- [ ] I have ensured compliance with the targeted regime (FedRAMP High, IL5, etc.).
- [ ] I have ensured compliance with the targeted regime (FedRAMP Moderate, FedRAMP High, IL5, etc.).

### Testing
- [ ] I have tested my changes locally.
Expand Down
4 changes: 2 additions & 2 deletions GEMINI.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -4,7 +4,7 @@

Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF), providing Infrastructure as Code (IaC) to help Google Cloud Platform
(GCP) customers create secure and compliant landing zones. It has a strong focus on environments requiring Assured Workload overlays, such
as FedRAMP High, IL4, and IL5, and includes documentation mapping NIST 800-53r5 controls to accelerate Authorization to Operate (ATO)
as FedRAMP Moderate, FedRAMP High, IL4, and IL5, and includes documentation mapping NIST 800-53r5 controls to accelerate Authorization to Operate (ATO)
processes.

**Key Technologies:** Terraform, Google Cloud Platform (GCP)
Expand DownExpand Up@@ -35,7 +35,7 @@ outputs, and any dependencies.
Consistency in naming variables, resources, modules, and files is crucial.

5. **Security:** Adhere to GCP security best practices and the principle of least privilege in all configurations. Ensure compliance with
the targeted regime (FedRAMP High, IL5, etc.).
the targeted regime (FedRAMP Moderate, FedRAMP High, IL5, etc.).

## Key Codebase Resources

Expand Down
14 changes: 7 additions & 7 deletions README.md
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
## Introduction

Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF) repository, aimed at providing Infrastructure as Code (IaC) for Google Cloud Platform (GCP) customers who need to create a landing zone environment with the Assured Workload overlays. In addition to the IaC, there is [documentation available](./docs/path-to-authorization.md) for both FedRAMP High (FRH), Department of Defense (DoD) Impact Level 4 (IL4) and DoD Impact Level (IL5) compliance regimes that provide a mapping of National Institute of Standards and Technology (NIST) 800-53r5 controls to enable projects that leverage the Stellar Engine codebase to accelerate the speed at which an Authorization to Operate (ATO) can be attained.
Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF) repository, aimed at providing Infrastructure as Code (IaC) for Google Cloud Platform (GCP) customers who need to create a landing zone environment with the Assured Workload overlays. In addition to the IaC, there is [documentation available](/docs/path-to-authorization.md) for FedRAMP High (FRH), FedRAMP Moderate (FRM), Department of Defense (DoD) Impact Level 4 (IL4) and DoD Impact Level (IL5) compliance regimes that provide a mapping of National Institute of Standards and Technology (NIST) 800-53r5 controls to enable projects that leverage the Stellar Engine codebase to accelerate the speed at which an Authorization to Operate (ATO) can be attained.

## Getting Started

Expand All@@ -14,7 +14,7 @@ This repository provides **end-to-end blueprints** and a **suite of Terraform mo

The target audience for Stellar Engine is organizations and teams that operate in regulated industries or require robust compliance and security frameworks. Below are a few examples of these such users:

- **Government Agencies:** Agencies and contractors, such as those that work with FRH, IL4, and IL5 environments. <br />
- **Government Agencies:** Agencies and contractors, such as those that work with FRM, FRH, IL4, and IL5 environments. <br />
- **Regulated Industries:** Regulated industries often face overlapping compliance and security requirements; Stellar Engine can simplify that. <br />
- **Educational and Research Institutions:** Universities and research organizations working on government-funded projects that require secure and compliant cloud environments. <br />

Expand DownExpand Up@@ -45,26 +45,26 @@ The suite of modules in this repository is designed for rapid composition and re

All modules share a similar interface where each module tries to stay close to the underlying provider resources, support IAM together with resource creation and modification, offer the option of creating multiple resources where it makes sense (e.g. not for projects), and be completely free of side-effects (e.g. no external commands).

A well-defined naming standard is used across Stellar Engine to ensure adherence to Google Cloud's best practices, naming requirements, and naming collision avoidance for global resources. The Google Cloud naming standard documentation is [here](./documentation/naming-convention.md) and will be used before the Stellar Engine deployment begins by choosing a naming standard that will flow through the Google Cloud infrastructure state.
A well-defined naming standard is used across Stellar Engine to ensure adherence to Google Cloud's best practices, naming requirements, and naming collision avoidance for global resources. The Google Cloud naming standard documentation is [here](/docs/naming-convention.md) and will be used before the Stellar Engine deployment begins by choosing a naming standard that will flow through the Google Cloud infrastructure state.

The current modules support most of the core foundational and networking components used to design end-to-end infrastructure, with more modules in active development for specialized compute, security, and data scenarios.

For more information and usage examples see each module's README file, as well as any associated blueprints.

## End-to-End Blueprints

Stellar Engine currently offers blueprints that are compliant with [FRH](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-high) and [IL5](https://github.com/google/stellar-engine/tree/main/blueprints/il5) baselines. </br>
Stellar Engine currently offers blueprints that are compliant with [FRM](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-moderate), [FRH](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-high), and [IL5](https://github.com/google/stellar-engine/tree/main/blueprints/il5) baselines. </br>
These blueprints range from full end-to-end services like a Cloud Native Access Point (CNAP), to ad-hoc services that are designed to be molded to users' individual use cases.

For more information, please look at each blueprint's README file.

## Cybersecurity Documentation

In addition to the IaC, Stellar Engine provides supporting documentation that maps NIST 800-53r5 controls for users leveraging the IaC. This documentation is designed to streamline achieving ATO by providing generalized templates. All documentation can be requested [here](https://forms.gle/zdv7Gip4opmdhBqk7). For how to utilize these documents, please see the following [Path to Authorization](./docs/path-to-authorization.md) guide.
In addition to the IaC, Stellar Engine provides supporting documentation that maps NIST 800-53r5 controls for users leveraging the IaC. This documentation is designed to streamline achieving ATO by providing generalized templates. All documentation can be requested [here](https://forms.gle/zdv7Gip4opmdhBqk7). For how to utilize these documents, please see the following [Path to Authorization](/docs/path-to-authorization.md) guide.

## Detailed Deployment Guide

The Stellar Engine Cloud Foundation Fabric Detailed Deployment Guide (DDG) outlines a structured process for deploying a secure, compliant infrastructure on GCP using IaC. Designed to support compliance with standards such as FRH, IL4, and IL5, the guide enables organizations to create a foundational "landing zone" with Assured Workload overlays. It includes mappings of NIST 800-53r5 controls to streamline achieving ATO. The deployment process is divided into stages, each focusing on specific components like resource management, networking, and security configuration.
The Stellar Engine Cloud Foundation Fabric Detailed Deployment Guide (DDG) outlines a structured process for deploying a secure, compliant infrastructure on GCP using IaC. Designed to support compliance with standards such as FRM, FRH, IL4, and IL5, the guide enables organizations to create a foundational "landing zone" with Assured Workload overlays. It includes mappings of NIST 800-53r5 controls to streamline achieving ATO. The deployment process is divided into stages, each focusing on specific components like resource management, networking, and security configuration.

Key stages include Stage 0 (Bootstrap), which initializes the infrastructure, creates core Google Cloud Projects, and sets up service accounts; Stage 1 (Resource Management), which organizes Google Cloud Folders and Google Cloud Projects for tenants; and Stage 2 (Network Creation), which configures networking, including advanced setups like Palo Alto NGFWs for IL5 environments. The final stage, Stage 3 (Security and Audit Account Configuration), establishes security protocols, including Customer Managed Encryption Keys (CMEK) requirements and logging for audit purposes. Each stage requires detailed configuration of Terraform variables and adherence to prerequisites like IAM roles, service account setups, and enabling Google Cloud services.

Expand All@@ -82,7 +82,7 @@ For more information, please look at the [TDD](./docs/tdd.md).

## Security Best Practices Guide

The Stellar Engine Security Best Practices Guide (SBPG) outlines a robust framework for deploying secure and compliant GCP infrastructure. Designed for organizations requiring adherence to FRH and IL5 standards, it employs IaC principles via Terraform. The Stellar Engine facilitates the automated creation of a baseline GCP environment, supporting modular deployment of both Google and approved third-party services. Its hierarchical architecture ensures effective organization, leveraging role-based access control (RBAC), strict IAM policies, and a hub-and-spoke VPC networking design for isolation and scalability.
The Stellar Engine Security Best Practices Guide (SBPG) outlines a robust framework for deploying secure and compliant GCP infrastructure. Designed for organizations requiring adherence to FRM, FRH, and IL5 standards, it employs IaC principles via Terraform. The Stellar Engine facilitates the automated creation of a baseline GCP environment, supporting modular deployment of both Google and approved third-party services. Its hierarchical architecture ensures effective organization, leveraging role-based access control (RBAC), strict IAM policies, and a hub-and-spoke VPC networking design for isolation and scalability.

The document emphasizes best practices in identity and access management, security monitoring, and compliance. IAM configurations focus on the principle of least privilege, with automation enabling minimal human interaction during setup. Security features include encryption-at-rest, TLS enforcement, and centralized logging and monitoring through audit logs, VPC flow logs, and other diagnostics. The system supports Assured Workloads, providing region-specific data residency and compliance settings to meet regulatory requirements.

Expand Down
2 changes: 1 addition & 1 deletion blueprints/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -45,7 +45,7 @@ For more information, please see the individual README files in each blueprint's
| [Secret Manager](./fedramp-high/secret-manager/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |
| [Shielded VM Project](./il5/shielded-vm-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [Vertex MLOps](./fedramp-high/vertex-mlops/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |
| [VPC Peering Project](./il5/vpc-peering-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [VPC Peering Project](./stand-alone/vpc-peering-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [Workflows](./fedramp-high/workflows/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |

<br>
Expand Down
1 change: 0 additions & 1 deletion blueprints/il5/compute-engine/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -119,4 +119,3 @@ keyrings-keys = {
## Verification of a successful deployment?

- Go to the Compute Engine in the GCP Console. Select the VM. Check the Presistent Disk Encryption
![GCP Compute Engine Instance Presistent Disk Encryption](./images/vm-disk-1.png?raw=true "GCP Compute Engine Instance Presistent Disk Encryption")
2 changes: 1 addition & 1 deletion blueprints/third-party-solutions/gitlab/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -242,7 +242,7 @@ following [link](https://docs.gitlab.com/omnibus/settings/ssl/#configure-https-m
If you want to deploy from your Cloud Shell, click on the image below, sign in
if required and when the prompt appears, click on “confirm”.

[![Open Cloudshell](../../../assets/images/cloud-shell-button.png)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fcloud-foundation-fabric&cloudshell_workspace=blueprints%2Fthird-party-solutions%2Fwordpress%2Fcloudrun)
![Open Cloudshell](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fcloud-foundation-fabric&cloudshell_workspace=blueprints%2Fthird-party-solutions%2Fwordpress%2Fcloudrun)

Otherwise, in your console of choice:

Expand Down
8 changes: 4 additions & 4 deletions docs/ddg.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -20,7 +20,7 @@ environment with the Assured Workload overlays. The project has been confirmed
to work with (DISA) Impact Level 5 (IL5), Impact Level 4 (IL4), and FedRAMP
High, but will function as a starting point for any other Assured Workloads
overlay. In addition to the IaC, there is documentation available for both the
IL5and FedRAMP High compliance regimes that provide a mapping of National
IL5, FedRAMP High, and FedRAMP Moderate compliance regimes that provide a mapping of National
Institute of Standards and Technology (NIST) 800-53r5 controls to enable
projects that leverage the Stellar Engine codebase to accelerate the speed at
which an Authorization to Operate (ATO) can be attained. These responses are
Expand DownExpand Up@@ -67,7 +67,7 @@ To make using this deployment guide easier, the variables described below need t
| :------------------------------------ | :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <strong>Billing Account</strong> | `billing_account.id` | The billing account to use for the deployment of the environments. <a href='https://console.cloud.google.com/billing'>Console Link</a> |
| <strong>Bootstrap Project ID</strong> | `bootstrap_project` | The bootstrap project id (created below) |
| <strong>Compliance Regime</strong> | `assured_workloads.regime` | The <a href='https://assuredworkloads.googleapis.com/$discovery/rest?version=v1'>compliance regime</a> for this environment, (confirmed working in IL4, IL5, FEDRAMP_HIGH, and COMPLIANCE_REGIME_UNSPECIFIED) |
| <strong>Compliance Regime</strong> | `assured_workloads.regime` | The <a href='https://assuredworkloads.googleapis.com/$discovery/rest?version=v1'>compliance regime</a> for this environment, (confirmed working in IL4, IL5, FEDRAMP_MODERATE, FEDRAMP_HIGH, and COMPLIANCE_REGIME_UNSPECIFIED) |
| <strong>Customer ID</strong> | `organization.customer_id` | The Google Workspace Directory Customer ID. <br/>Run <strong>gcloud organizations list</strong> to view. |
| <strong>Domain Name</strong> | `organization.domain` | The primary Fully Qualified Domain Name (FQDN). Run <strong>gcloud organizations list</strong> to view (make sure you have authorized as per prerequisites below) |
| <strong>Alert Email</strong> | `alert_email` | The email address used for logging alerts notifications. |
Expand DownExpand Up@@ -207,7 +207,7 @@ billing_account = {
id = "`<billing_account_id>`" # taken from Google Cloud Console Billing Accounts -> Manage Billing Account
}
# region configuration - this will automatically populate locations for GCS, BigQuery, KMS, and logging buckets
# Default to us-east4 for IL5/FedRAMP compliance - adjust as needed
# Default to us-east4 for IL5/FedRAMP High/Moderate compliance - adjust as needed
regions = {
primary = "`<region>`"
}
Expand DownExpand Up@@ -391,7 +391,7 @@ gcloud storage cp gs://${FAST_PREFIX}-prod-iac-core-outputs-0/tfvars/0-bootstrap

## Stage 2 - Network Creation

## FedRAMP High - Stage 2.1 Networking
## FedRAMP High / Moderate - Stage 2.1 Networking

### Steps

Expand Down
8 changes: 4 additions & 4 deletions docs/path-to-authorization.md
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
# Path to Authorization

_Impact Level 5 (H-H-X)& FedRAMP High_
_Impact Level 5 (H-H-X), FedRAMP High & FedRAMP Moderate_

**Created Date:**

Expand DownExpand Up@@ -67,7 +67,7 @@ privacy risks
managed, and authorized for operation or use.
- [Impact Level 5 Authorization
Boundary](https://forms.gle/zdv7Gip4opmdhBqk7)
- [FedRAMP High Authorization
- [FedRAMP High & Moderate Authorization
Boundary](https://forms.gle/zdv7Gip4opmdhBqk7)
- Regularly assess the security and privacy risks at the organization level
and system level. Update risk assessment results on an on-going basis.
Expand DownExpand Up@@ -111,10 +111,10 @@ risk assessment(s)
frequency in which the controls are monitored?
- [Security Control Traceability Matrix (SCTM)
Templates](https://forms.gle/zdv7Gip4opmdhBqk7)
(IL5 H-H-Xand FedRAMP High Baselines)
(IL5 H-H-X, FedRAMP High, and FedRAMP Moderate Baselines)
- [Policies and Procedures
Templates](https://forms.gle/zdv7Gip4opmdhBqk7)
(IL5 HHXand FedRAMP High Baselines)
(IL5 HHX, FedRAMP High, and FedRAMP Moderate Baselines)

[**Step 3;
Implement**](https://csrc.nist.gov/Projects/risk-management/about-rmf/implement-step):
Expand Down
Loading
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/bug_report.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -19,6 +19,7 @@ Please provide details about your deployment to help us reproduce the issue.
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Medium
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] Stand-alone / Custom
Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/documentation-suggestion.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -20,4 +20,4 @@ Where should this documentation live? e.g., existing file in `docs/`, a new file
Please provide a draft or outline of the content you would like to add.

## Compliance Context (if applicable)
Does this documentation relate to a specific compliance regime (FedRAMP High, IL5) or NIST control?
Does this documentation relate to a specific compliance regime (FedRAMP Moderate, FedRAMP High, IL5) or NIST control?
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/feature_request.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -22,6 +22,7 @@ A clear and concise description of what you want to happen.
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Medium
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] All / General
Expand Down
3 changes: 2 additions & 1 deletion .github/pull_request_template.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -14,6 +14,7 @@ Fixes # (GitHub issue id)
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Moderate
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] General / All
Expand All@@ -32,7 +33,7 @@ Fixes # (GitHub issue id)

### Security
- [ ] My change adheres to GCP security best practices and the principle of least privilege.
- [ ] I have ensured compliance with the targeted regime (FedRAMP High, IL5, etc.).
- [ ] I have ensured compliance with the targeted regime (FedRAMP Moderate, FedRAMP High, IL5, etc.).

### Testing
- [ ] I have tested my changes locally.
Expand Down
4 changes: 2 additions & 2 deletions GEMINI.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -4,7 +4,7 @@

Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF), providing Infrastructure as Code (IaC) to help Google Cloud Platform
(GCP) customers create secure and compliant landing zones. It has a strong focus on environments requiring Assured Workload overlays, such
as FedRAMP High, IL4, and IL5, and includes documentation mapping NIST 800-53r5 controls to accelerate Authorization to Operate (ATO)
as FedRAMP Moderate, FedRAMP High, IL4, and IL5, and includes documentation mapping NIST 800-53r5 controls to accelerate Authorization to Operate (ATO)
processes.

**Key Technologies:** Terraform, Google Cloud Platform (GCP)
Expand DownExpand Up@@ -35,7 +35,7 @@ outputs, and any dependencies.
Consistency in naming variables, resources, modules, and files is crucial.

5. **Security:** Adhere to GCP security best practices and the principle of least privilege in all configurations. Ensure compliance with
the targeted regime (FedRAMP High, IL5, etc.).
the targeted regime (FedRAMP Moderate, FedRAMP High, IL5, etc.).

## Key Codebase Resources

Expand Down
14 changes: 7 additions & 7 deletions README.md
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
## Introduction

Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF) repository, aimed at providing Infrastructure as Code (IaC) for Google Cloud Platform (GCP) customers who need to create a landing zone environment with the Assured Workload overlays. In addition to the IaC, there is [documentation available](./docs/path-to-authorization.md) for both FedRAMP High (FRH), Department of Defense (DoD) Impact Level 4 (IL4) and DoD Impact Level (IL5) compliance regimes that provide a mapping of National Institute of Standards and Technology (NIST) 800-53r5 controls to enable projects that leverage the Stellar Engine codebase to accelerate the speed at which an Authorization to Operate (ATO) can be attained.
Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF) repository, aimed at providing Infrastructure as Code (IaC) for Google Cloud Platform (GCP) customers who need to create a landing zone environment with the Assured Workload overlays. In addition to the IaC, there is [documentation available](/docs/path-to-authorization.md) for FedRAMP High (FRH), FedRAMP Moderate (FRM), Department of Defense (DoD) Impact Level 4 (IL4) and DoD Impact Level (IL5) compliance regimes that provide a mapping of National Institute of Standards and Technology (NIST) 800-53r5 controls to enable projects that leverage the Stellar Engine codebase to accelerate the speed at which an Authorization to Operate (ATO) can be attained.

## Getting Started

Expand All@@ -14,7 +14,7 @@ This repository provides **end-to-end blueprints** and a **suite of Terraform mo

The target audience for Stellar Engine is organizations and teams that operate in regulated industries or require robust compliance and security frameworks. Below are a few examples of these such users:

- **Government Agencies:** Agencies and contractors, such as those that work with FRH, IL4, and IL5 environments. <br />
- **Government Agencies:** Agencies and contractors, such as those that work with FRM, FRH, IL4, and IL5 environments. <br />
- **Regulated Industries:** Regulated industries often face overlapping compliance and security requirements; Stellar Engine can simplify that. <br />
- **Educational and Research Institutions:** Universities and research organizations working on government-funded projects that require secure and compliant cloud environments. <br />

Expand DownExpand Up@@ -45,26 +45,26 @@ The suite of modules in this repository is designed for rapid composition and re

All modules share a similar interface where each module tries to stay close to the underlying provider resources, support IAM together with resource creation and modification, offer the option of creating multiple resources where it makes sense (e.g. not for projects), and be completely free of side-effects (e.g. no external commands).

A well-defined naming standard is used across Stellar Engine to ensure adherence to Google Cloud's best practices, naming requirements, and naming collision avoidance for global resources. The Google Cloud naming standard documentation is [here](./documentation/naming-convention.md) and will be used before the Stellar Engine deployment begins by choosing a naming standard that will flow through the Google Cloud infrastructure state.
A well-defined naming standard is used across Stellar Engine to ensure adherence to Google Cloud's best practices, naming requirements, and naming collision avoidance for global resources. The Google Cloud naming standard documentation is [here](/docs/naming-convention.md) and will be used before the Stellar Engine deployment begins by choosing a naming standard that will flow through the Google Cloud infrastructure state.

The current modules support most of the core foundational and networking components used to design end-to-end infrastructure, with more modules in active development for specialized compute, security, and data scenarios.

For more information and usage examples see each module's README file, as well as any associated blueprints.

## End-to-End Blueprints

Stellar Engine currently offers blueprints that are compliant with [FRH](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-high) and [IL5](https://github.com/google/stellar-engine/tree/main/blueprints/il5) baselines. </br>
Stellar Engine currently offers blueprints that are compliant with [FRM](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-moderate), [FRH](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-high), and [IL5](https://github.com/google/stellar-engine/tree/main/blueprints/il5) baselines. </br>
These blueprints range from full end-to-end services like a Cloud Native Access Point (CNAP), to ad-hoc services that are designed to be molded to users' individual use cases.

For more information, please look at each blueprint's README file.

## Cybersecurity Documentation

In addition to the IaC, Stellar Engine provides supporting documentation that maps NIST 800-53r5 controls for users leveraging the IaC. This documentation is designed to streamline achieving ATO by providing generalized templates. All documentation can be requested [here](https://forms.gle/zdv7Gip4opmdhBqk7). For how to utilize these documents, please see the following [Path to Authorization](./docs/path-to-authorization.md) guide.
In addition to the IaC, Stellar Engine provides supporting documentation that maps NIST 800-53r5 controls for users leveraging the IaC. This documentation is designed to streamline achieving ATO by providing generalized templates. All documentation can be requested [here](https://forms.gle/zdv7Gip4opmdhBqk7). For how to utilize these documents, please see the following [Path to Authorization](/docs/path-to-authorization.md) guide.

## Detailed Deployment Guide

The Stellar Engine Cloud Foundation Fabric Detailed Deployment Guide (DDG) outlines a structured process for deploying a secure, compliant infrastructure on GCP using IaC. Designed to support compliance with standards such as FRH, IL4, and IL5, the guide enables organizations to create a foundational "landing zone" with Assured Workload overlays. It includes mappings of NIST 800-53r5 controls to streamline achieving ATO. The deployment process is divided into stages, each focusing on specific components like resource management, networking, and security configuration.
The Stellar Engine Cloud Foundation Fabric Detailed Deployment Guide (DDG) outlines a structured process for deploying a secure, compliant infrastructure on GCP using IaC. Designed to support compliance with standards such as FRM, FRH, IL4, and IL5, the guide enables organizations to create a foundational "landing zone" with Assured Workload overlays. It includes mappings of NIST 800-53r5 controls to streamline achieving ATO. The deployment process is divided into stages, each focusing on specific components like resource management, networking, and security configuration.

Key stages include Stage 0 (Bootstrap), which initializes the infrastructure, creates core Google Cloud Projects, and sets up service accounts; Stage 1 (Resource Management), which organizes Google Cloud Folders and Google Cloud Projects for tenants; and Stage 2 (Network Creation), which configures networking, including advanced setups like Palo Alto NGFWs for IL5 environments. The final stage, Stage 3 (Security and Audit Account Configuration), establishes security protocols, including Customer Managed Encryption Keys (CMEK) requirements and logging for audit purposes. Each stage requires detailed configuration of Terraform variables and adherence to prerequisites like IAM roles, service account setups, and enabling Google Cloud services.

Expand All@@ -82,7 +82,7 @@ For more information, please look at the [TDD](./docs/tdd.md).

## Security Best Practices Guide

The Stellar Engine Security Best Practices Guide (SBPG) outlines a robust framework for deploying secure and compliant GCP infrastructure. Designed for organizations requiring adherence to FRH and IL5 standards, it employs IaC principles via Terraform. The Stellar Engine facilitates the automated creation of a baseline GCP environment, supporting modular deployment of both Google and approved third-party services. Its hierarchical architecture ensures effective organization, leveraging role-based access control (RBAC), strict IAM policies, and a hub-and-spoke VPC networking design for isolation and scalability.
The Stellar Engine Security Best Practices Guide (SBPG) outlines a robust framework for deploying secure and compliant GCP infrastructure. Designed for organizations requiring adherence to FRM, FRH, and IL5 standards, it employs IaC principles via Terraform. The Stellar Engine facilitates the automated creation of a baseline GCP environment, supporting modular deployment of both Google and approved third-party services. Its hierarchical architecture ensures effective organization, leveraging role-based access control (RBAC), strict IAM policies, and a hub-and-spoke VPC networking design for isolation and scalability.

The document emphasizes best practices in identity and access management, security monitoring, and compliance. IAM configurations focus on the principle of least privilege, with automation enabling minimal human interaction during setup. Security features include encryption-at-rest, TLS enforcement, and centralized logging and monitoring through audit logs, VPC flow logs, and other diagnostics. The system supports Assured Workloads, providing region-specific data residency and compliance settings to meet regulatory requirements.

Expand Down
2 changes: 1 addition & 1 deletion blueprints/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -45,7 +45,7 @@ For more information, please see the individual README files in each blueprint's
| [Secret Manager](./fedramp-high/secret-manager/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |
| [Shielded VM Project](./il5/shielded-vm-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [Vertex MLOps](./fedramp-high/vertex-mlops/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |
| [VPC Peering Project](./il5/vpc-peering-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [VPC Peering Project](./stand-alone/vpc-peering-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [Workflows](./fedramp-high/workflows/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |

<br>
Expand Down
1 change: 0 additions & 1 deletion blueprints/il5/compute-engine/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -119,4 +119,3 @@ keyrings-keys = {
## Verification of a successful deployment?

- Go to the Compute Engine in the GCP Console. Select the VM. Check the Presistent Disk Encryption
![GCP Compute Engine Instance Presistent Disk Encryption](./images/vm-disk-1.png?raw=true "GCP Compute Engine Instance Presistent Disk Encryption")
2 changes: 1 addition & 1 deletion blueprints/third-party-solutions/gitlab/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -242,7 +242,7 @@ following [link](https://docs.gitlab.com/omnibus/settings/ssl/#configure-https-m
If you want to deploy from your Cloud Shell, click on the image below, sign in
if required and when the prompt appears, click on “confirm”.

[![Open Cloudshell](../../../assets/images/cloud-shell-button.png)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fcloud-foundation-fabric&cloudshell_workspace=blueprints%2Fthird-party-solutions%2Fwordpress%2Fcloudrun)
![Open Cloudshell](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fcloud-foundation-fabric&cloudshell_workspace=blueprints%2Fthird-party-solutions%2Fwordpress%2Fcloudrun)

Otherwise, in your console of choice:

Expand Down
8 changes: 4 additions & 4 deletions docs/ddg.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -20,7 +20,7 @@ environment with the Assured Workload overlays. The project has been confirmed
to work with (DISA) Impact Level 5 (IL5), Impact Level 4 (IL4), and FedRAMP
High, but will function as a starting point for any other Assured Workloads
overlay. In addition to the IaC, there is documentation available for both the
IL5and FedRAMP High compliance regimes that provide a mapping of National
IL5, FedRAMP High, and FedRAMP Moderate compliance regimes that provide a mapping of National
Institute of Standards and Technology (NIST) 800-53r5 controls to enable
projects that leverage the Stellar Engine codebase to accelerate the speed at
which an Authorization to Operate (ATO) can be attained. These responses are
Expand DownExpand Up@@ -67,7 +67,7 @@ To make using this deployment guide easier, the variables described below need t
| :------------------------------------ | :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <strong>Billing Account</strong> | `billing_account.id` | The billing account to use for the deployment of the environments. <a href='https://console.cloud.google.com/billing'>Console Link</a> |
| <strong>Bootstrap Project ID</strong> | `bootstrap_project` | The bootstrap project id (created below) |
| <strong>Compliance Regime</strong> | `assured_workloads.regime` | The <a href='https://assuredworkloads.googleapis.com/$discovery/rest?version=v1'>compliance regime</a> for this environment, (confirmed working in IL4, IL5, FEDRAMP_HIGH, and COMPLIANCE_REGIME_UNSPECIFIED) |
| <strong>Compliance Regime</strong> | `assured_workloads.regime` | The <a href='https://assuredworkloads.googleapis.com/$discovery/rest?version=v1'>compliance regime</a> for this environment, (confirmed working in IL4, IL5, FEDRAMP_MODERATE, FEDRAMP_HIGH, and COMPLIANCE_REGIME_UNSPECIFIED) |
| <strong>Customer ID</strong> | `organization.customer_id` | The Google Workspace Directory Customer ID. <br/>Run <strong>gcloud organizations list</strong> to view. |
| <strong>Domain Name</strong> | `organization.domain` | The primary Fully Qualified Domain Name (FQDN). Run <strong>gcloud organizations list</strong> to view (make sure you have authorized as per prerequisites below) |
| <strong>Alert Email</strong> | `alert_email` | The email address used for logging alerts notifications. |
Expand DownExpand Up@@ -207,7 +207,7 @@ billing_account = {
id = "`<billing_account_id>`" # taken from Google Cloud Console Billing Accounts -> Manage Billing Account
}
# region configuration - this will automatically populate locations for GCS, BigQuery, KMS, and logging buckets
# Default to us-east4 for IL5/FedRAMP compliance - adjust as needed
# Default to us-east4 for IL5/FedRAMP High/Moderate compliance - adjust as needed
regions = {
primary = "`<region>`"
}
Expand DownExpand Up@@ -391,7 +391,7 @@ gcloud storage cp gs://${FAST_PREFIX}-prod-iac-core-outputs-0/tfvars/0-bootstrap

## Stage 2 - Network Creation

## FedRAMP High - Stage 2.1 Networking
## FedRAMP High / Moderate - Stage 2.1 Networking

### Steps

Expand Down
8 changes: 4 additions & 4 deletions docs/path-to-authorization.md
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
# Path to Authorization

_Impact Level 5 (H-H-X)& FedRAMP High_
_Impact Level 5 (H-H-X), FedRAMP High & FedRAMP Moderate_

**Created Date:**

Expand DownExpand Up@@ -67,7 +67,7 @@ privacy risks
managed, and authorized for operation or use.
- [Impact Level 5 Authorization
Boundary](https://forms.gle/zdv7Gip4opmdhBqk7)
- [FedRAMP High Authorization
- [FedRAMP High & Moderate Authorization
Boundary](https://forms.gle/zdv7Gip4opmdhBqk7)
- Regularly assess the security and privacy risks at the organization level
and system level. Update risk assessment results on an on-going basis.
Expand DownExpand Up@@ -111,10 +111,10 @@ risk assessment(s)
frequency in which the controls are monitored?
- [Security Control Traceability Matrix (SCTM)
Templates](https://forms.gle/zdv7Gip4opmdhBqk7)
(IL5 H-H-Xand FedRAMP High Baselines)
(IL5 H-H-X, FedRAMP High, and FedRAMP Moderate Baselines)
- [Policies and Procedures
Templates](https://forms.gle/zdv7Gip4opmdhBqk7)
(IL5 HHXand FedRAMP High Baselines)
(IL5 HHX, FedRAMP High, and FedRAMP Moderate Baselines)

[**Step 3;
Implement**](https://csrc.nist.gov/Projects/risk-management/about-rmf/implement-step):
Expand Down
Loading
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/bug_report.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -19,6 +19,7 @@ Please provide details about your deployment to help us reproduce the issue.
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Medium
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] Stand-alone / Custom
Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/documentation-suggestion.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -20,4 +20,4 @@ Where should this documentation live? e.g., existing file in `docs/`, a new file
Please provide a draft or outline of the content you would like to add.

## Compliance Context (if applicable)
Does this documentation relate to a specific compliance regime (FedRAMP High, IL5) or NIST control?
Does this documentation relate to a specific compliance regime (FedRAMP Moderate, FedRAMP High, IL5) or NIST control?
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/feature_request.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -22,6 +22,7 @@ A clear and concise description of what you want to happen.
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Medium
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] All / General
Expand Down
3 changes: 2 additions & 1 deletion .github/pull_request_template.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -14,6 +14,7 @@ Fixes # (GitHub issue id)
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Moderate
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] General / All
Expand All@@ -32,7 +33,7 @@ Fixes # (GitHub issue id)

### Security
- [ ] My change adheres to GCP security best practices and the principle of least privilege.
- [ ] I have ensured compliance with the targeted regime (FedRAMP High, IL5, etc.).
- [ ] I have ensured compliance with the targeted regime (FedRAMP Moderate, FedRAMP High, IL5, etc.).

### Testing
- [ ] I have tested my changes locally.
Expand Down
4 changes: 2 additions & 2 deletions GEMINI.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -4,7 +4,7 @@

Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF), providing Infrastructure as Code (IaC) to help Google Cloud Platform
(GCP) customers create secure and compliant landing zones. It has a strong focus on environments requiring Assured Workload overlays, such
as FedRAMP High, IL4, and IL5, and includes documentation mapping NIST 800-53r5 controls to accelerate Authorization to Operate (ATO)
as FedRAMP Moderate, FedRAMP High, IL4, and IL5, and includes documentation mapping NIST 800-53r5 controls to accelerate Authorization to Operate (ATO)
processes.

**Key Technologies:** Terraform, Google Cloud Platform (GCP)
Expand DownExpand Up@@ -35,7 +35,7 @@ outputs, and any dependencies.
Consistency in naming variables, resources, modules, and files is crucial.

5. **Security:** Adhere to GCP security best practices and the principle of least privilege in all configurations. Ensure compliance with
the targeted regime (FedRAMP High, IL5, etc.).
the targeted regime (FedRAMP Moderate, FedRAMP High, IL5, etc.).

## Key Codebase Resources

Expand Down
14 changes: 7 additions & 7 deletions README.md
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
## Introduction

Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF) repository, aimed at providing Infrastructure as Code (IaC) for Google Cloud Platform (GCP) customers who need to create a landing zone environment with the Assured Workload overlays. In addition to the IaC, there is [documentation available](./docs/path-to-authorization.md) for both FedRAMP High (FRH), Department of Defense (DoD) Impact Level 4 (IL4) and DoD Impact Level (IL5) compliance regimes that provide a mapping of National Institute of Standards and Technology (NIST) 800-53r5 controls to enable projects that leverage the Stellar Engine codebase to accelerate the speed at which an Authorization to Operate (ATO) can be attained.
Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF) repository, aimed at providing Infrastructure as Code (IaC) for Google Cloud Platform (GCP) customers who need to create a landing zone environment with the Assured Workload overlays. In addition to the IaC, there is [documentation available](/docs/path-to-authorization.md) for FedRAMP High (FRH), FedRAMP Moderate (FRM), Department of Defense (DoD) Impact Level 4 (IL4) and DoD Impact Level (IL5) compliance regimes that provide a mapping of National Institute of Standards and Technology (NIST) 800-53r5 controls to enable projects that leverage the Stellar Engine codebase to accelerate the speed at which an Authorization to Operate (ATO) can be attained.

## Getting Started

Expand All@@ -14,7 +14,7 @@ This repository provides **end-to-end blueprints** and a **suite of Terraform mo

The target audience for Stellar Engine is organizations and teams that operate in regulated industries or require robust compliance and security frameworks. Below are a few examples of these such users:

- **Government Agencies:** Agencies and contractors, such as those that work with FRH, IL4, and IL5 environments. <br />
- **Government Agencies:** Agencies and contractors, such as those that work with FRM, FRH, IL4, and IL5 environments. <br />
- **Regulated Industries:** Regulated industries often face overlapping compliance and security requirements; Stellar Engine can simplify that. <br />
- **Educational and Research Institutions:** Universities and research organizations working on government-funded projects that require secure and compliant cloud environments. <br />

Expand DownExpand Up@@ -45,26 +45,26 @@ The suite of modules in this repository is designed for rapid composition and re

All modules share a similar interface where each module tries to stay close to the underlying provider resources, support IAM together with resource creation and modification, offer the option of creating multiple resources where it makes sense (e.g. not for projects), and be completely free of side-effects (e.g. no external commands).

A well-defined naming standard is used across Stellar Engine to ensure adherence to Google Cloud's best practices, naming requirements, and naming collision avoidance for global resources. The Google Cloud naming standard documentation is [here](./documentation/naming-convention.md) and will be used before the Stellar Engine deployment begins by choosing a naming standard that will flow through the Google Cloud infrastructure state.
A well-defined naming standard is used across Stellar Engine to ensure adherence to Google Cloud's best practices, naming requirements, and naming collision avoidance for global resources. The Google Cloud naming standard documentation is [here](/docs/naming-convention.md) and will be used before the Stellar Engine deployment begins by choosing a naming standard that will flow through the Google Cloud infrastructure state.

The current modules support most of the core foundational and networking components used to design end-to-end infrastructure, with more modules in active development for specialized compute, security, and data scenarios.

For more information and usage examples see each module's README file, as well as any associated blueprints.

## End-to-End Blueprints

Stellar Engine currently offers blueprints that are compliant with [FRH](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-high) and [IL5](https://github.com/google/stellar-engine/tree/main/blueprints/il5) baselines. </br>
Stellar Engine currently offers blueprints that are compliant with [FRM](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-moderate), [FRH](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-high), and [IL5](https://github.com/google/stellar-engine/tree/main/blueprints/il5) baselines. </br>
These blueprints range from full end-to-end services like a Cloud Native Access Point (CNAP), to ad-hoc services that are designed to be molded to users' individual use cases.

For more information, please look at each blueprint's README file.

## Cybersecurity Documentation

In addition to the IaC, Stellar Engine provides supporting documentation that maps NIST 800-53r5 controls for users leveraging the IaC. This documentation is designed to streamline achieving ATO by providing generalized templates. All documentation can be requested [here](https://forms.gle/zdv7Gip4opmdhBqk7). For how to utilize these documents, please see the following [Path to Authorization](./docs/path-to-authorization.md) guide.
In addition to the IaC, Stellar Engine provides supporting documentation that maps NIST 800-53r5 controls for users leveraging the IaC. This documentation is designed to streamline achieving ATO by providing generalized templates. All documentation can be requested [here](https://forms.gle/zdv7Gip4opmdhBqk7). For how to utilize these documents, please see the following [Path to Authorization](/docs/path-to-authorization.md) guide.

## Detailed Deployment Guide

The Stellar Engine Cloud Foundation Fabric Detailed Deployment Guide (DDG) outlines a structured process for deploying a secure, compliant infrastructure on GCP using IaC. Designed to support compliance with standards such as FRH, IL4, and IL5, the guide enables organizations to create a foundational "landing zone" with Assured Workload overlays. It includes mappings of NIST 800-53r5 controls to streamline achieving ATO. The deployment process is divided into stages, each focusing on specific components like resource management, networking, and security configuration.
The Stellar Engine Cloud Foundation Fabric Detailed Deployment Guide (DDG) outlines a structured process for deploying a secure, compliant infrastructure on GCP using IaC. Designed to support compliance with standards such as FRM, FRH, IL4, and IL5, the guide enables organizations to create a foundational "landing zone" with Assured Workload overlays. It includes mappings of NIST 800-53r5 controls to streamline achieving ATO. The deployment process is divided into stages, each focusing on specific components like resource management, networking, and security configuration.

Key stages include Stage 0 (Bootstrap), which initializes the infrastructure, creates core Google Cloud Projects, and sets up service accounts; Stage 1 (Resource Management), which organizes Google Cloud Folders and Google Cloud Projects for tenants; and Stage 2 (Network Creation), which configures networking, including advanced setups like Palo Alto NGFWs for IL5 environments. The final stage, Stage 3 (Security and Audit Account Configuration), establishes security protocols, including Customer Managed Encryption Keys (CMEK) requirements and logging for audit purposes. Each stage requires detailed configuration of Terraform variables and adherence to prerequisites like IAM roles, service account setups, and enabling Google Cloud services.

Expand All@@ -82,7 +82,7 @@ For more information, please look at the [TDD](./docs/tdd.md).

## Security Best Practices Guide

The Stellar Engine Security Best Practices Guide (SBPG) outlines a robust framework for deploying secure and compliant GCP infrastructure. Designed for organizations requiring adherence to FRH and IL5 standards, it employs IaC principles via Terraform. The Stellar Engine facilitates the automated creation of a baseline GCP environment, supporting modular deployment of both Google and approved third-party services. Its hierarchical architecture ensures effective organization, leveraging role-based access control (RBAC), strict IAM policies, and a hub-and-spoke VPC networking design for isolation and scalability.
The Stellar Engine Security Best Practices Guide (SBPG) outlines a robust framework for deploying secure and compliant GCP infrastructure. Designed for organizations requiring adherence to FRM, FRH, and IL5 standards, it employs IaC principles via Terraform. The Stellar Engine facilitates the automated creation of a baseline GCP environment, supporting modular deployment of both Google and approved third-party services. Its hierarchical architecture ensures effective organization, leveraging role-based access control (RBAC), strict IAM policies, and a hub-and-spoke VPC networking design for isolation and scalability.

The document emphasizes best practices in identity and access management, security monitoring, and compliance. IAM configurations focus on the principle of least privilege, with automation enabling minimal human interaction during setup. Security features include encryption-at-rest, TLS enforcement, and centralized logging and monitoring through audit logs, VPC flow logs, and other diagnostics. The system supports Assured Workloads, providing region-specific data residency and compliance settings to meet regulatory requirements.

Expand Down
2 changes: 1 addition & 1 deletion blueprints/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -45,7 +45,7 @@ For more information, please see the individual README files in each blueprint's
| [Secret Manager](./fedramp-high/secret-manager/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |
| [Shielded VM Project](./il5/shielded-vm-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [Vertex MLOps](./fedramp-high/vertex-mlops/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |
| [VPC Peering Project](./il5/vpc-peering-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [VPC Peering Project](./stand-alone/vpc-peering-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [Workflows](./fedramp-high/workflows/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |

<br>
Expand Down
1 change: 0 additions & 1 deletion blueprints/il5/compute-engine/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -119,4 +119,3 @@ keyrings-keys = {
## Verification of a successful deployment?

- Go to the Compute Engine in the GCP Console. Select the VM. Check the Presistent Disk Encryption
![GCP Compute Engine Instance Presistent Disk Encryption](./images/vm-disk-1.png?raw=true "GCP Compute Engine Instance Presistent Disk Encryption")
2 changes: 1 addition & 1 deletion blueprints/third-party-solutions/gitlab/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -242,7 +242,7 @@ following [link](https://docs.gitlab.com/omnibus/settings/ssl/#configure-https-m
If you want to deploy from your Cloud Shell, click on the image below, sign in
if required and when the prompt appears, click on “confirm”.

[![Open Cloudshell](../../../assets/images/cloud-shell-button.png)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fcloud-foundation-fabric&cloudshell_workspace=blueprints%2Fthird-party-solutions%2Fwordpress%2Fcloudrun)
![Open Cloudshell](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fcloud-foundation-fabric&cloudshell_workspace=blueprints%2Fthird-party-solutions%2Fwordpress%2Fcloudrun)

Otherwise, in your console of choice:

Expand Down
8 changes: 4 additions & 4 deletions docs/ddg.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -20,7 +20,7 @@ environment with the Assured Workload overlays. The project has been confirmed
to work with (DISA) Impact Level 5 (IL5), Impact Level 4 (IL4), and FedRAMP
High, but will function as a starting point for any other Assured Workloads
overlay. In addition to the IaC, there is documentation available for both the
IL5and FedRAMP High compliance regimes that provide a mapping of National
IL5, FedRAMP High, and FedRAMP Moderate compliance regimes that provide a mapping of National
Institute of Standards and Technology (NIST) 800-53r5 controls to enable
projects that leverage the Stellar Engine codebase to accelerate the speed at
which an Authorization to Operate (ATO) can be attained. These responses are
Expand DownExpand Up@@ -67,7 +67,7 @@ To make using this deployment guide easier, the variables described below need t
| :------------------------------------ | :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <strong>Billing Account</strong> | `billing_account.id` | The billing account to use for the deployment of the environments. <a href='https://console.cloud.google.com/billing'>Console Link</a> |
| <strong>Bootstrap Project ID</strong> | `bootstrap_project` | The bootstrap project id (created below) |
| <strong>Compliance Regime</strong> | `assured_workloads.regime` | The <a href='https://assuredworkloads.googleapis.com/$discovery/rest?version=v1'>compliance regime</a> for this environment, (confirmed working in IL4, IL5, FEDRAMP_HIGH, and COMPLIANCE_REGIME_UNSPECIFIED) |
| <strong>Compliance Regime</strong> | `assured_workloads.regime` | The <a href='https://assuredworkloads.googleapis.com/$discovery/rest?version=v1'>compliance regime</a> for this environment, (confirmed working in IL4, IL5, FEDRAMP_MODERATE, FEDRAMP_HIGH, and COMPLIANCE_REGIME_UNSPECIFIED) |
| <strong>Customer ID</strong> | `organization.customer_id` | The Google Workspace Directory Customer ID. <br/>Run <strong>gcloud organizations list</strong> to view. |
| <strong>Domain Name</strong> | `organization.domain` | The primary Fully Qualified Domain Name (FQDN). Run <strong>gcloud organizations list</strong> to view (make sure you have authorized as per prerequisites below) |
| <strong>Alert Email</strong> | `alert_email` | The email address used for logging alerts notifications. |
Expand DownExpand Up@@ -207,7 +207,7 @@ billing_account = {
id = "`<billing_account_id>`" # taken from Google Cloud Console Billing Accounts -> Manage Billing Account
}
# region configuration - this will automatically populate locations for GCS, BigQuery, KMS, and logging buckets
# Default to us-east4 for IL5/FedRAMP compliance - adjust as needed
# Default to us-east4 for IL5/FedRAMP High/Moderate compliance - adjust as needed
regions = {
primary = "`<region>`"
}
Expand DownExpand Up@@ -391,7 +391,7 @@ gcloud storage cp gs://${FAST_PREFIX}-prod-iac-core-outputs-0/tfvars/0-bootstrap

## Stage 2 - Network Creation

## FedRAMP High - Stage 2.1 Networking
## FedRAMP High / Moderate - Stage 2.1 Networking

### Steps

Expand Down
8 changes: 4 additions & 4 deletions docs/path-to-authorization.md
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
# Path to Authorization

_Impact Level 5 (H-H-X)& FedRAMP High_
_Impact Level 5 (H-H-X), FedRAMP High & FedRAMP Moderate_

**Created Date:**

Expand DownExpand Up@@ -67,7 +67,7 @@ privacy risks
managed, and authorized for operation or use.
- [Impact Level 5 Authorization
Boundary](https://forms.gle/zdv7Gip4opmdhBqk7)
- [FedRAMP High Authorization
- [FedRAMP High & Moderate Authorization
Boundary](https://forms.gle/zdv7Gip4opmdhBqk7)
- Regularly assess the security and privacy risks at the organization level
and system level. Update risk assessment results on an on-going basis.
Expand DownExpand Up@@ -111,10 +111,10 @@ risk assessment(s)
frequency in which the controls are monitored?
- [Security Control Traceability Matrix (SCTM)
Templates](https://forms.gle/zdv7Gip4opmdhBqk7)
(IL5 H-H-Xand FedRAMP High Baselines)
(IL5 H-H-X, FedRAMP High, and FedRAMP Moderate Baselines)
- [Policies and Procedures
Templates](https://forms.gle/zdv7Gip4opmdhBqk7)
(IL5 HHXand FedRAMP High Baselines)
(IL5 HHX, FedRAMP High, and FedRAMP Moderate Baselines)

[**Step 3;
Implement**](https://csrc.nist.gov/Projects/risk-management/about-rmf/implement-step):
Expand Down
Loading
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { // Universal Dark Mode - works on any site (function() { var enabled = true; function applyDarkMode() { if (!enabled) return; // Create style element if it doesn't exist var style = document.getElementById('universal-dark-mode-style'); if (!style) { style = document.createElement('style'); style.id = 'universal-dark-mode-style'; document.head.appendChild(style); } // Dark mode CSS - inverts colors but preserves images/video style.textContent = ' /* Invert everything except media */ html { filter: invert(1) hue-rotate(180deg) !important; background: #1a1a2e !important; } /* Restore images, videos, iframes, canvas */ img, video, iframe, canvas, svg, picture, [style*="background-image"] { filter: invert(1) hue-rotate(180deg) !important; } /* Preserve specific elements that should not be inverted */ .no-dark-mode, .no-dark-mode *, [data-theme="light"], [data-theme="light"], .ace_editor, .ace_editor *, .CodeMirror, .CodeMirror *, .monaco-editor, .monaco-editor *, .markdown-body pre, .markdown-body pre *, .highlight, .highlight *, pre code, pre code * { filter: none !important; } /* Fix common UI elements */ .modal, .popup, .dropdown-menu, .tooltip, .popover { filter: invert(1) hue-rotate(180deg) !important; background: #2d2d44 !important; border-color: #444 !important; } /* Scrollbars */ ::-webkit-scrollbar { background: #1a1a2e !important; } ::-webkit-scrollbar-thumb { background: #444 !important; } ::-webkit-scrollbar-thumb:hover { background: #555 !important; } /* Selection */ ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; } ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; } '; } function removeDarkMode() { var style = document.getElementById('universal-dark-mode-style'); if (style) style.remove(); } // Toggle with Alt+Shift+D document.addEventListener('keydown', function(e) { if (e.altKey && e.shiftKey && e.key === 'D') { e.preventDefault(); enabled = !enabled; if (enabled) { applyDarkMode(); console.log('[Universal Dark Mode] Enabled'); } else { removeDarkMode(); console.log('[Universal Dark Mode] Disabled'); } } }); // Apply on load applyDarkMode(); // Re-apply on dynamic content var observer = new MutationObserver(function(mutations) { if (enabled && !document.getElementById('universal-dark-mode-style')) { applyDarkMode(); } }); observer.observe(document.head, { childList: true }); console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle'); })(); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/bug_report.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -19,6 +19,7 @@ Please provide details about your deployment to help us reproduce the issue.
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Medium
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] Stand-alone / Custom
Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/documentation-suggestion.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -20,4 +20,4 @@ Where should this documentation live? e.g., existing file in `docs/`, a new file
Please provide a draft or outline of the content you would like to add.

## Compliance Context (if applicable)
Does this documentation relate to a specific compliance regime (FedRAMP High, IL5) or NIST control?
Does this documentation relate to a specific compliance regime (FedRAMP Moderate, FedRAMP High, IL5) or NIST control?
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/feature_request.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -22,6 +22,7 @@ A clear and concise description of what you want to happen.
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Medium
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] All / General
Expand Down
3 changes: 2 additions & 1 deletion .github/pull_request_template.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -14,6 +14,7 @@ Fixes # (GitHub issue id)
* [ ] US Region Restricted (e.g., Access Policy constraint)
* [ ] FedRAMP Moderate
* [ ] FedRAMP High
* [ ] FedRAMP Moderate
* [ ] DoD IL4
* [ ] DoD IL5
* [ ] General / All
Expand All@@ -32,7 +33,7 @@ Fixes # (GitHub issue id)

### Security
- [ ] My change adheres to GCP security best practices and the principle of least privilege.
- [ ] I have ensured compliance with the targeted regime (FedRAMP High, IL5, etc.).
- [ ] I have ensured compliance with the targeted regime (FedRAMP Moderate, FedRAMP High, IL5, etc.).

### Testing
- [ ] I have tested my changes locally.
Expand Down
4 changes: 2 additions & 2 deletions GEMINI.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -4,7 +4,7 @@

Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF), providing Infrastructure as Code (IaC) to help Google Cloud Platform
(GCP) customers create secure and compliant landing zones. It has a strong focus on environments requiring Assured Workload overlays, such
as FedRAMP High, IL4, and IL5, and includes documentation mapping NIST 800-53r5 controls to accelerate Authorization to Operate (ATO)
as FedRAMP Moderate, FedRAMP High, IL4, and IL5, and includes documentation mapping NIST 800-53r5 controls to accelerate Authorization to Operate (ATO)
processes.

**Key Technologies:** Terraform, Google Cloud Platform (GCP)
Expand DownExpand Up@@ -35,7 +35,7 @@ outputs, and any dependencies.
Consistency in naming variables, resources, modules, and files is crucial.

5. **Security:** Adhere to GCP security best practices and the principle of least privilege in all configurations. Ensure compliance with
the targeted regime (FedRAMP High, IL5, etc.).
the targeted regime (FedRAMP Moderate, FedRAMP High, IL5, etc.).

## Key Codebase Resources

Expand Down
14 changes: 7 additions & 7 deletions README.md
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
## Introduction

Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF) repository, aimed at providing Infrastructure as Code (IaC) for Google Cloud Platform (GCP) customers who need to create a landing zone environment with the Assured Workload overlays. In addition to the IaC, there is [documentation available](./docs/path-to-authorization.md) for both FedRAMP High (FRH), Department of Defense (DoD) Impact Level 4 (IL4) and DoD Impact Level (IL5) compliance regimes that provide a mapping of National Institute of Standards and Technology (NIST) 800-53r5 controls to enable projects that leverage the Stellar Engine codebase to accelerate the speed at which an Authorization to Operate (ATO) can be attained.
Stellar Engine is a fork of the Google Cloud Foundation Fabric (CFF) repository, aimed at providing Infrastructure as Code (IaC) for Google Cloud Platform (GCP) customers who need to create a landing zone environment with the Assured Workload overlays. In addition to the IaC, there is [documentation available](/docs/path-to-authorization.md) for FedRAMP High (FRH), FedRAMP Moderate (FRM), Department of Defense (DoD) Impact Level 4 (IL4) and DoD Impact Level (IL5) compliance regimes that provide a mapping of National Institute of Standards and Technology (NIST) 800-53r5 controls to enable projects that leverage the Stellar Engine codebase to accelerate the speed at which an Authorization to Operate (ATO) can be attained.

## Getting Started

Expand All@@ -14,7 +14,7 @@ This repository provides **end-to-end blueprints** and a **suite of Terraform mo

The target audience for Stellar Engine is organizations and teams that operate in regulated industries or require robust compliance and security frameworks. Below are a few examples of these such users:

- **Government Agencies:** Agencies and contractors, such as those that work with FRH, IL4, and IL5 environments. <br />
- **Government Agencies:** Agencies and contractors, such as those that work with FRM, FRH, IL4, and IL5 environments. <br />
- **Regulated Industries:** Regulated industries often face overlapping compliance and security requirements; Stellar Engine can simplify that. <br />
- **Educational and Research Institutions:** Universities and research organizations working on government-funded projects that require secure and compliant cloud environments. <br />

Expand DownExpand Up@@ -45,26 +45,26 @@ The suite of modules in this repository is designed for rapid composition and re

All modules share a similar interface where each module tries to stay close to the underlying provider resources, support IAM together with resource creation and modification, offer the option of creating multiple resources where it makes sense (e.g. not for projects), and be completely free of side-effects (e.g. no external commands).

A well-defined naming standard is used across Stellar Engine to ensure adherence to Google Cloud's best practices, naming requirements, and naming collision avoidance for global resources. The Google Cloud naming standard documentation is [here](./documentation/naming-convention.md) and will be used before the Stellar Engine deployment begins by choosing a naming standard that will flow through the Google Cloud infrastructure state.
A well-defined naming standard is used across Stellar Engine to ensure adherence to Google Cloud's best practices, naming requirements, and naming collision avoidance for global resources. The Google Cloud naming standard documentation is [here](/docs/naming-convention.md) and will be used before the Stellar Engine deployment begins by choosing a naming standard that will flow through the Google Cloud infrastructure state.

The current modules support most of the core foundational and networking components used to design end-to-end infrastructure, with more modules in active development for specialized compute, security, and data scenarios.

For more information and usage examples see each module's README file, as well as any associated blueprints.

## End-to-End Blueprints

Stellar Engine currently offers blueprints that are compliant with [FRH](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-high) and [IL5](https://github.com/google/stellar-engine/tree/main/blueprints/il5) baselines. </br>
Stellar Engine currently offers blueprints that are compliant with [FRM](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-moderate), [FRH](https://github.com/google/stellar-engine/tree/main/blueprints/fedramp-high), and [IL5](https://github.com/google/stellar-engine/tree/main/blueprints/il5) baselines. </br>
These blueprints range from full end-to-end services like a Cloud Native Access Point (CNAP), to ad-hoc services that are designed to be molded to users' individual use cases.

For more information, please look at each blueprint's README file.

## Cybersecurity Documentation

In addition to the IaC, Stellar Engine provides supporting documentation that maps NIST 800-53r5 controls for users leveraging the IaC. This documentation is designed to streamline achieving ATO by providing generalized templates. All documentation can be requested [here](https://forms.gle/zdv7Gip4opmdhBqk7). For how to utilize these documents, please see the following [Path to Authorization](./docs/path-to-authorization.md) guide.
In addition to the IaC, Stellar Engine provides supporting documentation that maps NIST 800-53r5 controls for users leveraging the IaC. This documentation is designed to streamline achieving ATO by providing generalized templates. All documentation can be requested [here](https://forms.gle/zdv7Gip4opmdhBqk7). For how to utilize these documents, please see the following [Path to Authorization](/docs/path-to-authorization.md) guide.

## Detailed Deployment Guide

The Stellar Engine Cloud Foundation Fabric Detailed Deployment Guide (DDG) outlines a structured process for deploying a secure, compliant infrastructure on GCP using IaC. Designed to support compliance with standards such as FRH, IL4, and IL5, the guide enables organizations to create a foundational "landing zone" with Assured Workload overlays. It includes mappings of NIST 800-53r5 controls to streamline achieving ATO. The deployment process is divided into stages, each focusing on specific components like resource management, networking, and security configuration.
The Stellar Engine Cloud Foundation Fabric Detailed Deployment Guide (DDG) outlines a structured process for deploying a secure, compliant infrastructure on GCP using IaC. Designed to support compliance with standards such as FRM, FRH, IL4, and IL5, the guide enables organizations to create a foundational "landing zone" with Assured Workload overlays. It includes mappings of NIST 800-53r5 controls to streamline achieving ATO. The deployment process is divided into stages, each focusing on specific components like resource management, networking, and security configuration.

Key stages include Stage 0 (Bootstrap), which initializes the infrastructure, creates core Google Cloud Projects, and sets up service accounts; Stage 1 (Resource Management), which organizes Google Cloud Folders and Google Cloud Projects for tenants; and Stage 2 (Network Creation), which configures networking, including advanced setups like Palo Alto NGFWs for IL5 environments. The final stage, Stage 3 (Security and Audit Account Configuration), establishes security protocols, including Customer Managed Encryption Keys (CMEK) requirements and logging for audit purposes. Each stage requires detailed configuration of Terraform variables and adherence to prerequisites like IAM roles, service account setups, and enabling Google Cloud services.

Expand All@@ -82,7 +82,7 @@ For more information, please look at the [TDD](./docs/tdd.md).

## Security Best Practices Guide

The Stellar Engine Security Best Practices Guide (SBPG) outlines a robust framework for deploying secure and compliant GCP infrastructure. Designed for organizations requiring adherence to FRH and IL5 standards, it employs IaC principles via Terraform. The Stellar Engine facilitates the automated creation of a baseline GCP environment, supporting modular deployment of both Google and approved third-party services. Its hierarchical architecture ensures effective organization, leveraging role-based access control (RBAC), strict IAM policies, and a hub-and-spoke VPC networking design for isolation and scalability.
The Stellar Engine Security Best Practices Guide (SBPG) outlines a robust framework for deploying secure and compliant GCP infrastructure. Designed for organizations requiring adherence to FRM, FRH, and IL5 standards, it employs IaC principles via Terraform. The Stellar Engine facilitates the automated creation of a baseline GCP environment, supporting modular deployment of both Google and approved third-party services. Its hierarchical architecture ensures effective organization, leveraging role-based access control (RBAC), strict IAM policies, and a hub-and-spoke VPC networking design for isolation and scalability.

The document emphasizes best practices in identity and access management, security monitoring, and compliance. IAM configurations focus on the principle of least privilege, with automation enabling minimal human interaction during setup. Security features include encryption-at-rest, TLS enforcement, and centralized logging and monitoring through audit logs, VPC flow logs, and other diagnostics. The system supports Assured Workloads, providing region-specific data residency and compliance settings to meet regulatory requirements.

Expand Down
2 changes: 1 addition & 1 deletion blueprints/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -45,7 +45,7 @@ For more information, please see the individual README files in each blueprint's
| [Secret Manager](./fedramp-high/secret-manager/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |
| [Shielded VM Project](./il5/shielded-vm-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [Vertex MLOps](./fedramp-high/vertex-mlops/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |
| [VPC Peering Project](./il5/vpc-peering-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [VPC Peering Project](./stand-alone/vpc-peering-project/) | &nbsp; &nbsp; 🔗 &nbsp; &nbsp; | &nbsp; &nbsp; ✅ &nbsp; &nbsp; |
| [Workflows](./fedramp-high/workflows/) | &nbsp; &nbsp; ✅ &nbsp; &nbsp; | &nbsp; &nbsp; ❌ &nbsp; &nbsp; |

<br>
Expand Down
1 change: 0 additions & 1 deletion blueprints/il5/compute-engine/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -119,4 +119,3 @@ keyrings-keys = {
## Verification of a successful deployment?

- Go to the Compute Engine in the GCP Console. Select the VM. Check the Presistent Disk Encryption
![GCP Compute Engine Instance Presistent Disk Encryption](./images/vm-disk-1.png?raw=true "GCP Compute Engine Instance Presistent Disk Encryption")
2 changes: 1 addition & 1 deletion blueprints/third-party-solutions/gitlab/README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -242,7 +242,7 @@ following [link](https://docs.gitlab.com/omnibus/settings/ssl/#configure-https-m
If you want to deploy from your Cloud Shell, click on the image below, sign in
if required and when the prompt appears, click on “confirm”.

[![Open Cloudshell](../../../assets/images/cloud-shell-button.png)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fcloud-foundation-fabric&cloudshell_workspace=blueprints%2Fthird-party-solutions%2Fwordpress%2Fcloudrun)
![Open Cloudshell](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fcloud-foundation-fabric&cloudshell_workspace=blueprints%2Fthird-party-solutions%2Fwordpress%2Fcloudrun)

Otherwise, in your console of choice:

Expand Down
8 changes: 4 additions & 4 deletions docs/ddg.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -20,7 +20,7 @@ environment with the Assured Workload overlays. The project has been confirmed
to work with (DISA) Impact Level 5 (IL5), Impact Level 4 (IL4), and FedRAMP
High, but will function as a starting point for any other Assured Workloads
overlay. In addition to the IaC, there is documentation available for both the
IL5and FedRAMP High compliance regimes that provide a mapping of National
IL5, FedRAMP High, and FedRAMP Moderate compliance regimes that provide a mapping of National
Institute of Standards and Technology (NIST) 800-53r5 controls to enable
projects that leverage the Stellar Engine codebase to accelerate the speed at
which an Authorization to Operate (ATO) can be attained. These responses are
Expand DownExpand Up@@ -67,7 +67,7 @@ To make using this deployment guide easier, the variables described below need t
| :------------------------------------ | :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <strong>Billing Account</strong> | `billing_account.id` | The billing account to use for the deployment of the environments. <a href='https://console.cloud.google.com/billing'>Console Link</a> |
| <strong>Bootstrap Project ID</strong> | `bootstrap_project` | The bootstrap project id (created below) |
| <strong>Compliance Regime</strong> | `assured_workloads.regime` | The <a href='https://assuredworkloads.googleapis.com/$discovery/rest?version=v1'>compliance regime</a> for this environment, (confirmed working in IL4, IL5, FEDRAMP_HIGH, and COMPLIANCE_REGIME_UNSPECIFIED) |
| <strong>Compliance Regime</strong> | `assured_workloads.regime` | The <a href='https://assuredworkloads.googleapis.com/$discovery/rest?version=v1'>compliance regime</a> for this environment, (confirmed working in IL4, IL5, FEDRAMP_MODERATE, FEDRAMP_HIGH, and COMPLIANCE_REGIME_UNSPECIFIED) |
| <strong>Customer ID</strong> | `organization.customer_id` | The Google Workspace Directory Customer ID. <br/>Run <strong>gcloud organizations list</strong> to view. |
| <strong>Domain Name</strong> | `organization.domain` | The primary Fully Qualified Domain Name (FQDN). Run <strong>gcloud organizations list</strong> to view (make sure you have authorized as per prerequisites below) |
| <strong>Alert Email</strong> | `alert_email` | The email address used for logging alerts notifications. |
Expand DownExpand Up@@ -207,7 +207,7 @@ billing_account = {
id = "`<billing_account_id>`" # taken from Google Cloud Console Billing Accounts -> Manage Billing Account
}
# region configuration - this will automatically populate locations for GCS, BigQuery, KMS, and logging buckets
# Default to us-east4 for IL5/FedRAMP compliance - adjust as needed
# Default to us-east4 for IL5/FedRAMP High/Moderate compliance - adjust as needed
regions = {
primary = "`<region>`"
}
Expand DownExpand Up@@ -391,7 +391,7 @@ gcloud storage cp gs://${FAST_PREFIX}-prod-iac-core-outputs-0/tfvars/0-bootstrap

## Stage 2 - Network Creation

## FedRAMP High - Stage 2.1 Networking
## FedRAMP High / Moderate - Stage 2.1 Networking

### Steps

Expand Down
8 changes: 4 additions & 4 deletions docs/path-to-authorization.md
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
# Path to Authorization

_Impact Level 5 (H-H-X)& FedRAMP High_
_Impact Level 5 (H-H-X), FedRAMP High & FedRAMP Moderate_

**Created Date:**

Expand DownExpand Up@@ -67,7 +67,7 @@ privacy risks
managed, and authorized for operation or use.
- [Impact Level 5 Authorization
Boundary](https://forms.gle/zdv7Gip4opmdhBqk7)
- [FedRAMP High Authorization
- [FedRAMP High & Moderate Authorization
Boundary](https://forms.gle/zdv7Gip4opmdhBqk7)
- Regularly assess the security and privacy risks at the organization level
and system level. Update risk assessment results on an on-going basis.
Expand DownExpand Up@@ -111,10 +111,10 @@ risk assessment(s)
frequency in which the controls are monitored?
- [Security Control Traceability Matrix (SCTM)
Templates](https://forms.gle/zdv7Gip4opmdhBqk7)
(IL5 H-H-Xand FedRAMP High Baselines)
(IL5 H-H-X, FedRAMP High, and FedRAMP Moderate Baselines)
- [Policies and Procedures
Templates](https://forms.gle/zdv7Gip4opmdhBqk7)
(IL5 HHXand FedRAMP High Baselines)
(IL5 HHX, FedRAMP High, and FedRAMP Moderate Baselines)

[**Step 3;
Implement**](https://csrc.nist.gov/Projects/risk-management/about-rmf/implement-step):
Expand Down
Loading
Loading