acme.sh/dnsapi/README.md

119 lines
2.7 KiB
Markdown
Raw Normal View History

2016-02-07 10:29:28 +00:00
# How to use dns api
## Use CloudFlare domain api to automatically issue cert
For now, we support clourflare integeration.
First you need to login to your clourflare account to get your api key.
```
export CF_Key="sdfsdfsdfljlbjkljlkjsdfoiwje"
export CF_Email="xxxx@sss.com"
```
Ok, let's issue cert now:
```
2016-06-03 10:12:34 +00:00
acme.sh --issue --dns dns_cf -d aa.com -d www.aa.com
2016-02-07 10:29:28 +00:00
```
2016-05-11 05:27:33 +00:00
The `CF_Key` and `CF_Email` will be saved in `~/.acme.sh/account.conf`, when next time you use cloudflare api, it will reuse this key.
2016-02-07 10:29:28 +00:00
## Use Dnspod.cn domain api to automatically issue cert
For now, we support dnspod.cn integeration.
First you need to login to your dnspod.cn account to get your api key and key id.
```
export DP_Id="1234"
export DP_Key="sADDsdasdgdsf"
```
Ok, let's issue cert now:
```
2016-06-03 10:12:34 +00:00
acme.sh --issue --dns dns_dp -d aa.com -d www.aa.com
2016-02-07 10:29:28 +00:00
```
2016-05-11 05:27:33 +00:00
The `DP_Id` and `DP_Key` will be saved in `~/.acme.sh/account.conf`, when next time you use dnspod.cn api, it will reuse this key.
2016-02-07 10:29:28 +00:00
## Use Cloudxns.com domain api to automatically issue cert
For now, we support Cloudxns.com integeration.
First you need to login to your Cloudxns.com account to get your api key and key secret.
```
export CX_Key="1234"
2016-02-07 12:14:53 +00:00
export CX_Secret="sADDsdasdgdsf"
2016-02-07 10:29:28 +00:00
```
Ok, let's issue cert now:
```
2016-06-03 10:12:34 +00:00
acme.sh --issue --dns dns_cx -d aa.com -d www.aa.com
2016-02-07 10:29:28 +00:00
```
2016-05-11 05:27:33 +00:00
The `CX_Key` and `CX_Secret` will be saved in `~/.acme.sh/account.conf`, when next time you use Cloudxns.com api, it will reuse this key.
2016-02-07 10:29:28 +00:00
2016-07-29 10:07:16 +00:00
## Use Godaddy.com domain api to automatically issue cert
We support Godaddy integeration.
First you need to login to your Godaddy account to get your api key and api secret.
https://developer.godaddy.com/keys/
Please Create a Production key, instead of a Test key.
```
export GD_Key="sdfsdfsdfljlbjkljlkjsdfoiwje"
export GD_Secret="asdfsdafdsfdsfdsfdsfdsafd"
```
Ok, let's issue cert now:
```
acme.sh --issue --dns dns_gd -d aa.com -d www.aa.com
```
The `GD_Key` and `GD_Secret` will be saved in `~/.acme.sh/account.conf`, when next time you use cloudflare api, it will reuse this key.
2016-08-25 03:03:25 +00:00
## Use OVH/kimsufi/soyoustart/runabove API
2016-07-29 10:07:16 +00:00
2016-08-25 03:03:25 +00:00
https://github.com/Neilpang/acme.sh/wiki/How-to-use-OVH-domain-api
2016-02-07 10:29:28 +00:00
# Use custom api
If your api is not supported yet, you can write your own dns api.
Let's assume you want to name it 'myapi',
2016-05-11 05:27:33 +00:00
1. Create a bash script named `~/.acme.sh/dns_myapi.sh`,
2. In the script, you must have a function named `dns_myapi_add()`. Which will be called by acme.sh to add dns records.
2016-02-07 10:29:28 +00:00
3. Then you can use your api to issue cert like:
```
2016-06-03 10:12:34 +00:00
acme.sh --issue --dns dns_myapi -d aa.com -d www.aa.com
2016-02-07 10:29:28 +00:00
```
For more details, please check our sample script: [dns_myapi.sh](dns_myapi.sh)
2016-02-07 10:29:28 +00:00
2016-05-08 13:47:37 +00:00
# Use lexicon dns api
https://github.com/Neilpang/acme.sh/wiki/How-to-use-lexicon-dns-api
2016-02-07 10:29:28 +00:00