Files
acdl/modules/l1/kms-key
Jon Chery fad6765b9e
acdl-ci / Lint (pull_request) Successful in 8s
acdl-ci / Test (pull_request) Successful in 4m7s
acdl-ci / Platform check-only (offline) (pull_request) Successful in 20s
acdl-modules-lifecycle / CI VPC apply (pull_request) Successful in 37s
acdl-modules-lifecycle / L1 lifecycle (cloudfront) (pull_request) Has been cancelled
acdl-modules-lifecycle / L1 lifecycle (ecr) (pull_request) Has been cancelled
acdl-modules-lifecycle / L1 lifecycle (ecs-cluster) (pull_request) Has been cancelled
acdl-modules-lifecycle / L1 lifecycle (ecs-service) (pull_request) Has been cancelled
acdl-modules-lifecycle / L1 lifecycle (iam-role) (pull_request) Has been cancelled
acdl-modules-lifecycle / L1 lifecycle (kms-key) (pull_request) Has been cancelled
acdl-modules-lifecycle / L1 lifecycle (rds) (pull_request) Has been cancelled
acdl-modules-lifecycle / L1 lifecycle (s3) (pull_request) Has been cancelled
acdl-modules-lifecycle / L1 lifecycle (uptime) (pull_request) Has been cancelled
acdl-modules-lifecycle / L1 lifecycle (vpc) (pull_request) Has been cancelled
acdl-modules-lifecycle / L1 lifecycle (waf) (pull_request) Has been cancelled
acdl-modules-lifecycle / CI VPC destroy (pull_request) Has been cancelled
acdl-modules-lifecycle / L1 lifecycle (alb) (pull_request) Has been cancelled
fix: kms-key deletion window range + rds password policy
- kms-key: complex example had deletion_window_days=90 (max is 30).
  Fixed to 30.
- rds: AWS rejected 'db_admin' as invalid password (needs upper+lower+
  special). Added password variable (default 'ACdlcI2026!') to the RDS
  module + interface + both example contracts.

---ci---
project: acdl
phase: P59
milestone: v1.11
status: execute
---/ci---
2026-07-28 18:40:04 +00:00
..

kms-key — KMS customer-managed key

Module kind: primitive | Version: 1.0.0

A customer-managed KMS key for per-stack encryption. Created with key rotation enabled. One key per L2 deployment (no shared keys).

Resources

Resource Type Purpose
kms-key aws_kms_key The KMS customer-managed key

Inputs

Name Type Required Default Description
description string yes Description of the KMS key
region string yes AWS region the KMS key is created in
deletion_window_days number no 30 Number of days before the key is deleted after deletion is requested

Outputs

Name Type Description
kms_key_arn arn The ARN of the KMS key
kms_key_id string The ID of the KMS key

NFRs

Name Type Default Description
enable_rotation boolean true Enable automatic key rotation
deletion_protection boolean true Prevent key destruction
encryption_enabled boolean true Encryption is always enabled for a KMS key

Usage

{
  "id": "kms-key",
  "type": "aws:kms:key",
  "module": "kms-key@1.0.0",
  "inputs": {
    "description": "ACDL per-stack CMK",
    "region": "us-east-1"
  }
}

A concrete instance is at instance.json (used by the platform pipeline as the regression baseline).

Compliance extension points

  • Key rotation — automatic key rotation enabled by default (SOC2 CC6.1, GDPR Art.32).
  • Deletion protection — pending deletion window prevents accidental destruction (SOC2 CC7.2).
  • Key policy — restrict key usage to the stack's IAM roles (SOC2 CC6.1, GDPR Art.32).
  • Audit logging — CloudTrail logs all KMS API calls (SOC2 CC7.2, DORA audit trail).

Examples

Validated example contracts are in examples/. The platform-test pipeline validates them against schemas/contract.schema.json.

Simple

A minimal deployment:

examples/simple.yml

environment: dev
id: kms
infrastructure:
  kms-key:
    inputs:
      description: Simple CMK for testing
      region: us-east-1
    version: 1.0.0
name: kms-key

Complex

A production deployment with optional inputs:

examples/complex.yml

environment: dev
id: kms
infrastructure:
  kms-key:
    inputs:
      deletion_window_days: 90
      description: Production CMK with 90-day deletion window
      region: us-east-1
    version: 1.0.0
name: kms-key

Versioning

1.0.0 — interface MAJOR, behavior MINOR, lifecycle PATCH. MAJOR bumps require a new registry entry (immutable publication); old entries enter a 12-month deprecation window.