Skip to main content

A simple tool for quickly issuing server and client certificates.

Project description

Gimmecert is a simple CLI tool for quickly issuing X.509 server and client certificates using locally-generated CA hierarchy with minimal hassle.

The tool is useful for issuing certificates in:

  • Local environment, when trying out a piece of new software that depends on use of certificates.

  • Development environment, when it is necessary to issue certificates either for purpose of integration with other systems, or for ability to develop new feature that involves use of certificates.

  • Testing/CI/CD environment, when it is necessary to deploy/configure tests to use certificates in order to ensure the tests are run properly and in full.

At time of this writing, Gimmecert is compatible with the following Python versions:

  • Python 3.5

  • Python 3.6

  • Python 3.7

  • Python 3.8

Why was this tool created?

The tool was created to remove the pain of setting-up a CA hierarchy, and then using this hierarchy to issue a couple of test certificates.

While there are existing tools that can be used to this end (in particular the OpenSSL’s CLI and GnuTLS’ certtool), the process of using them is tedious, slow, and error-prone.

There are some more long-lived solutions out there, in form of full-blown CAs, but those can be both an overkill and resource hog when all a person needs is a couple of certificates that can be thrown away.

Features

Gimmecert provides the following features:

  • It is very easy to use. Commands are intuitive, and require minimal input from the user.

  • Initialisation of CA hierarchy for issuing certificates. CA hierarchy depth can be specified, letting you easily simulate your production environment.

  • Issuance of TLS server certificates, with any number of DNS subject alternative names.

  • Issuance of TLS client certificates.

  • All generated artifacts stored within a single sub-directory (.gimmecert), relative to directory where command is invoked. This allows you to easily issue per-project testing certificates.

Support

In case of problems with the tool, please do not hesitate to contact the author at gimmecert (at) majic.rs. Known issues and planned features are tracked on website:

The tool is hosted on author’s own server, alongside a mirror on Github:

Documentation is available on:

License

Gimmecert code is licensed under the terms of GPLv3, or (at your option) any later version. You should have received the full copy of the GPLv3 license in the local file LICENSE-GPLv3, or you may read the full text of the license at:

Gimmecert documentation is licensed under the terms of CC-BY-SA 3.0 Unported license. You should have received the full copy of the CC-BY-SA 3.0 Unported in the local file LICENSE-CC-BY-SA-3.0-Unported, or you may read the full text of the license at:

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

gimmecert-0.4.0.tar.gz (88.3 kB view details)

Uploaded Source

Built Distribution

gimmecert-0.4.0-py3-none-any.whl (42.7 kB view details)

Uploaded Python 3

File details

Details for the file gimmecert-0.4.0.tar.gz.

File metadata

  • Download URL: gimmecert-0.4.0.tar.gz
  • Upload date:
  • Size: 88.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.15.0 pkginfo/1.4.2 requests/2.20.1 setuptools/40.6.2 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.5.3

File hashes

Hashes for gimmecert-0.4.0.tar.gz
Algorithm Hash digest
SHA256 52adf88161061d6c03dedfb78284e9e5164dca050ce13d5d32020ec5fb674d5d
MD5 2d58c2e1bbd096dae72f7bc175cce48f
BLAKE2b-256 1933eecb22a1c0f764d1a20ec6a873d28bac45300d2c54013345d6be335977b8

See more details on using hashes here.

File details

Details for the file gimmecert-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: gimmecert-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 42.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.15.0 pkginfo/1.4.2 requests/2.20.1 setuptools/40.6.2 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.5.3

File hashes

Hashes for gimmecert-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6242a0dc530960828ad0d7f3e231d8a6d7d367d74c9a87a5a996a468a5124219
MD5 dc02f7d195ab8a767290e4f5112bd9ad
BLAKE2b-256 ef1fcdf9435f008c13c53348d610ab2865d9bf5c3c588d75b630f070eea03a19

See more details on using hashes here.

Supported by

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