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.5.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.5-py3-none-any.whl (12.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: gridworks_cert-0.4.5.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.5.tar.gz
Algorithm Hash digest
SHA256 b5ea78625874c6a98732653ca1c83193fcc08bb56963b7c90ada690d826fa903
MD5 45e78035b1419d333169d6935b0b5f8e
BLAKE2b-256 042c6237c049f96d061b2b55eb29286deb4ae5cb4abffcba888d796d79f0e638

See more details on using hashes here.

File details

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

File metadata

  • Download URL: gridworks_cert-0.4.5-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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 6626941a163eb7de663a254c9a03959c2148a174382e514f14b745e1261ddce2
MD5 5106405dd5f3264d1912d70557c83df4
BLAKE2b-256 5f47f8a26a474c6156d08205c6d5319a613221a10a9c72b8246f54453f237dbd

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