{"id":16479527,"url":"https://github.com/kaechele/certbot-dns-pdns","last_synced_at":"2025-03-21T07:30:25.282Z","repository":{"id":198777766,"uuid":"701524198","full_name":"kaechele/certbot-dns-pdns","owner":"kaechele","description":"Certbot DNS Authenticator for PowerDNS","archived":false,"fork":false,"pushed_at":"2025-03-11T14:21:09.000Z","size":335,"stargazers_count":12,"open_issues_count":2,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-11T15:34:21.394Z","etag":null,"topics":["certbot","certbot-dns","certbot-dns-authenticator","powerdns"],"latest_commit_sha":null,"homepage":"","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/kaechele.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-10-06T20:35:22.000Z","updated_at":"2025-03-11T14:21:07.000Z","dependencies_parsed_at":"2023-10-16T16:45:39.407Z","dependency_job_id":"e9a73f9e-08a5-476a-8b05-7967a41b18f1","html_url":"https://github.com/kaechele/certbot-dns-pdns","commit_stats":null,"previous_names":["kaechele/certbot-dns-pdns"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaechele%2Fcertbot-dns-pdns","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaechele%2Fcertbot-dns-pdns/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaechele%2Fcertbot-dns-pdns/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaechele%2Fcertbot-dns-pdns/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kaechele","download_url":"https://codeload.github.com/kaechele/certbot-dns-pdns/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244117903,"owners_count":20400782,"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":["certbot","certbot-dns","certbot-dns-authenticator","powerdns"],"created_at":"2024-10-11T12:52:07.715Z","updated_at":"2025-03-21T07:30:25.276Z","avatar_url":"https://github.com/kaechele.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Certbot DNS Authenticator for PowerDNS\n\nPowerDNS DNS Authenticator plugin for [Certbot](https://certbot.eff.org). This\nplugin uses the PowerDNS HTTP API to request modifications for the DNS-01\nchallenge.\n\nA design goal of this plugin is to use the minimal amount of custom code to\nachieve integration with PowerDNS.\n\nAs such it uses the existing Lexicon-based DNS framework in Certbot and may not\nwork for you if you are using intermediary tools, such as PowerDNS-Admin or a\nrestrictively configured reverse proxy, to implement access restrictions or\nRole-based Access controls (RBAC).\n\n## Installation\n\n1. Install the plugin from PyPI\n\n   ```shell\n   pip install certbot-dns-pdns\n   ```\n\n   Alternatively you can also install both certbot and the plugin using `pipx`:\n\n   ```shell\n   pipx install certbot certbot-dns-pdns\n   ```\n\n2. Verify that the plugin is installed:\n\n   ```shell\n   $ certbot plugins\n\n   - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -\n   * dns-pdns\n   Description: Obtain certificates using a DNS TXT record (if you are using\n   PowerDNS for DNS).\n   Interfaces: Authenticator, Plugin\n   Entry point: EntryPoint(name='dns-pdns',\n   value='certbot_dns_pdns.dns_pdns:Authenticator', group='certbot.plugins')\n\n   [...]\n   ```\n\n## Usage\n\nCreate a credentials file to use with this plugin:\n\n`~/pdns-credentials.ini`\n\n```ini\ndns_pdns_endpoint = https://pdns-api.example.com\ndns_pdns_api_key = \u003cYour API Key\u003e\ndns_pdns_server_id = localhost # see https://doc.powerdns.com/authoritative/http-api/server.html\ndns_pdns_disable_notify = false # Disable notification of secondaries after record changes\n```\n\nThe available configuration options correspond to the\n[DNS-Lexicon settings for the PowerDNS provider](https://dns-lexicon.readthedocs.io/en/latest/configuration_reference.html#powerdns).\n\nRun Certbot using the plugin as the authenticator:\n\n```shell\ncertbot certonly \\\n    --authenticator dns-pdns \\\n    --dns-pdns-credentials ~/pdns-credentials.ini \\\n    ...\n```\n\n\u003e [!NOTE]\n\u003e\n\u003e Since this plugin communicates with PowerDNS via the HTTP API make sure that\n\u003e the `SOA-EDIT-API` setting for your zone is set to a value that results in an\n\u003e increase of the SOA serial (i.e. the setting exists in your domain metadata).\n\u003e Otherwise the changes made to the zone by this plugin will not propagate to\n\u003e any secondaries you may have configured, causing the certificate challenge to\n\u003e potentially fail.\n\u003e\n\u003e For more information see the\n\u003e [PowerDNS documentation](https://doc.powerdns.com/authoritative/domainmetadata.html#soa-edit-api)\n\n## Contributing\n\nPull requests are welcome. GitHub automatically runs `pre-commit` on any pull\nrequests, so you may want to enable `pre-commit` on your end, so your PR doesn't\nfail these checks.\n\nThis repository uses [Conventional Commits](https://www.conventionalcommits.org)\ncommit messages. Check the git log for examples on how to use them.\n\n## License\n\nApache License 2.0\n\n## Maintainer\n\n- Felix Kaechele \u003cfelix@kaechele.ca\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaechele%2Fcertbot-dns-pdns","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkaechele%2Fcertbot-dns-pdns","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaechele%2Fcertbot-dns-pdns/lists"}