{"id":15574560,"url":"https://github.com/runfalk/certbot-dns-glesys","last_synced_at":"2025-12-14T07:14:09.106Z","repository":{"id":57466533,"uuid":"105366803","full_name":"runfalk/certbot-dns-glesys","owner":"runfalk","description":" GleSYS DNS authentication plugin for Certbot","archived":false,"fork":false,"pushed_at":"2022-08-21T10:53:40.000Z","size":21,"stargazers_count":8,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-23T10:46:32.286Z","etag":null,"topics":["letsencrypt","letsencrypt-plugin","ssl"],"latest_commit_sha":null,"homepage":"https://pypi.python.org/pypi/certbot-dns-glesys/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/runfalk.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-09-30T11:56:58.000Z","updated_at":"2023-11-10T08:17:33.000Z","dependencies_parsed_at":"2022-09-10T08:20:34.197Z","dependency_job_id":null,"html_url":"https://github.com/runfalk/certbot-dns-glesys","commit_stats":null,"previous_names":["runfalk/certbot-glesys"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runfalk%2Fcertbot-dns-glesys","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runfalk%2Fcertbot-dns-glesys/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runfalk%2Fcertbot-dns-glesys/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runfalk%2Fcertbot-dns-glesys/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/runfalk","download_url":"https://codeload.github.com/runfalk/certbot-dns-glesys/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248075253,"owners_count":21043554,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["letsencrypt","letsencrypt-plugin","ssl"],"created_at":"2024-10-02T18:19:06.756Z","updated_at":"2025-12-14T07:14:04.056Z","avatar_url":"https://github.com/runfalk.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"GleSYS DNS Authenticator for Certbot\n====================================\nThis allows automatic completion of `Certbot's \u003chttps://github.com/certbot/certbot\u003e`_\nDNS01 challange for domains managed on `GleSYS \u003chttps://www.glesys.com/\u003e`_ DNS.\n\n\nInstalling\n----------\nInstallation of Certbot plugins are a bit tricky. The least bad way is to create\na Python virtual environment as *root* and install it there.\n\n.. code-block::\n\n   $ cd /root/\n   $ python3 -m venv --prompt=certbot certbot\n   $ source certbot/bin/activate\n   $ pip install --upgrade pip setuptools\n   $ pip install certbot-dns-glesys\n\nYou can now run Certbot using ``/root/certbot/bin/certbot``.\n\nIf you use Fedora like me I have prepared\n`an RPM \u003chttps://github.com/runfalk/certbot-glesys/releases\u003e`_ you can use\ninstead.\n\n.. code-block::\n\n   $ sudo dnf install https://github.com/runfalk/certbot-dns-glesys/releases/download/2.0.0/python3-certbot-dns-glesys-2.0.0-1.fedora33.noarch.rpm\n\nIf you use another RPM based distribution you may be able to build it yourself.\nOn Fedora I install `rpmdevtools` before this. Note that this command must not\nbe run inside a virtualenv (or the installation path will be incorrect). You can\nverify the installation path using `rpm -qpl dist/*.rpm`.\n\n.. code-block::\n\n   $ ./make_rpm.sh\n\nPRs are welcome for other distributions.\n\n\nUsage\n-----\nCreate an API key with the following permissions:\n\n- ``domain:list``\n- ``domain:listrecords``\n- ``domain:addrecord``\n- ``domain:deleterecord``\n\nDon't forget to give access to the appropriate IP-address range. If you want\nto be able to run the client from anywhere, enter ``0.0.0.0/0``.\n\nTo use the authenticator you need to provide some required options:\n\n``--dns-glesys-credentials`` *(required)*\n  INI file with ``user`` and ``password`` for your GlesSYS API user.\n\nThe credentials file must have the following format:\n\n.. code-block::\n\n   dns_glesys_user = CL00000\n   dns_glesys_password = apikeygoeshere\n\nFor safety reasons the file must not be world readable. You can solve this by\nrunning:\n\n.. code-block::\n\n   $ chmod 600 credentials.ini\n\nThen you can run ``certbot`` using:\n\n.. code-block::\n\n   $ certbot certonly \\\n       --authenticator dns-glesys \\\n       --dns-glesys-credentials credentials.ini \\\n       -d domain.com\n\nIf you want to obtain a wildcard certificate you can use the the domain\n``-d \"*.domain.com\"``.\n\n\nDisclaimer\n----------\nThis plugin is neither affiliated with nor endorsed by GleSYS Internet Services\nAB.\n\n\nChangelog\n=========\n\nVersion 2.1.0\n-------------\nReleased 21st August 2022\n\n- Fixed plugin not being detected by newer certbot versions.\n\n\nVersion 2.0.0\n-------------\nReleased 28th December 2020\n\n**This is a breaking change. The CLI arguments and the name of the package has\nchanged to match other DNS authenticator plugins.**\n\n- Updated name to `certbot-dns-glesys` to match other DNS plugins\n- Move away from legacy Certbot API (means you need to reconfigure your\n  authenticator). All arguments and parameters are now prefix-less\n- Dropped Python 2 support\n- Dropped Python 3.5 support\n\n\nVersion 1.0.0\n-------------\nReleased 11th April 2020\n\n- Changed to GleSYS JSON API\n- Added RPM as an installation option\n- Dropped support for EOL Python versions\n\n\nVersion 0.2.0\n-------------\nReleased on 23rd April 2018\n\n**This is a breaking change since it requires the** ``domain:list``\n**permission.**\n\n- Added proper support for sub domain guessing, pull request\n  `#4 \u003chttps://github.com/runfalk/certbot-glesys/pull/4\u003e`_\n  (`@Lillecarl \u003chttps://github.com/Lillecarl\u003e`_)\n\n\nVersion 0.1.1\n-------------\nReleased on 15th March, 2018\n\n- Bumped default propagation time to 90 seconds to improve reliability\n- Fixed wrong base url in ``GlesysDomainApiClient``, pull request\n  `#2 \u003chttps://github.com/runfalk/certbot-glesys/pull/2\u003e`_\n  (`@montaniasystemab \u003chttps://github.com/montaniasystemab\u003e`_)\n\n\nVersion 0.1.0\n-------------\nReleased on 30th September, 2017\n\n- Initial release\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frunfalk%2Fcertbot-dns-glesys","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frunfalk%2Fcertbot-dns-glesys","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frunfalk%2Fcertbot-dns-glesys/lists"}