AWS SAM Secrets: Secure Serverless Secret Management
What Is SAM Secret?
SAM Secret (in AWS SAM – Serverless Application Model) is a secure secrets management pattern for serverless applications that encrypts sensitive configuration at deploy time and decrypts at runtime.
Core Function
Protects API keys, database passwords, tokens, and other secrets by encrypting via AWS KMS during sam deploy and injecting decrypted values as Lambda environment variables at runtime—never exposing plaintext in code repositories.
How It Works
- Define secrets in
template.yaml using AWS::SecretsManager::Secret or Parameter Store
- SAM CLI encrypts via KMS during
sam deploy
- Lambda runtime injects decrypted values as environment variables
- Application code reads
process.env.SECRET_NAME – plaintext never in repo
Key Features
- AES-256 encryption via AWS KMS
- No plaintext in code/artifact
- Automatic rotation support (Secrets Manager)
- Fine-grained IAM – least privilege per function
- Audit trail – CloudTrail logs all access
vs. Alternatives
- Plain env vars: Visible in console, CloudFormation
- Parameter Store (SecureString): Similar, but SAM Secret integrates natively
- Third-party (HashiCorp Vault, Doppler): More features, more complexity
Best practice for serverless secret handling in AWS.