Skip to main content

gwcert

Project description

gwcert

PyPI Status Python Version License

Read the documentation at https://gridworks-cert.readthedocs.io/ Tests Codecov

pre-commit Black

Tools for creating TLS certificates for use with, e.g. MQTT and RabbitMQ.

NOTE: these are temporary tools for non-production deployments. This library is more or less equivalent to a README containing OpenSSL commands, but less manual.

This library is a thin wrapper around ownca, which wraps pyca/cryptography, which wraps the OpenSSL C library. See also tls-gen, a repo from rabbitmq, which performs a similar task using a stack of make/python/OpenSSL CLI.

Features

  • Create a local Certificate Authority directory with a self-signed certificate, via gwcert ca create.
  • Create named key pairs and sign them with the created CA with, via gwcert ca add-key.

Installation

You can install gwcert via pip from PyPI:

$ pip install gridworks-cert

Usage

Get help with any of:

gwcert
gwcert ca
gwcert ca create --help
gwcert ca add-key --help

Create a Certificate Authority directory with a self-signed certificate via:

gwcert ca create

Show information about the locally created ca with:

gwcert ca info

Add a named set of keys (public, private, certificate) via:

gwcert ca add-key

Please see the Command-line Reference for more details.

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide.

License

Distributed under the terms of the MIT license, gwcert is free and open source software.

Issues

If you encounter any problems, please file an issue along with a detailed description.

Credits

This project was generated from @cjolowicz's Hypermodern Python Cookiecutter template.

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

gridworks_cert-0.1.0.tar.gz (5.9 kB view hashes)

Uploaded Source

Built Distribution

gridworks_cert-0.1.0-py3-none-any.whl (6.8 kB view hashes)

Uploaded Python 3

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