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.5.0.tar.gz (12.0 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.5.0-py3-none-any.whl (12.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: gridworks_cert-0.5.0.tar.gz
  • Upload date:
  • Size: 12.0 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.5.0.tar.gz
Algorithm Hash digest
SHA256 f0ddf0fbad44692373a2c8d6cdc808af853a1af2d16c90dc88ccfbdf40b52ca0
MD5 41e29fc6cbd25d02adf77cabc04b3234
BLAKE2b-256 c4488bbcaf6bcbcc2f8e6dc3cd240b6a46447738b65fba6dda42e72e45c6aee9

See more details on using hashes here.

File details

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

File metadata

  • Download URL: gridworks_cert-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 12.8 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.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c369a2880cf067c3d12db042d2c0e5ce89ae3505a657fec13eb65b916d9e7852
MD5 74c76b39776546e3439e34d96fa01909
BLAKE2b-256 a5678105c0e6f3e28db43962b8c4b39a1a6f38aaf8feb956ee5a786bf03cd453

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