Skip to main content

A service to manage, retrieve and store secrets.

Project description

Build Status


A tool for managing secrets.

Custodia is a project that aims to define an API for modern cloud applications that allows to easily store and share passwords, tokens, certificates and any other secret in a way that keeps data secure, manageable and auditable.

The Custodia project offers example implementations of clear text and encrypted backends, and aims to soon provide drivers to store data in external data stores like the Vault Project, OpenStack’s Barbican, FreeIPA’s Vault and similar.

In future the Custodia project plans to enhance and enrich the API to provide access to even more secure means of dealing with private keys, like HSM as a Service and other similar security systems.

See the Custodia documentation for more information:



  • configparser (Python 2.7)
  • cryptography
  • jwcrypto >= 0.2
  • requests
  • six

Installation and testing

  • pip
  • setuptools >= 18.0
  • tox >= 2.3.1
  • wheel

API stability

Some APIs are provisional and may change in the future.

  • Command line interface in module custodia.cli.
  • The script custodia-cli.

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
custodia-0.4.0-py2.py3-none-any.whl (44.8 kB) Copy SHA256 hash SHA256 Wheel py2.py3
custodia-0.4.0.tar.gz (99.5 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page