Metadata-Version: 2.1
Name: certbot-dns-cpanel
Version: 0.2.2
Summary: certbot plugin to allow acme dns-01 authentication of a name managed in cPanel.
Home-page: https://github.com/badjware/certbot-dns-cpanel
Author: Massaki Archambault
Author-email: badjware@massaki.ca
License: Apache Licence 2.0
Description: # certbot-dns-cpanel
        
        Plugin to allow acme dns-01 authentication of a name managed in cPanel. Useful for automating and creating a Let's Encrypt certificate (wildcard or not) for a service with a name managed by cPanel, but installed on a server not managed in cPanel.
        
        ## Named Arguments
        | Argument | Description |
        | --- | --- |
        | --certbot-dns-cpanel:cpanel-credentials &lt;file&gt; | cPanel credentials INI file **(required)** |
        | --certbot-dns-cpanel:cpanel-propagation-seconds &lt;seconds&gt; | The number of seconds to wait for DNS to propagate before asking the ACME server to verify the DNS record (Default: 30) |
        
        ## Install
        ``` bash
        pip install certbot-dns-cpanel
        ```
        
        ## Credentials
        Download the file `credentials.ini.exemple` and rename it to `credentials.ini`. Edit it to set your cPanel url, username and password.
        ```
        # The url cPanel url
        # include the scheme and the port number (usually 2083 for https)
        certbot_dns_cpanel:cpanel_url = https://cpanel.exemple.com:2083
        
        # The cPanel username
        certbot_dns_cpanel:cpanel_username = user
        
        # The cPanel password
        certbot_dns_cpanel:cpanel_password = hunter2
        ```
        
        ## Exemple
        You can now run certbot using the plugin and feeding the credentials file.  
        For exemple, to get a wildcard certificate for *.exemple.com and exemple.com:
        ``` bash
        certbot certonly \
        --authenticator certbot-dns-cpanel:cpanel \
        --certbot-dns-cpanel:cpanel-credentials /path/to/credentials.ini \
        -d 'exemple.com' \
        -d '*.exemple.com'
        ```
        
        You can also specify a installer plugin with the `--installer` option.
        ``` bash
        certbot run \
        --authenticator certbot-dns-cpanel:cpanel \
        --installer apache \
        --certbot-dns-cpanel:cpanel-credentials /path/to/credentials.ini \
        -d 'exemple.com' \
        -d '*.exemple.com'
        ```
        
        ## Docker
        A docker image [badjware/certbot-dns-cpanel](https://hub.docker.com/r/badjware/certbot-dns-cpanel), based on [certbot/certbot](https://hub.docker.com/r/certbot/certbot) is provided for your convenience:
        ``` bash
        docker run -it \
        -v /path/to/credentials.ini:/tmp/credentials.ini \
        badjware/certbot-dns-cpanel \
        certonly \
        --authenticator certbot-dns-cpanel:cpanel \
        --certbot-dns-cpanel:cpanel-credentials /tmp/credentials.ini \
        -d 'exemple.com' \
        -d '*.exemple.com'
        ```
        
        ## Additional documentation
        * https://documentation.cpanel.net/display/DD/Guide+to+cPanel+API+2
        * https://certbot.eff.org/docs/
        
Keywords: certbot letsencrypt cpanel dns-01 plugin
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Plugins
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
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
Description-Content-Type: text/markdown
