{ "info": { "author": "Oliver Ney", "author_email": "oliver@dryder.de", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Plugins", "Intended Audience :: System Administrators", "License :: OSI Approved :: Apache Software License", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3", "Topic :: Internet :: Name Service (DNS)", "Topic :: Security :: Cryptography" ], "description": "# certbot-dns-inwx\nINWX DNS authenticator plugin for certbot\n\nAn authenticator plugin for [certbot](https://certbot.eff.org/) to support [Let's Encrypt](https://letsencrypt.org/) DNS challenges (dns-01) for domains managed by the nameservers of InterNetworX ([INWX](https://www.inwx.com)).\n\n## Requirements\n* certbot (>=0.15)\n* setuptools (for manual installation; e.g. `python3-setuptools`)\n\nFor older Ubuntu distributions check out this PPA: [ppa:certbot/certbot](https://launchpad.net/~certbot/+archive/ubuntu/certbot)\n\n## Installation\n1. First install the plugin:\n * Without dependencies (if using certbot from your distribution repository):\n ```\n python3 setup.py develop --no-deps\n ```\n * With dependencies (not recommended if using certbot from your distribution repositories):\n ```\n python3 setup.py install\n ```\n * Via PIP:\n ```\n pip install certbot-dns-inwx\n ```\n * With certbot-auto (needs to be reinstalled after every certbot-auto update):\n ```\n /opt/eff.org/certbot/venv/bin/pip install .\n ```\n\n2. Configure it with your INWX API Login Details:\n ```\n vim /etc/letsencrypt/inwx.cfg\n ```\n with the following content (also see *inwx.cfg* of the repository):\n ```\n certbot_dns_inwx:dns_inwx_url = https://api.domrobot.com/xmlrpc/\n certbot_dns_inwx:dns_inwx_username = your_username\n certbot_dns_inwx:dns_inwx_password = your_password\n certbot_dns_inwx:dns_inwx_shared_secret = your_shared_secret optional\n ```\n The shared secret is your INWX 2FA OTP code. It is shown to you when setting up the 2FA. It is **not** the 6 digit code you need to enter when siging in. If you are not using 2FA, simply keep the value the way it is.\n3. Make sure the file is only readable by root! Otherwise all your domains might be in danger:\n ```\n chmod 0600 /etc/letsencrypt/inwx.cfg\n ```\n\n## Usage\nRequest new certificates via a certbot invocation like this:\n\n certbot certonly -a certbot-dns-inwx:dns-inwx -d sub.domain.tld -d *.wildcard.tld\n\nRenewals will automatically be performed using the same authenticator and credentials by certbot.\n\n## Command Line Options\n```\n --certbot-dns-inwx:dns-inwx-propagation-seconds CERTBOT_DNS_INWX:DNS_INWX_PROPAGATION_SECONDS\n The number of seconds to wait for DNS to propagate\n before asking the ACME server to verify the DNS\n record. (default: 60)\n --certbot-dns-inwx:dns-inwx-credentials CERTBOT_DNS_INWX:DNS_INWX_CREDENTIALS\n Path to INWX account credentials INI file (default:\n /etc/letsencrypt/inwx.cfg)\n\n```\n\nSee also `certbot --help certbot-dns-inwx:dns-inwx` for further information.\n\n## CNAME Redirects\nThis plugin supports redirections on the DNS-01 validation records using CNAME records.\n\nFor example, you can have a domain `a.tld` which is not necessarily managed by INWX and possibly may not be automated via certbot. Additionally, you have a domain `b.tld` which is managed by INWX.\n\nAn easy solution to automate certificate retrieval for `a.tld` is to add a CNAME record for the name `_acme_challenge.a.tld` to `a.tld` which is pointing to i.e. `_a_validation.b.tld` in your providers web interface.\n\nA command like `certbot -a certbot-dns-inwx:dns-inwx -d a.tld` will then make certbot place its validation token at `_a_validation.b.tld` via INWX and your validation for `a.tld` succeeds.\n\n**NOTE:** This is an optional feature and requires dnspython to be installed. To install it use your distribution repository or i.e. `pip install dnspython`.\n\n## Note\nWhile the plugin itself is licensed according to the Apache License v2.0 the contained INWX DomRobot Client by INWX is licensed according to the MIT License.\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/oGGy990/certbot-dns-inwx", "keywords": "", "license": "Apache License 2.0", "maintainer": "", "maintainer_email": "", "name": "certbot-dns-inwx", "package_url": "https://pypi.org/project/certbot-dns-inwx/", "platform": "", "project_url": "https://pypi.org/project/certbot-dns-inwx/", "project_urls": { "Homepage": "https://github.com/oGGy990/certbot-dns-inwx" }, "release_url": "https://pypi.org/project/certbot-dns-inwx/2.1.2/", "requires_dist": [ "acme", "certbot (>=0.15)", "setuptools (>=1.0)", "zope.interface", "dnspython ; extra == 'cname'" ], "requires_python": "", "summary": "INWX DNS Authenticator plugin for Certbot", "version": "2.1.2" }, "last_serial": 5353843, "releases": { "2.1.1": [ { "comment_text": "", "digests": { "md5": "765f0a2e4219d042467c4d82838b1de0", "sha256": "9abb6a1f3bf6c5ddcb5460d04d17050b4e0c06664c6a5fa6698089d242f5434d" }, "downloads": -1, "filename": "certbot_dns_inwx-2.1.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "765f0a2e4219d042467c4d82838b1de0", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 12360, "upload_time": "2019-01-30T20:15:12", "url": "https://files.pythonhosted.org/packages/f8/2a/6b4cb9bbf4143290be43ef814441d953a5ff1a935a93972b4b991fc5ece9/certbot_dns_inwx-2.1.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3fa9697b5e0dddfd35b7679d696d4e26", "sha256": "d34eac9423b4423c8ce2b75ae59152f8707625ff976b0e2a2061bdf6a346b25a" }, "downloads": -1, "filename": "certbot-dns-inwx-2.1.1.tar.gz", "has_sig": false, "md5_digest": "3fa9697b5e0dddfd35b7679d696d4e26", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7164, "upload_time": "2019-01-30T20:15:21", "url": "https://files.pythonhosted.org/packages/b1/e3/d990644f44a838ff8b26570b5052386cb0b5efa0c0c1e498f4987a5c72c6/certbot-dns-inwx-2.1.1.tar.gz" } ], "2.1.2": [ { "comment_text": "", "digests": { "md5": "62479320b5d1c50008aec40898ea266c", "sha256": "0199ade4e0b99e4532484657e6eb1cad02199a8f789bcac19cccfd6692af9c27" }, "downloads": -1, "filename": "certbot_dns_inwx-2.1.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "62479320b5d1c50008aec40898ea266c", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 12390, "upload_time": "2019-06-03T18:32:00", "url": "https://files.pythonhosted.org/packages/85/7f/8e6d19eca03a62071acd86d5e1b21f1de98734eb9c1d6f3ff7401a6af9bd/certbot_dns_inwx-2.1.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ecd19688dcd527534eb896e0743bb779", "sha256": "2e2710a4ec01996d7df2ec88a9f0af13d7e019d709ae817da360c9cad0b9c891" }, "downloads": -1, "filename": "certbot-dns-inwx-2.1.2.tar.gz", "has_sig": false, "md5_digest": "ecd19688dcd527534eb896e0743bb779", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7211, "upload_time": "2019-06-03T18:32:02", "url": "https://files.pythonhosted.org/packages/7a/74/fa1d755003d64f62106d252d1f9ddb39ac213453f1ce4f10c7f71a5bf84a/certbot-dns-inwx-2.1.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "62479320b5d1c50008aec40898ea266c", "sha256": "0199ade4e0b99e4532484657e6eb1cad02199a8f789bcac19cccfd6692af9c27" }, "downloads": -1, "filename": "certbot_dns_inwx-2.1.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "62479320b5d1c50008aec40898ea266c", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 12390, "upload_time": "2019-06-03T18:32:00", "url": "https://files.pythonhosted.org/packages/85/7f/8e6d19eca03a62071acd86d5e1b21f1de98734eb9c1d6f3ff7401a6af9bd/certbot_dns_inwx-2.1.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ecd19688dcd527534eb896e0743bb779", "sha256": "2e2710a4ec01996d7df2ec88a9f0af13d7e019d709ae817da360c9cad0b9c891" }, "downloads": -1, "filename": "certbot-dns-inwx-2.1.2.tar.gz", "has_sig": false, "md5_digest": "ecd19688dcd527534eb896e0743bb779", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7211, "upload_time": "2019-06-03T18:32:02", "url": "https://files.pythonhosted.org/packages/7a/74/fa1d755003d64f62106d252d1f9ddb39ac213453f1ce4f10c7f71a5bf84a/certbot-dns-inwx-2.1.2.tar.gz" } ] }