Skip to content

docs(cli): document cloud assembly as a trust boundary - #1983

Merged
mrgrain merged 2 commits into
mainfrom
iankhou/cloud-assembly-trust-boundary
Sep 23, 2026
Merged

mrgrain merged 2 commits into
mainfrom
iankhou/cloud-assembly-trust-boundary

Conversation

@iankhou

@iankhou iankhou commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

Fixes #1919

Developers should only deploy Cloud Assemblies they trust. When synth-ing and deploying on the same machine, there is no trust concern for deployment.

However, if a developer deploys a Cloud Assembly from an external source like cdk deploy --app /downloaded/file/path/cdk.out, they must trust that source. Deploying using an untrusted Cloud Assembly can run untrusted code within the developer's shell environment and using the developer's AWS credentials.

This change document the cloud assembly as an explicit trust boundary in the cdk synth section of the CLI README, and in the fromAssemblyDirectory API docs.

The developer guide has been updated with similar guidance.

Checklist

  • This change contains a major version upgrade for a dependency and I confirm all breaking changes are addressed
    • Release notes for the new version:

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license

@iankhou
iankhou deployed to no-approval September 21, 2026 14:21 — with GitHub Actions Active
@iankhou
iankhou marked this pull request as ready for review September 21, 2026 14:21
@aws-cdk-automation
aws-cdk-automation requested a review from a team September 21, 2026 14:22
@github-actions

Copy link
Copy Markdown
Contributor

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

@iankhou iankhou closed this Sep 22, 2026

This branch had an error being deployed

1 failed (outdated) and 2 active deployments
run-tests 5f931410 Deployed Sep 22, 2026 by iankhou via integ_cli (cli-integ-tests, 24.19, 11) #6976
no-approval 5f931410 Deployed Sep 22, 2026 by iankhou via prepare #6976
automation 4935254a Deployed Sep 21, 2026 by iankhou via Set AutoQueue on PR #1983 #3591
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug p2 pr/exempt-integ-test Skips the integ test steps if set.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

fix: resolve executable against PATH instead of cwd on Windows

3 participants