{"id":15574561,"url":"https://github.com/runfalk/certbot-dns-loopia","last_synced_at":"2025-09-05T08:33:15.316Z","repository":{"id":37231771,"uuid":"72698658","full_name":"runfalk/certbot-dns-loopia","owner":"runfalk","description":"Loopia DNS authentication plugin for Certbot","archived":false,"fork":false,"pushed_at":"2022-06-20T08:21:28.000Z","size":51,"stargazers_count":37,"open_issues_count":7,"forks_count":11,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-12-30T01:41:56.553Z","etag":null,"topics":["letsencrypt","letsencrypt-plugin","loopia","maintainer-wanted","ssl","unmaintained"],"latest_commit_sha":null,"homepage":null,"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.md","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":"2016-11-03T01:57:10.000Z","updated_at":"2024-10-16T14:02:45.000Z","dependencies_parsed_at":"2022-06-21T22:04:45.444Z","dependency_job_id":null,"html_url":"https://github.com/runfalk/certbot-dns-loopia","commit_stats":null,"previous_names":["runfalk/certbot-loopia"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runfalk%2Fcertbot-dns-loopia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runfalk%2Fcertbot-dns-loopia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runfalk%2Fcertbot-dns-loopia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runfalk%2Fcertbot-dns-loopia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/runfalk","download_url":"https://codeload.github.com/runfalk/certbot-dns-loopia/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":232032124,"owners_count":18462972,"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","loopia","maintainer-wanted","ssl","unmaintained"],"created_at":"2024-10-02T18:19:10.300Z","updated_at":"2024-12-31T22:13:34.250Z","avatar_url":"https://github.com/runfalk.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Test](https://github.com/runfalk/certbot-dns-loopia/actions/workflows/test.yml/badge.svg)\n\n# Loopia DNS Authenticator for Certbot\n\n\nThis allows automatic completion of\n[Certbot's](https://github.com/certbot/certbot) DNS01 challenge for\ndomains managed on [Loopia](https://www.loopia.se/) DNS.\n\n## Installing\n\n```shell\n$ sudo pip install certbot-dns-loopia\n```\n\nNote that you should normally install this as `root`, unless you know\nwhat you are doing.\n\n## Preconditions\n\n### Loopia API user \n\nThe plugin requires the following permissions enabled for your Loopia API user:\n\n- `addZoneRecord`\n- `getZoneRecords`\n- `removeSubdomain`\n- `removeZoneRecord`\n\n### Credentials file\n\nAn INI file with `user` and `password` for your Loopia API user needs to be created. `user`\nnormally has the format `user@loopiaapi`.\n\nThe credentials file must have the following format:\n\n```INI\ndns_loopia_user = user@loopiaapi\ndns_loopia_password = passwordgoeshere\n```\n\nFor safety reasons the file must not be world readable. You can solve\nthis by running:\n\n```shell\n$ chmod 600 credentials.ini\n```\n\n\n## Usage\n\n### Parameters\n\nWhen using `certbot` with `certbot-dns-loopia`, aside from the usual parameters accepted by `certbot`, the following\nparameters may be used:\n\n| Parameter                                   | Required?                  | Default | Description      |\n|---------------------------------------------|----------------------------|---------|-------------------|\n|`--dns-loopia-credentials \u003cpath\u003e`            | :heavy_check_mark:️         | -       | The path of the INI file containing your Loopia API user credentials |\n|`--dns-loopia-propagation-seconds \u003cseconds\u003e` |                            | 900     |  Determines how many seconds to wait before contacting the ACME server after adding the zone record to Loopia DNS\n\n### Examples\n\nTo obtain a certificate for `domain.com`, run `certbot` using:\n\n```shell\n$ sudo certbot certonly \\\n    --authenticator dns-loopia \\\n    --dns-loopia-credentials credentials.ini \\\n    -d domain.com\n```\n\nTo obtain a wildcard certificate for all subdomains of `domain.com`:\n\n```shell\n$ sudo certbot certonly \\\n    --authenticator dns-loopia \\\n    --dns-loopia-credentials credentials.ini \\\n    -d *.domain.com\n```\n\nTo obtain a certificate valid for multiple domains using [SAN](https://en.wikipedia.org/wiki/Subject_Alternative_Name),\nin this example for `foo.com` and `bar.com`:\n```shell\n$ sudo certbot certonly \\\n    --authenticator dns-loopia \\\n    --dns-loopia-credentials credentials.ini \\\n    -d foo.com \\\n    -d bar.com\n```\n\n## Known issues\n\n- Due to caching on Loopia's side it can take up to 15 minutes before\n  changes propagate. Therefore, the plugin will wait 15 minutes before\n  contacting the ACME server.\n\n  It has been known to work with as little as 90 seconds and sometimes\n  less. If you want to try something other than 15 minutes, use\n  `--dns-loopia-propagation-seconds 90` for 90 seconds\n  or however many seconds you want.\n\nContributing\n------------\n\nHow to set up a dev environment, test and publish new versions of the\nproject is described on the [DEVELOP page](DEVELOP.md).\n\nDisclaimer\n----------\n\nThis plugin is neither affiliated with nor endorsed by Loopia AB.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frunfalk%2Fcertbot-dns-loopia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frunfalk%2Fcertbot-dns-loopia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frunfalk%2Fcertbot-dns-loopia/lists"}