mirror of
https://github.com/acmesh-official/acme.sh.git
synced 2025-07-03 18:22:44 +00:00
Add instructions on how to use the Knot DNS API
This commit is contained in:
parent
7004ed9146
commit
0f96bcc1f4
@ -305,6 +305,52 @@ Note that you cannot use acme.sh automatic DNS validation for FreeDNS public dom
|
|||||||
you create under a FreeDNS public domain. You must own the top level domain in order to automaitcally
|
you create under a FreeDNS public domain. You must own the top level domain in order to automaitcally
|
||||||
validate with acme.sh at FreeDNS.
|
validate with acme.sh at FreeDNS.
|
||||||
|
|
||||||
|
## 16. Use Knot (knsupdate) DNS API to automatically issue cert
|
||||||
|
|
||||||
|
First, generate a TSIG key for updating the zone.
|
||||||
|
|
||||||
|
```
|
||||||
|
keymgr tsig generate acme_key algorithm hmac-sha512 > /etc/knot/acme.key
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
Include this key in your knot configuration file.
|
||||||
|
|
||||||
|
```
|
||||||
|
include: /etc/knot/acme.key
|
||||||
|
```
|
||||||
|
|
||||||
|
Next, configure your zone to allow dynamic updates.
|
||||||
|
|
||||||
|
Dynamic updates for the zone are allowed via proper ACL rule with the `update` action. For in-depth instructions, please see [Knot DNS's documentation](https://www.knot-dns.cz/documentation/).
|
||||||
|
|
||||||
|
```
|
||||||
|
acl:
|
||||||
|
- id: acme_acl
|
||||||
|
address: 192.168.1.0/24
|
||||||
|
key: acme_key
|
||||||
|
action: update
|
||||||
|
|
||||||
|
zone:
|
||||||
|
- domain: example.com
|
||||||
|
file: example.com.zone
|
||||||
|
acl: acme_acl
|
||||||
|
```
|
||||||
|
|
||||||
|
Finally, make the DNS server and TSIG Key available to `acme.sh`
|
||||||
|
|
||||||
|
```
|
||||||
|
export KNOT_SERVER="dns.example.com"
|
||||||
|
export KNOT_KEY=`grep \# /etc/knot/acme.key | cut -d' ' -f2`
|
||||||
|
```
|
||||||
|
|
||||||
|
Ok, let's issue a cert now:
|
||||||
|
```
|
||||||
|
acme.sh --issue --dns dns_knot -d example.com -d www.example.com
|
||||||
|
```
|
||||||
|
|
||||||
|
The `KNOT_SERVER` and `KNOT_KEY` settings will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
||||||
|
|
||||||
# Use custom API
|
# Use custom API
|
||||||
|
|
||||||
If your API is not supported yet, you can write your own DNS API.
|
If your API is not supported yet, you can write your own DNS API.
|
||||||
|
Loading…
x
Reference in New Issue
Block a user