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

Uploaded Source

Built Distribution

gridworks_cert-0.4.4-py3-none-any.whl (12.8 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for gridworks_cert-0.4.4.tar.gz
Algorithm Hash digest
SHA256 1ef9c8c3a6937da35a74725f15916dd797c3e339e484e0afc0320966a7b58824
MD5 c001dc59ad634c384c87257af9889567
BLAKE2b-256 ccbe7d344dd434843fe392b7b7ae7d3e820d8254ce0d08f367df06db41026594

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for gridworks_cert-0.4.4-py3-none-any.whl
Algorithm Hash digest
SHA256 baea75c70fb4026fd4870803ba0c027c12ddbf2a760c5169a399be79db1972c1
MD5 3828760ccc9f1b19a0a40d30d0733b0b
BLAKE2b-256 ad20b67624ec585b86a7e0bf22566cc9d8d3c8958f7ee1aa2d8ab009784864e5

See more details on using hashes here.

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