{ "info": { "author": "Massaki Archambault", "author_email": "badjware@massaki.ca", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Environment :: Plugins", "Intended Audience :: System Administrators", "License :: OSI Approved :: Apache Software License", "Operating System :: POSIX :: Linux", "Programming Language :: Python", "Topic :: Internet :: WWW/HTTP", "Topic :: Security", "Topic :: System :: Installation/Setup", "Topic :: System :: Networking", "Topic :: System :: Systems Administration", "Topic :: Utilities" ], "description": "# certbot-dns-cpanel\n\nPlugin 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.\n\n## How to use\n### 1. Install\nFirst, install certbot and the plugin using pip:\n```\npip install certbot certbot-dns-cpanel\n```\n### 2. Configure\nDownload the file `credentials.ini.exemple` and rename it to `credentials.ini`. Edit it to set your cPanel url, username and password.\n```\n# The url cPanel url\n# include the scheme and the port number (usually 2083 for https)\ncertbot_dns_cpanel:cpanel_url = https://cpanel.exemple.com:2083\n\n# The cPanel username\ncertbot_dns_cpanel:cpanel_username = user\n\n# The cPanel password\ncertbot_dns_cpanel:cpanel_password = hunter2\n```\n### 3. Run\nYou can now run certbot using the plugin and feeding the credentials file. \nFor exemple, to get a certificate for exemple.com and www.exemple.com:\n```\ncertbot certonly \\\n--authenticator certbot-dns-cpanel:cpanel \\\n--certbot-dns-cpanel:panel-credentials /path/to/credentials.ini \\\n-d exemple.com \\\n-d www.exemple.com\n```\nTo create a wildcard certificate *.exemple.com and install it on an apache server, the installer plugin must be specified with the `--installer` option.\nYou will need to install the apache plugin if it's not already present on your system.\n```\npip install certbot-apache\ncertbot run \\\n--apache \\\n--authenticator certbot-dns-cpanel:cpanel \\\n--installer apache \\\n--certbot-dns-cpanel:cpanel-credentials /path/to/credentials.ini \\\n-d '*.exemple.com'\n```\nThe certbot documentation has some additionnal informations about combining authenticator and installer plugins: https://certbot.eff.org/docs/using.html#getting-certificates-and-choosing-plugins\n\n## Docker\nA docker image based on [certbot/certbot](https://hub.docker.com/r/certbot/certbot/) is provided for your convenience:\n```\ndocker run \\\n-v /path/to/credentials.ini:/tmp/credentials.ini \\\nbadjware/certbot-dns-cpanel \\\ncertonly \\\n--authenticator certbot-dns-cpanel:cpanel \\\n--certbot-dns-cpanel:cpanel-credentials /tmp/credentials.ini \\\n-d exemple.com \\\n-d www.exemple.com\n```\n\n## Additional documentation\n* https://documentation.cpanel.net/display/DD/Guide+to+cPanel+API+2\n* https://certbot.eff.org/docs/\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/badjware/certbot-dns-cpanel", "keywords": "certbot letsencrypt cpanel dns-01 plugin", "license": "Apache Licence 2.0", "maintainer": "", "maintainer_email": "", "name": "certbot-dns-cpanel", "package_url": "https://pypi.org/project/certbot-dns-cpanel/", "platform": "", "project_url": "https://pypi.org/project/certbot-dns-cpanel/", "project_urls": { "Homepage": "https://github.com/badjware/certbot-dns-cpanel" }, "release_url": "https://pypi.org/project/certbot-dns-cpanel/0.2.1/", "requires_dist": [ "certbot", "zope.interface" ], "requires_python": "", "summary": "certbot plugin to allow acme dns-01 authentication of a name managed in cPanel.", "version": "0.2.1" }, "last_serial": 5417837, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "31da045b3f33f08d6e19af92a25cecad", "sha256": "cec44f8c39b53c5dc78b8591905a5201c9106a84c5ae71088569b23eb1678157" }, "downloads": -1, "filename": "certbot_dns_cpanel-0.1.0-2-py3-none-any.whl", "has_sig": false, "md5_digest": "31da045b3f33f08d6e19af92a25cecad", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 4691, "upload_time": "2018-04-27T01:19:59", "url": "https://files.pythonhosted.org/packages/10/ff/7b49f094b68eee483d7e47d97ea9ad2ba1e8f0dfbad8b88330abf8196165/certbot_dns_cpanel-0.1.0-2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "21656136e72254e980090aebc1b7bf43", "sha256": "f3eac317852220ec4c73024203ffd972b4ca78854d717cb2c5d5438a89c90a55" }, "downloads": -1, "filename": "certbot-dns-cpanel-0.1.0-2.tar.gz", "has_sig": false, "md5_digest": "21656136e72254e980090aebc1b7bf43", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4092, "upload_time": "2018-04-27T01:20:00", "url": "https://files.pythonhosted.org/packages/a9/2d/2ba882a31e7ee19750b00c3c69edd72a01dc340ce78f4803207e12e3cfb0/certbot-dns-cpanel-0.1.0-2.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "0bd7b1fe4fea1f27a74a390215f1c007", "sha256": "1473b80bb15920ec40968ca919cba75a42efcc8ea9ef9c6ebd9d82a1c1213bb5" }, "downloads": -1, "filename": "certbot_dns_cpanel-0.2.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "0bd7b1fe4fea1f27a74a390215f1c007", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 4851, "upload_time": "2018-05-02T21:21:07", "url": "https://files.pythonhosted.org/packages/d9/0d/4698445e562743b0545572f1d91cb0bb088a3532ad69037b568526e1dda4/certbot_dns_cpanel-0.2.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ca6a197af4660a451191385ea1281acf", "sha256": "7963cf7c09290c599708dad4cb2f2db2f1cb0d9daad3b884b7339437878370e1" }, "downloads": -1, "filename": "certbot-dns-cpanel-0.2.0.tar.gz", "has_sig": false, "md5_digest": "ca6a197af4660a451191385ea1281acf", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4289, "upload_time": "2018-05-02T21:21:08", "url": "https://files.pythonhosted.org/packages/92/b8/0015a1979fc63c795d08c22a82b0663e1b52eef111f89bdab20cbe8abb36/certbot-dns-cpanel-0.2.0.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "3f667f2da78055a86cfd4c7b2c1f32bf", "sha256": "de1b15af2ba8bb8a6ca7ca62a42e6c76af953d54eadeb3a55ce9dd1980487fef" }, "downloads": -1, "filename": "certbot_dns_cpanel-0.2.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "3f667f2da78055a86cfd4c7b2c1f32bf", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 8538, "upload_time": "2019-06-19T00:39:35", "url": "https://files.pythonhosted.org/packages/f3/6e/ebd5359efc6353e0620f327882a8f8997c31e52be0c7d95b7e2bc528da76/certbot_dns_cpanel-0.2.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "162505be17ee91815c3f964436b667cb", "sha256": "2863a1d2d932596a7c5d05199475cae36f4e4f582c22f53b4dcb7e7c507cde50" }, "downloads": -1, "filename": "certbot-dns-cpanel-0.2.1.tar.gz", "has_sig": false, "md5_digest": "162505be17ee91815c3f964436b667cb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4299, "upload_time": "2019-06-19T00:39:37", "url": "https://files.pythonhosted.org/packages/95/70/595a8defb7df60771bcdac7ddb0353b29b1389c9f51a3a1e10b20b0c517a/certbot-dns-cpanel-0.2.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "3f667f2da78055a86cfd4c7b2c1f32bf", "sha256": "de1b15af2ba8bb8a6ca7ca62a42e6c76af953d54eadeb3a55ce9dd1980487fef" }, "downloads": -1, "filename": "certbot_dns_cpanel-0.2.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "3f667f2da78055a86cfd4c7b2c1f32bf", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 8538, "upload_time": "2019-06-19T00:39:35", "url": "https://files.pythonhosted.org/packages/f3/6e/ebd5359efc6353e0620f327882a8f8997c31e52be0c7d95b7e2bc528da76/certbot_dns_cpanel-0.2.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "162505be17ee91815c3f964436b667cb", "sha256": "2863a1d2d932596a7c5d05199475cae36f4e4f582c22f53b4dcb7e7c507cde50" }, "downloads": -1, "filename": "certbot-dns-cpanel-0.2.1.tar.gz", "has_sig": false, "md5_digest": "162505be17ee91815c3f964436b667cb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4299, "upload_time": "2019-06-19T00:39:37", "url": "https://files.pythonhosted.org/packages/95/70/595a8defb7df60771bcdac7ddb0353b29b1389c9f51a3a1e10b20b0c517a/certbot-dns-cpanel-0.2.1.tar.gz" } ] }