Skip to main content

Shared responsibility model

Three parties are responsible for a BuiltForProd deployment. AWS runs the cloud. BuiltForProd customizes, deploys and hands over the platform, and operates it only if you buy Managed. Your organization owns the accounts, the identities, the repositories and the operation from the moment of handover. The line does not move unless you move it with a Managed engagement.

The three parties

Responsibility by area

AreaAWSBuiltForProd (delivery)Your organization
The cloud itselfRegions, Availability Zones, hardware, the managed services (EKS control plane, DocumentDB, Glue, KMS and the rest)Chooses the services and how they are configuredChooses home region, address plan and which paid switches are on
The AWS OrganizationOrganizations, SCPs and quotas as a serviceCreates the Organization, OUs, 13 member accounts, SCPs and tag policy as codeOwns the management account and its root credentials; owns the root mailbox that every account's plus-addressed email lands in; requests the account quota increase
IdentityIAM Identity Center as a serviceCreates permission sets and group assignments as codeCreates the ACME_* groups in Identity Center or your identity provider, adds and removes people, enforces MFA, runs the quarterly access audit
RepositoriesGitHub is not AWSForks and customizes the repositories, sets every TODO: value, hands them over in your GitHub organizationOwns the GitHub organization, teams, Environments and reviewers; every change after handover
PipelinesSTS and OIDC federationCreates the OIDC provider, deployer roles and workflowsHolds the trust: your GitHub organization is the only identity the deployer roles accept; you approve prod applies
DeploymentApplies changesExecutes the initial deployment of the Baseline and any purchased blueprints, in every tierEvery apply after handover runs from your pipelines under your approvals
Security servicesRuns GuardDuty, Security Hub, Config and the othersDelegates them to the security account and sets the defaultsTriages findings, decides which paid services and standards to switch on, receives the alerts
SecretsKMS and Parameter StoreCreates the per-stage keys and the sync workflowOwns every secret value; edits them through pull requests to the secrets repository
DataStorage and encryption at restNothing: BuiltForProd never holds customer dataAll application and customer data, backups and their restore tests
DocumentationAWS documentationThe workbooks and this siteKeeping your fork's documentation in step with your changes

After handover

At handover the BuiltForProd team has deployed the environment and handed over the customized repositories and the documentation. From then on:

  • Human access to your AWS accounts exists only through your IAM Identity Center groups, and only your administrators grant or revoke membership.
  • Pipeline access exists only through GitHub OIDC from your GitHub organization; no AWS key was ever created for a person or a pipeline.
  • BuiltForProd holds no credentials for your accounts. The privacy and data handling page states the same from the data side.

Your team operates the platform with the roles, code ownership and runbooks described on the Operable page: Platform Leads own the landing zone and approve production changes, DevOps Leads own the pipelines and command incidents, application and data teams own their blueprint repositories, and security auditors hold read-only access with an explicit deny on data.

Under a Managed engagement

BuiltForProd Managed moves part of the operating responsibility back to BuiltForProd, by tier:

TierWhat BuiltForProd takes on
On-DemandConsultation and support when you ask, by the hour; your team keeps operating
Support SLAThe same, under a response commitment defined in your agreement
Team AugmentationDedicated engineers embedded in your team, part-time or full-time, working inside your repositories, your reviews and your approvals

Managed engineers work as members of your organization: they sign in through the Identity Center groups you grant, they change the platform through pull requests under your CODEOWNERS rules, and they apply through your pipelines. Access ends when you remove them from the group. What does not move under any tier: ownership of the accounts, the root mailbox, the repositories, the data, and the final approval on production changes.

What AWS is responsible for

AWS is responsible for the security of the cloud: the physical infrastructure, the regions and zones, and the managed services the platform builds on. The platform configures those services (encryption, logging, network boundaries, access) and that configuration is what this documentation describes. The Baseline product page lists what BuiltForProd delivers; the security posture summary lists the controls that configuration puts in place.