Metadata-Version: 2.1
Name: certbot-plugin-gandi
Version: 1.1.0
Summary: Certbot plugin for authentication using Gandi LiveDNS
Home-page: https://github.com/obynio/certbot-plugin-gandi
Author: Yohann Leon
Author-email: yohann@leon.re
License: UNKNOWN
Description: # 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.
        
        ## Usage
        
        1. Obtain a Gandi API token (see [Gandi LiveDNS API](https://doc.livedns.gandi.net/))
        
        2. Install the plugin using `pip install certbot-plugin-gandi`
        
        3. Create a `gandi.ini` config file with the following contents and apply `chmod 600 gandi.ini` on it:
           ```
           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 previously created:
           ```
           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.
        
        ## Updates
        
        This plugin can be updated by running:
        
        ```
        pip install certbot-plugin-gandi --upgrade
        ```
        
        ## Wildcard certificates
        
        This plugin is particularly useful when you need to obtain a wildcard certificate using dns challenges:
        
        ```
        certbot certonly -a certbot-plugin-gandi:dns --certbot-plugin-gandi:dns-credentials gandi.ini -d domain.com -d \*.domain.com --server https://acme-v02.api.letsencrypt.org/directory
        ```
        
        ## Automatic renewal
        
        You can setup automatic renewal using `crontab` with the following job for weekly renewal attempts:
        
        ```
        * 1 * * 1 certbot renew -q -a certbot-plugin-gandi:dns --certbot-plugin-gandi:dns-credentials /etc/letsencrypt/gandi/gandi.ini --server https://acme-v02.api.letsencrypt.org/directory
        ```
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Plugins
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Security
Classifier: Topic :: System :: Installation/Setup
Classifier: Topic :: System :: Networking
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python:  >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
Description-Content-Type: text/markdown
