Managing application secrets: SSM Parameter Store vs. Secrets Manager
Many applications interact with external or internal systems like databases or REST APIs. When your application talks to another system, it usually authenticates with a secret, e.g., an API key, username + password, or a certificate. This leads to the question: How can we safely make the secret available to our application? In this blog post, I compare two options provided by AWS: Parameter Store and Secrets Manager.
When our application starts, the needed secrets are fetched at runtime from a secure system. But we need to authenticate with the secure system before we can get the secrets. Does this lead to a chicken and egg problem? Not if you use an AWS service where you can authenticate with AWS credentials. Luckily, AWS provides short-lived credentials to our application via the Metadata service (e.g., EC2 & Fargate) or environment variables (e.g., Lambda). With the short-lived AWS credentials, we can reach out to fetch the secrets.
AWS Secrets Manager is purpose build to store and retrieve secrets. We can restrict access to secrets with identity-based IAM policies (attached to IAM users and roles) and resource-based IAM policies attached to the secret directly. This allows you to share secrets with other AWS accounts as well.
A great feature that is poorly implemented is secret rotation. Once you define a secret, you also have to develop a process to rotate the secret from time to time (AWS recommends rotating secrets every 30 days). Rotation can be done in different ways. My preferred approach is this:
Hej, Andreas & Michael here!
We launched the cloudonaut blog in 2015. Since then, we have published 323 articles: small tips and tricks, best practices, and service reviews. We enjoy writing about all things AWS a lot.
Do you like our blog posts and podcast episodes? Have you learned something new? Consider supporting us create in-depth and independent AWS content. Please help us with a monthly or one-time payment through GitHub Sponsors.Start supporting us today!
- Create a new secret (e.g., add database user) and store the value
- Update the
latestlabel to point to the new secret version
- Wait for all applications to retrieve the new secret version (e.g., retrieve the secret every 12 hours)
- Delete the old secret (e.g., remove database user)
Unfortunately, not all systems support this kind of rotation. Sometimes we can only generate a single API key. If you still want to rotate the secret, you will risk a short downtime. AWS provides a set of Lambda function templates to rotate secrets for RDS, Redshift, and DocumntDB. But keep in mind that the rotation logic runs in your AWS account, so you are responsible if things go wrong.
Another handy feature of Secrets Manager are multi-region secrets to replicate secrets into multiple regions.
Finally, I want to mention AWS provided caching libs to lower the costs and improve performance.
Parameter Store is part of AWS Systems Manager. Parameters can be secrets or plain-text values. By default, Parameter Store does not support resource-based IAM policies. By using a KMS customer-managed CMK for encryption of the secret, you can add a resource-based IAM policy. The resource-based IAM policy of the KMS key controls access to the key and, therefore, to the parameter value.
A useful feature of Parameter Store are parameter policies to:
- Delete a parameter at a specific date
- Send a notification if a parameter expires
- Send a notification if a parameter was not changed for n days
The notifications are delivered via Amazon EventBridge as well as a notification if a parameter changes. I used the parameter change notification in the past to trigger pipelines if a parameter value changed.
The following table shows the differences between Secrets Manager and Parameter Store.
|Secrets Manager||Parameter Store|
|Pricing||$0.40 / month & $0.05 / 10,000 API calls||free|
|Retrivals per second||5,000||40 (or 3,0001)|
|Versions & Labels||✅ Yes||✅ Yes|
|Resource-based IAM policy||✅ Yes||❌ No (workaround: KMS CMK key policy)|
|Deletion protection||Schedule for deletion||❌ No|
|Secret Rotation||Lambda templates||❌ No|
|Multi-Region replication||✅ Yes||❌ No|
|Payload limit||~65KB||4KB (or 8KB1)|
|ABAC (tag-based)||✅ Yes||✅ Yes|
|Auditing (CloudTrail)||✅ Yes||✅ Yes|
|EventBridge integration||❌ No||✅ Yes|
|Lifecycle policies||❌ No||✅ Yes 1|
|CloudFormation usage||✅ Yes||specific version only|
|Terraform usage||secret is leaked in the state file||secret is leaked in the state file|
- 1. Advanced tier: $0.05 per parameter and $0.05 / 10,000 API calls ↩