Skip to main content

SecretManager class to retrieve secrets from AWS System Manager Parameter Store

Project description

AWS SSM Parameter Store SecretManager class

This class provides some functions for retrieving secrets / parameters stored in AWS Parameter Store

Getting started

pip install ssm_secret_manager

Create a SecretManager instance

from ssm_secret_manager import SecretManager

    'region_name': 'us-east-1',
    'SECRETS': {
        'secret_name_1': 'secret_key_1_in_parameter_store',
        'secret_name_2': 'secret_key_2_in_parameter_store'

secret_manager = SecretManager(

SecretManager will fetch the value from parameter store based on the key defined in the secrets_mapping dictionary, and set the value of the parameter to the secret name.

# subsequently, you access the secret via the following line
secret_value_1 = secret_manager.get_secret('secret_name_1')
secret_value_2 = secret_manager.get_secret('secret_name_2')

Common Question

  1. Encountered ParameterNotFound

    • Make sure the secret is being defined in the correct region in AWS, and your AWS profile has the permission to view the secret (i.e. correct IAM role permission)
  2. What is the differences between secret_name and secret_key_in_parameter_store shown in the code example?

    • secret_key_in_parameter_store is the name of the parameter in AWS Parameter Store

      AWS Parameter Store

    • secret_name allows you to have a common variable / key name to access to the value of secret given different environment

    • For example, you have a secret_name - DB_PASSWORD. In dev environment your secret_key_in_parameter_store might be set to DEV_DB_PASSWORD while your prod environment it's set to PROD_DB_PASSWORD. Using SecretManager, you can retrieve the value for different environment using the common key name DB_PASSWORD, i.e.


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ssm_secret_manager-0.1.1.tar.gz (2.5 kB view hashes)

Uploaded source

Built Distribution

ssm_secret_manager-0.1.1-py3-none-any.whl (3.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page