https://github.com/daskol/certbot-dns-yandex
Yandex DNS Authenticator plugin for Certbot
https://github.com/daskol/certbot-dns-yandex
acme certbot certbot-dns certbot-dns-authenticator certbot-dns-plugin yandex-dns yandex-pdd
Last synced: 11 months ago
JSON representation
Yandex DNS Authenticator plugin for Certbot
- Host: GitHub
- URL: https://github.com/daskol/certbot-dns-yandex
- Owner: daskol
- License: apache-2.0
- Created: 2021-01-02T18:57:06.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-11-29T19:25:50.000Z (over 4 years ago)
- Last Synced: 2025-04-08T15:49:24.651Z (about 1 year ago)
- Topics: acme, certbot, certbot-dns, certbot-dns-authenticator, certbot-dns-plugin, yandex-dns, yandex-pdd
- Language: Python
- Homepage:
- Size: 15.6 KB
- Stars: 10
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Certbot Plugin: Yandex DNS
*Yandex DNS Authenticator plugin for Certbot*
## Overview
Package provide certbot authenticator plugin for Yandex DNS (aka PDD) which
allows to perform dns-01 probe. This kind of challange is the only way for now
to issue wildcard certificates with certbot.
NOTE This plugin will not be requested to merge in certbot repo until like
issues [certbot/certbot][1][\#6464][6464], [certbot/certbot][1][\#6503][6503],
and [certbot/certbot][1][\#6504][6504] are solved first.
### Installation
The easies way to install plugin is insllation the plugin directly from git
with PIP.
```bash
pip install git+https://github.com/daskol/certbot-dns-yandex.git
```
### Usage
There is nothing special to use the plugin for certificate management.
Essentially, the only things one should do is explicitely specify authenticator
with option `-a` of certbot. Credentials to plugin could be passed either with
CLI option `--dns-yandex-token` or environment variable `YANDEX_PDD_TOKEN`.
The env variable has higher priority then CLI option. See example below.
```bash
export YANDEX_PDD_TOKEN=
certbot certonly -a dns-yandex --dns-yandex-token ...
```
### CLI
The package provides CLI `yandex-dns` for management DNS records in Yandex DNS
from shell as well. As soon as the package installed one can list, add, or
remove DNS records (several examples below).
```bash
# List DNS records for a domain.
yandex-dns ls example.org
# Remove domain by DNS record ID for a domain.
yandex-dns rm example.org 31513386
# Add TXT record to DNS for a domain.
yandex-dns add example.org TXT "Hello, world!" --subdomain greeting
```
[1]: https://github.com/certbot/certbot
[6464]: https://github.com/certbot/certbot/issues/6464
[6503]: https://github.com/certbot/certbot/issues/6503
[6504]: https://github.com/certbot/certbot/issues/6504