CertApi
Certapi talks with DNS provider and ACME to issue SSL certificates and save it to a keystore.
CertApi is a base library for building other tools, or to integrate Certificate creation feature in your app. CertAPI also provides HTTP api server and can be deployed using Docker
Why another library?
I designed this library so that it can be imported and plugged in to other python projects. Goal is not to provide CLIs or quick working demo, but to be versatile for any use case.
- Pluggable keystores for keys and certificates
- Pluggable Challenge solvers for DNS and Http challenge solving
- High-level manager with renewal checks and multi-solver support
- Same interface for working locally, or requesting certificate from certapi server.
See the developer guide in Developer.md for library usage and workflows.
Installation
You can install CertApi using pip
pip install certapi
CLI
CertApi also ships with a CLI for quick verification and certificate issuance.
## Certapi's dependencies are already included in the python installation. This doesn't affect the system.
sudo python3 -m pip install certapi --break-system-packages
1. With HTTP Challenge
HTTP challenge requires you to have seup the DNS correctly. The ACME server will verify your domain by making an HTTP request.
# Verify environment and HTTP routing
sudo certapi verify example.com www.example.com
# Obtain a certificate (requires root for HTTP-01)
sudo certapi obtain example.com www.example.com
2. With DNS Provider Key
Using DNS-01 challenge with Cloudflare doesn't require the DNS to be setup. Set your Cloudflare API key as an environment variable.
# Set Cloudflare API key or token
export CLOUDFLARE_API_KEY=... # or CLOUDFLARE_API_TOKEN
# Verify DNS configuration
sudo certapi verify example.com
# Obtain a certificate using DNS-01
sudo certapi obtain example.com www.example.com
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file certapi-1.1.15.tar.gz.
File metadata
- Download URL: certapi-1.1.15.tar.gz
- Upload date:
- Size: 74.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.10.21
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
783daa89657ec5974e8d069a372b18da808689b9b2c5f53259739b6cfd2bc031
|
|
| MD5 |
943f6bbb16891a255e348add40d39493
|
|
| BLAKE2b-256 |
00cacd6386186759e844dbbb02d7e9dddfb521b26eb5f43fd3a0a0617511414f
|
File details
Details for the file certapi-1.1.15-py3-none-any.whl.
File metadata
- Download URL: certapi-1.1.15-py3-none-any.whl
- Upload date:
- Size: 66.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.10.21
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2e3567004e80e383663d0a30ed67209105c16175b7b4bc930247b13cf582339d
|
|
| MD5 |
4079aeb774530e238ed20d501e545ec7
|
|
| BLAKE2b-256 |
5f8abb1bc624b7865b2652a3729281be10c9fcf6417d8d3c14e19441eda266cd
|
