support cloudxns.com api

This commit is contained in:
neil
2016-02-07 18:26:12 +08:00
parent ce56c1bbfc
commit 0809486529
4 changed files with 253 additions and 60 deletions

View File

@@ -163,69 +163,21 @@ le renew aa.com
Ok, it's finished.
#Automatic dns api integeration
# Use CloudFlare domain api to automatically issue cert
If your dns provider support api access, we can use api to automatically issue certs.
You don't have do anything manually.
For now, we support clourflare integeration.
Current we support:
## Cloudflare.com api
## Dnspod.cn api
## Cloudxns.com api
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:
```
le.sh issue dns-cf aa.com www.aa.com
```
The `CF_Key` and `CF_Email` will be saved in `~/.le/account.conf`, when next time you use cloudflare api, it will reuse this key.
More api integerations are coming. Godaddy, etc....
# 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:
```
le.sh issue dns-dp aa.com www.aa.com
```
The `DP_Id` and `DP_Key` will be saved in `~/.le/account.conf`, when next time you use dnspod.cn api, it will reuse this key.
# 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',
1. Create a bash script named `~/.le/dns-myapi.sh`,
2. In the scrypt, you must have a function named `dns-myapi-add()`. Which will be called by le.sh to add dns records.
3. Then you can use your api to issue cert like:
```
le.sh issue dns-myapi aa.com www.aa.com
```
For more details, please check our sample script: `dnsapi/dns-myapi.sh`
More apis are comming soon....
##If your dns provider is not in the supported list above, you write your own script api easily.
For more details: [How to use dns api](/Neilpang/le/blob/master/dnsapi/README.md)
#Under the Hood