mirror of https://github.com/moepman/acertmgr.git synced 2024-12-29 09:21:51 +01:00

Automated Certificate Manager using ACME

Go to file

David Klaftenegger 3a1a5a62b8 restore python3 compatibility		2016-04-12 11:53:48 +02:00
acertmgr_ssl.py	restore python3 compatibility	2016-04-12 11:53:48 +02:00
acertmgr_web.py	Refactor webserver into separate file	2016-04-12 11:53:22 +02:00
acertmgr.py	correctly handle multiple domain names	2016-04-12 11:53:43 +02:00
LICENSE	Change copyright information	2016-04-12 11:53:37 +02:00
README.md	replace acme-tiny	2016-04-12 11:53:32 +02:00

README.md

ACERTMGR

This is an automated certificate manager using ACME/letsencrypt.

Running ACERTMGR

The main file acertmgr.py is intended to be run regularly (e.g. as daily cron job) as root.

Requirements

Python (2.7+ and 3.4+ should work)
python-dateutil
PyYAML
pyopenssl

Initial Setup

First, you need to provide two key files for acme-tiny:

The account key is expected at /etc/acme/account.key
The domain key is expected at /etc/acme/server.key (note: only one domain key is required for all domains used in the same instance of acertmgr) If you are missing these keys, you can create them using openssl genrsa 4096 > /etc/acme/account.key and openssl genrsa 4096 > /etc/acme/server.key respectively. Otherwise refer to the acme-timy documentation for how to reuse your existing keys.

Second, you should decide which challenge mode you want to use with acertmgr

webdir: In this mode, challenges are put into a directory, and served by an existing webserver. Make sure the target directory exists!
standalone: In this mode, challenges are completed by acertmgr directly. This starts a webserver to solve the challenges, which can be used standalone or together with an existing webserver that forwards request to a specified local port.

Finally, you need to setup the configuration files, as shown in the next section.

Configuration

The main configuration is read from /etc/acme/acme.conf, domains for which certificates should be obtained/renewed should be configured in /etc/acme/domains.d/{fqdn}.conf.

All configuration files use yaml syntax.

Example global configuration file:

---

mode: webdir
#mode: standalone
#port: 13135
webdir: /var/www/acme-challenge/
cafile: /etc/acme/letencrypt_ca.crt

defaults:
  format: crt

Example domain configuration file:

---

mail.example.com:
- path: /etc/postfix/ssl/mail.key
  user: postfix
  group: postfix
  perm: '400'
  format: key
  action: '/etc/init.d/postfix reload'
- path: /etc/postfix/ssl/mail.crt
  user: postfix
  group: postfix
  perm: '400'
  format: crt
  action: '/etc/init.d/postfix reload'
- path: /etc/dovecot/ssl/mail.crt
  user: dovecot
  group: dovecot
  perm: '400'
  action: '/etc/init.d/dovecot reload'

Security

Please keep the following in mind when using this software:

DO read the source code, since it is intended to be run as root
Make sure that your configuration files are NOT writable by other users - arbitrary commands can be executed after updating certificates