A small Python library for declarative management of app secrets. https://projects.bthlabs.pl/keep-it-secret/
Go to file
Tomek Wójcik a449e18fe7
All checks were successful
CI / Checks (push) Successful in 45s
KIS-0000: WIP
2024-05-31 09:15:47 +02:00
.gitea/workflows KIS-0000: WIP 2024-05-31 09:15:47 +02:00
docs v1.2.1 2024-05-29 21:43:59 +02:00
keep_it_secret v1.2.1 2024-05-29 21:43:59 +02:00
skel Release v1.0.0 2024-01-04 20:30:54 +01:00
tests v1.2.0 2024-02-08 20:52:08 +00:00
.gitignore Release v1.0.0 2024-01-04 20:30:54 +01:00
CHANGELOG.md v1.2.1 2024-05-29 21:43:59 +02:00
invoke.yaml Release v1.0.0 2024-01-04 20:30:54 +01:00
LICENSE Release v1.0.0 2024-01-04 20:30:54 +01:00
poetry.lock v1.2.0 2024-02-08 20:52:08 +00:00
pyproject.toml v1.2.1 2024-05-29 21:43:59 +02:00
README.md v1.2.1 2024-05-29 21:43:59 +02:00
setup.cfg v1.2.0 2024-02-08 20:52:08 +00:00
tasks.py Release v1.0.0 2024-01-04 20:30:54 +01:00

Keep It Secret by BTHLabs

Keep It Secret is a small Python library for declarative management of app secrets.

Docs | Source repository

Installation

$ pip install keep_it_secret

Usage

Keep It Secret gives a developer API needed to declare secrets used by the app and access them in a secure, uniform manner.

Consider the following example:

from secrets_manager import (
    AbstractField, EnvField, LiteralField, Secrets, SecretsField,
)
from secrets_manager.ext.aws import AWSSecrets, AWSSecretsManagerField

class AppSecrets(Secrets):
    secret_key: str = AbstractField.new()
    db_password: str = EnvField.new('APP_DB_PASSWORD', required=True)
    pbkdf2_iterations_count: int = EnvField(
        'APP_PBKDF2_ITERATIONS_COUNT',
        default=16384,
        required=False,
        as_type=int,
    )

class DevelopmentSecrets(AppSecrets):
    secret_key: str = LiteralField.new('thisisntsecure')

class ProductionSecrets(AppSecrets):
    aws: AWSSecrets = SecretsField.new(AWSSecrets)
    secret_key: str = AWSSecretsManagerField(
        'app/production/secret_key', required=True,
    )
    db_password: str = AWSSecretsManagerField(
        'app/production/db_password', required=True,
    )

The AppSecrets class serves as base class for environment specific classes. The environment specific classes can overload any field, add new fields and extend the base class to provide custom behaviour.

The DevelopmentSecrets class uses environment variables and literal values to provide secrets suitable for the development environment:

>>> development_secrets = DevelopmentSecrets()
>>> development_secrets.secret_key
'thisisntsecure'
>>> development_secrets.db_password
'spam'
>>> development_secrets.pbkdf2_iterations_count
1024

The ProductionSecrets class uses environment variables and AWS Secrets Manager to provide secrets suitable for the production environment:

>>> production_secrets = ProductionSecrets()
>>> production_secrets.aws.access_key_id
'anawsaccesskey'
>>> production_secrets.secret_key
'asecuresecretkey'
>>> production_secrets.db_password
'asecuredbpassword'
>>> production_secrets.pbkdf2_iterations_count
16384

Author

Keep It Secret is developed by Tomek Wójcik.

License

Keep It Secret is licensed under the MIT License.