Metadata-Version: 2.1
Name: certbot-plugin-gandi
Version: 1.2.5
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:
           ```
           # live dns v5 api key
           certbot_plugin_gandi:dns_api_key=APIKEY
        
           # optional organization id, remove it if not used
           certbot_plugin_gandi:dns_sharing_id=SHARINGID
           ```
           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.
        
        Please note that this solution is usually not relevant if you're using Gandi's web hosting services as Gandi offers free automated certificates for all simplehosting plans having SSL in the admin interface. Huge thanks to Michael Porter for its original work !
        
        ## Distribution
        
        * PyPI: https://pypi.org/project/certbot-plugin-gandi/
        * Archlinux: https://aur.archlinux.org/packages/certbot-dns-gandi-git/
        
        ## 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:
        
        ```
        0 0 * * 0 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
