From c561277d5a169acabbe43270ec517b1008a0b3b9 Mon Sep 17 00:00:00 2001 From: Michael Porter Date: Thu, 15 Mar 2018 17:44:18 +0000 Subject: [PATCH] Add README --- readme.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 readme.md diff --git a/readme.md b/readme.md new file mode 100644 index 0000000..f888729 --- /dev/null +++ b/readme.md @@ -0,0 +1,26 @@ +# Certbot plugin for authentication using Gandi LiveDNS + +This is a plugin for Certbot https://certbot.eff.org/ that uses the Gandi +LiveDNS API to allow Gandi https://www.gandi.net/ +customers to prove control of a domain name. + +1. Obtain a Gandi API token (see https://doc.livedns.gandi.net/) +2. Install the plugin: + ``` + pip install 'git+https://gitlab.com/cspublic/certbot-plugin-gandi.git' + ``` +3. Create a `gandi.ini` config file with the following contents: + ``` + certbot_plugin_gandi:dns_api_key=APIKEY + ``` + Replace `APIKEY` with your Gandi API key and ensure permissions are set + to disallow access to other users. +4. Run `certbot` and direct it to use the plugin for authentication and to use + the config file created in (3): + ``` + certbot certonly -a certbot-plugin-gandi:dns --certbot-plugin-gandi:dns-credentials gandi.ini -d domain.com' + ``` + Add additional options as required to specify an installation plugin etc. + + +