Skip to main content

TLS certificate management tools for GridWorks

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, CSRs and certificates with arbitrary input and output paths, via gwcert key add.
  • Build cli commands visually with gwcert tui.

Installation

The recommended way to install gwcert is with pipx from PyPI:

$ pipx install gridworks-cert

Usage

Get help with any of:

gwcert
gwcert ca
gwcert key

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

gwcert ca create

Show information about the locally created ca and keys with:

gwcert ca info

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

gwcert key add KEY_NAME

Show information about a certificate:

gwcert key info KEY_NAME

Build CLI commands visually:

gwcert tui

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.4.6.tar.gz (11.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gridworks_cert-0.4.6-py3-none-any.whl (12.7 kB view details)

Uploaded Python 3

File details

Details for the file gridworks_cert-0.4.6.tar.gz.

File metadata

  • Download URL: gridworks_cert-0.4.6.tar.gz
  • Upload date:
  • Size: 11.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for gridworks_cert-0.4.6.tar.gz
Algorithm Hash digest
SHA256 5cdd62e8a5c86a677c77857881a28d91da84d5e6b4582779c928db5613bb5285
MD5 ec244cc6a70c77b9cdb825c812ffc7ec
BLAKE2b-256 a90fd91cdc4369aefcd03ac8e24fcdd6050780a189efbe2d3318e0d67c718b97

See more details on using hashes here.

File details

Details for the file gridworks_cert-0.4.6-py3-none-any.whl.

File metadata

  • Download URL: gridworks_cert-0.4.6-py3-none-any.whl
  • Upload date:
  • Size: 12.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for gridworks_cert-0.4.6-py3-none-any.whl
Algorithm Hash digest
SHA256 dea0357f5c2092402d21c3bc65cde3f8c4e25600db5ae967b66897d8d2056913
MD5 4a473c927c98097a211475fbbe53fc82
BLAKE2b-256 deeaf4afb7dc016f112687b6542edc1ceed9a08abefaa6f72e04c77a0f0eb3ab

See more details on using hashes here.

Supported by

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