1353 lines
38 KiB
Markdown
1353 lines
38 KiB
Markdown
# How to use DNS API
|
|
|
|
If your dns provider doesn't provide api access, you can use our dns alias mode:
|
|
|
|
https://github.com/Neilpang/acme.sh/wiki/DNS-alias-mode
|
|
|
|
## 1. Use CloudFlare domain API to automatically issue cert
|
|
|
|
First you need to login to your CloudFlare account to get your [API key](https://dash.cloudflare.com/profile).
|
|
|
|
```
|
|
export CF_Key="sdfsdfsdfljlbjkljlkjsdfoiwje"
|
|
export CF_Email="xxxx@sss.com"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_cf -d example.com -d www.example.com
|
|
```
|
|
|
|
The `CF_Key` and `CF_Email` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
|
|
## 2. Use DNSPod.cn domain API to automatically issue cert
|
|
|
|
First you need to login to your DNSPod account to get your API Key and ID.
|
|
|
|
```
|
|
export DP_Id="1234"
|
|
export DP_Key="sADDsdasdgdsf"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_dp -d example.com -d www.example.com
|
|
```
|
|
|
|
The `DP_Id` and `DP_Key` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
|
|
## 3. Use CloudXNS.com domain API to automatically issue cert
|
|
|
|
First you need to login to your CloudXNS account to get your API Key and Secret.
|
|
|
|
```
|
|
export CX_Key="1234"
|
|
export CX_Secret="sADDsdasdgdsf"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_cx -d example.com -d www.example.com
|
|
```
|
|
|
|
The `CX_Key` and `CX_Secret` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
|
|
## 4. Use GoDaddy.com domain API to automatically issue cert
|
|
|
|
First you need to login to your GoDaddy account to get your API Key and 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 a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_gd -d example.com -d www.example.com
|
|
```
|
|
|
|
The `GD_Key` and `GD_Secret` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
|
|
## 5. Use PowerDNS embedded API to automatically issue cert
|
|
|
|
First you need to login to your PowerDNS account to enable the API and set your API-Token in the configuration.
|
|
|
|
https://doc.powerdns.com/md/httpapi/README/
|
|
|
|
```
|
|
export PDNS_Url="http://ns.example.com:8081"
|
|
export PDNS_ServerId="localhost"
|
|
export PDNS_Token="0123456789ABCDEF"
|
|
export PDNS_Ttl=60
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_pdns -d example.com -d www.example.com
|
|
```
|
|
|
|
The `PDNS_Url`, `PDNS_ServerId`, `PDNS_Token` and `PDNS_Ttl` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
|
|
## 6. Use OVH/kimsufi/soyoustart/runabove API to automatically issue cert
|
|
|
|
https://github.com/Neilpang/acme.sh/wiki/How-to-use-OVH-domain-api
|
|
|
|
|
|
## 7. Use nsupdate to automatically issue cert
|
|
|
|
First, generate a key for updating the zone
|
|
```
|
|
b=$(dnssec-keygen -a hmac-sha512 -b 512 -n USER -K /tmp foo)
|
|
cat > /etc/named/keys/update.key <<EOF
|
|
key "update" {
|
|
algorithm hmac-sha512;
|
|
secret "$(awk '/^Key/{print $2}' /tmp/$b.private)";
|
|
};
|
|
EOF
|
|
rm -f /tmp/$b.{private,key}
|
|
```
|
|
|
|
Include this key in your named configuration
|
|
```
|
|
include "/etc/named/keys/update.key";
|
|
```
|
|
|
|
Next, configure your zone to allow dynamic updates.
|
|
|
|
Depending on your named version, use either
|
|
```
|
|
zone "example.com" {
|
|
type master;
|
|
allow-update { key "update"; };
|
|
};
|
|
```
|
|
or
|
|
```
|
|
zone "example.com" {
|
|
type master;
|
|
update-policy {
|
|
grant update subdomain example.com.;
|
|
};
|
|
}
|
|
```
|
|
|
|
Finally, make the DNS server and update Key available to `acme.sh`
|
|
|
|
```
|
|
export NSUPDATE_SERVER="dns.example.com"
|
|
export NSUPDATE_KEY="/path/to/your/nsupdate.key"
|
|
```
|
|
and optionally (depending on DNS server)
|
|
```
|
|
export NSUPDATE_ZONE="example.com"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_nsupdate -d example.com -d www.example.com
|
|
```
|
|
|
|
The `NSUPDATE_SERVER`, `NSUPDATE_KEY`, and `NSUPDATE_ZONE` settings will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
|
|
## 8. Use LuaDNS domain API
|
|
|
|
Get your API token at https://api.luadns.com/settings
|
|
|
|
```
|
|
export LUA_Key="sdfsdfsdfljlbjkljlkjsdfoiwje"
|
|
export LUA_Email="xxxx@sss.com"
|
|
```
|
|
|
|
To issue a cert:
|
|
```
|
|
acme.sh --issue --dns dns_lua -d example.com -d www.example.com
|
|
```
|
|
|
|
The `LUA_Key` and `LUA_Email` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
|
|
## 9. Use DNSMadeEasy domain API
|
|
|
|
Get your API credentials at https://cp.dnsmadeeasy.com/account/info
|
|
|
|
```
|
|
export ME_Key="sdfsdfsdfljlbjkljlkjsdfoiwje"
|
|
export ME_Secret="qdfqsdfkjdskfj"
|
|
```
|
|
|
|
To issue a cert:
|
|
```
|
|
acme.sh --issue --dns dns_me -d example.com -d www.example.com
|
|
```
|
|
|
|
The `ME_Key` and `ME_Secret` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
|
|
## 10. Use Amazon Route53 domain API
|
|
|
|
https://github.com/Neilpang/acme.sh/wiki/How-to-use-Amazon-Route53-API
|
|
|
|
```
|
|
export AWS_ACCESS_KEY_ID=XXXXXXXXXX
|
|
export AWS_SECRET_ACCESS_KEY=XXXXXXXXXXXXXXX
|
|
```
|
|
|
|
To issue a cert:
|
|
```
|
|
acme.sh --issue --dns dns_aws -d example.com -d www.example.com
|
|
```
|
|
|
|
The `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 11. Use Aliyun domain API to automatically issue cert
|
|
|
|
First you need to login to your Aliyun account to get your API key.
|
|
[https://ak-console.aliyun.com/#/accesskey](https://ak-console.aliyun.com/#/accesskey)
|
|
|
|
```
|
|
export Ali_Key="sdfsdfsdfljlbjkljlkjsdfoiwje"
|
|
export Ali_Secret="jlsdflanljkljlfdsaklkjflsa"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_ali -d example.com -d www.example.com
|
|
```
|
|
|
|
The `Ali_Key` and `Ali_Secret` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 12. Use ISPConfig 3.1 API
|
|
|
|
This only works for ISPConfig 3.1 (and newer).
|
|
|
|
Create a Remote User in the ISPConfig Control Panel. The Remote User must have access to at least `DNS zone functions` and `DNS txt functions`.
|
|
|
|
```
|
|
export ISPC_User="xxx"
|
|
export ISPC_Password="xxx"
|
|
export ISPC_Api="https://ispc.domain.tld:8080/remote/json.php"
|
|
export ISPC_Api_Insecure=1
|
|
```
|
|
If you have installed ISPConfig on a different port, then alter the 8080 accordingly.
|
|
Leaver ISPC_Api_Insecure set to 1 if you have not a valid ssl cert for your installation. Change it to 0 if you have a valid ssl cert.
|
|
|
|
To issue a cert:
|
|
```
|
|
acme.sh --issue --dns dns_ispconfig -d example.com -d www.example.com
|
|
```
|
|
|
|
The `ISPC_User`, `ISPC_Password`, `ISPC_Api`and `ISPC_Api_Insecure` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 13. Use Alwaysdata domain API
|
|
|
|
First you need to login to your Alwaysdata account to get your API Key.
|
|
|
|
```sh
|
|
export AD_API_KEY="myalwaysdataapikey"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
|
|
```sh
|
|
acme.sh --issue --dns dns_ad -d example.com -d www.example.com
|
|
```
|
|
|
|
The `AD_API_KEY` will be saved in `~/.acme.sh/account.conf` and will be reused
|
|
when needed.
|
|
|
|
## 14. Use Linode domain API
|
|
|
|
The tokens created in the classic manager and cloud manager are incompatible
|
|
with one another. While the classic manager makes an all or nothing API, the
|
|
newer cloud manager interface promises to produce API keys with a finer
|
|
permission system. However, either way works just fine.
|
|
|
|
### Classic Manager ###
|
|
|
|
Classic Manager: https://manager.linode.com/profile/api
|
|
|
|
First you need to login to your Linode account to get your API Key.
|
|
|
|
Then add an API key with label *ACME* and copy the new key into the following
|
|
command.
|
|
|
|
```sh
|
|
export LINODE_API_KEY="..."
|
|
```
|
|
|
|
Due to the reload time of any changes in the DNS records, we have to use the
|
|
`dnssleep` option to wait at least 15 minutes for the changes to take effect.
|
|
|
|
Ok, let's issue a cert now:
|
|
|
|
```sh
|
|
acme.sh --issue --dns dns_linode --dnssleep 900 -d example.com -d www.example.com
|
|
```
|
|
|
|
The `LINODE_API_KEY` will be saved in `~/.acme.sh/account.conf` and will be
|
|
reused when needed.
|
|
|
|
### Cloud Manager ###
|
|
|
|
Cloud Manager: https://cloud.linode.com/profile/tokens
|
|
|
|
First you need to login to your Linode account to get your API Key.
|
|
|
|
1. Click on "Add a Personal Access Token".
|
|
2. Give the new key a "Label" (we recommend *ACME*)
|
|
3. Give it Read/Write access to "Domains"
|
|
4. "Submit" and copy the new key into the `LINODE_V4_API_KEY` command below.
|
|
|
|
```sh
|
|
export LINODE_V4_API_KEY="..."
|
|
```
|
|
|
|
Due to the reload time of any changes in the DNS records, we have to use the
|
|
`dnssleep` option to wait at least 15 minutes for the changes to take effect.
|
|
|
|
Ok, let's issue a cert now:
|
|
|
|
```sh
|
|
acme.sh --issue --dns dns_linode_v4 --dnssleep 900 -d example.com -d www.example.com
|
|
```
|
|
|
|
The `LINODE_V4_API_KEY` will be saved in `~/.acme.sh/account.conf` and will be
|
|
reused when needed.
|
|
|
|
## 15. Use FreeDNS
|
|
|
|
FreeDNS (https://freedns.afraid.org/) does not provide an API to update DNS records (other than IPv4 and IPv6
|
|
dynamic DNS addresses). The acme.sh plugin therefore retrieves and updates domain TXT records by logging
|
|
into the FreeDNS website to read the HTML and posting updates as HTTP. The plugin needs to know your
|
|
userid and password for the FreeDNS website.
|
|
|
|
```sh
|
|
export FREEDNS_User="..."
|
|
export FREEDNS_Password="..."
|
|
```
|
|
|
|
You need only provide this the first time you run the acme.sh client with FreeDNS validation and then again
|
|
whenever you change your password at the FreeDNS site. The acme.sh FreeDNS plugin does not store your userid
|
|
or password but rather saves an authentication token returned by FreeDNS in `~/.acme.sh/account.conf` and
|
|
reuses that when needed.
|
|
|
|
Now you can issue a certificate.
|
|
|
|
```sh
|
|
acme.sh --issue --dns dns_freedns -d example.com -d www.example.com
|
|
```
|
|
|
|
Note that you cannot use acme.sh automatic DNS validation for FreeDNS public domains or for a subdomain that
|
|
you create under a FreeDNS public domain. You must own the top level domain in order to automatically
|
|
validate with acme.sh at FreeDNS.
|
|
|
|
## 16. Use cyon.ch
|
|
|
|
You only need to set your cyon.ch login credentials.
|
|
If you also have 2 Factor Authentication (OTP) enabled, you need to set your secret token too and have `oathtool` installed.
|
|
|
|
```
|
|
export CY_Username="your_cyon_username"
|
|
export CY_Password="your_cyon_password"
|
|
export CY_OTP_Secret="your_otp_secret" # Only required if using 2FA
|
|
```
|
|
|
|
To issue a cert:
|
|
```
|
|
acme.sh --issue --dns dns_cyon -d example.com -d www.example.com
|
|
```
|
|
|
|
The `CY_Username`, `CY_Password` and `CY_OTP_Secret` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 17. Use Domain-Offensive/Resellerinterface/Domainrobot API
|
|
|
|
ATTENTION: You need to be a registered Reseller to be able to use the ResellerInterface. As a normal user you can not use this method.
|
|
|
|
You will need your login credentials (Partner ID+Password) to the Resellerinterface, and export them before you run `acme.sh`:
|
|
```
|
|
export DO_PID="KD-1234567"
|
|
export DO_PW="cdfkjl3n2"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_do -d example.com -d www.example.com
|
|
```
|
|
|
|
## 18. Use Gandi LiveDNS API
|
|
|
|
You must enable the new Gandi LiveDNS API first and the create your api key, See: http://doc.livedns.gandi.net/
|
|
|
|
```
|
|
export GANDI_LIVEDNS_KEY="fdmlfsdklmfdkmqsdfk"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_gandi_livedns -d example.com -d www.example.com
|
|
```
|
|
|
|
## 19. Use Knot (knsupdate) DNS API to automatically issue cert
|
|
|
|
First, generate a TSIG key for updating the zone.
|
|
|
|
```
|
|
keymgr tsig generate -t acme_key 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.
|
|
|
|
## 20. Use DigitalOcean API (native)
|
|
|
|
You need to obtain a read and write capable API key from your DigitalOcean account. See: https://www.digitalocean.com/help/api/
|
|
|
|
```
|
|
export DO_API_KEY="75310dc4ca779ac39a19f6355db573b49ce92ae126553ebd61ac3a3ae34834cc"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_dgon -d example.com -d www.example.com
|
|
```
|
|
|
|
## 21. Use ClouDNS.net API
|
|
|
|
You need to set the HTTP API user ID and password credentials. See: https://www.cloudns.net/wiki/article/42/. For security reasons, it's recommended to use a sub user ID that only has access to the necessary zones, as a regular API user has access to your entire account.
|
|
|
|
```
|
|
# Use this for a sub auth ID
|
|
export CLOUDNS_SUB_AUTH_ID=XXXXX
|
|
# Use this for a regular auth ID
|
|
#export CLOUDNS_AUTH_ID=XXXXX
|
|
export CLOUDNS_AUTH_PASSWORD="YYYYYYYYY"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_cloudns -d example.com -d www.example.com
|
|
```
|
|
The `CLOUDNS_AUTH_ID` and `CLOUDNS_AUTH_PASSWORD` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 22. Use Infoblox API
|
|
|
|
First you need to create/obtain API credentials on your Infoblox appliance.
|
|
|
|
```
|
|
export Infoblox_Creds="username:password"
|
|
export Infoblox_Server="ip or fqdn of infoblox appliance"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_infoblox -d example.com -d www.example.com
|
|
```
|
|
|
|
Note: This script will automatically create and delete the ephemeral txt record.
|
|
The `Infoblox_Creds` and `Infoblox_Server` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
|
|
## 23. Use VSCALE API
|
|
|
|
First you need to create/obtain API tokens on your [settings panel](https://vscale.io/panel/settings/tokens/).
|
|
|
|
```
|
|
export VSCALE_API_KEY="sdfsdfsdfljlbjkljlkjsdfoiwje"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_vscale -d example.com -d www.example.com
|
|
```
|
|
|
|
## 24. Use Dynu API
|
|
|
|
First you need to create/obtain API credentials from your Dynu account. See: https://www.dynu.com/resources/api/documentation
|
|
|
|
```
|
|
export Dynu_ClientId="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
|
export Dynu_Secret="yyyyyyyyyyyyyyyyyyyyyyyyy"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_dynu -d example.com -d www.example.com
|
|
```
|
|
|
|
The `Dynu_ClientId` and `Dynu_Secret` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 25. Use DNSimple API
|
|
|
|
First you need to login to your DNSimple account and generate a new oauth token.
|
|
|
|
https://dnsimple.com/a/{your account id}/account/access_tokens
|
|
|
|
Note that this is an _account_ token and not a user token. The account token is
|
|
needed to infer the `account_id` used in requests. A user token will not be able
|
|
to determine the correct account to use.
|
|
|
|
```
|
|
export DNSimple_OAUTH_TOKEN="sdfsdfsdfljlbjkljlkjsdfoiwje"
|
|
```
|
|
|
|
To issue the cert just specify the `dns_dnsimple` API.
|
|
|
|
```
|
|
acme.sh --issue --dns dns_dnsimple -d example.com
|
|
```
|
|
|
|
The `DNSimple_OAUTH_TOKEN` will be saved in `~/.acme.sh/account.conf` and will
|
|
be reused when needed.
|
|
|
|
If you have any issues with this integration please report them to
|
|
https://github.com/pho3nixf1re/acme.sh/issues.
|
|
|
|
## 26. Use NS1.com API
|
|
|
|
```
|
|
export NS1_Key="fdmlfsdklmfdkmqsdfk"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_nsone -d example.com -d www.example.com
|
|
```
|
|
|
|
## 27. Use DuckDNS.org API
|
|
|
|
```
|
|
export DuckDNS_Token="aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
|
|
```
|
|
|
|
Please note that since DuckDNS uses StartSSL as their cert provider, thus
|
|
--insecure may need to be used when issuing certs:
|
|
```
|
|
acme.sh --insecure --issue --dns dns_duckdns -d mydomain.duckdns.org
|
|
```
|
|
|
|
For issues, please report to https://github.com/raidenii/acme.sh/issues.
|
|
|
|
## 28. Use Name.com API
|
|
|
|
Create your API token here: https://www.name.com/account/settings/api
|
|
|
|
Note: `Namecom_Username` should be your Name.com username and not the token name. If you accidentally run the script with the token name as the username see `~/.acme.sh/account.conf` to fix the issue
|
|
|
|
```
|
|
export Namecom_Username="testuser"
|
|
export Namecom_Token="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
|
|
```
|
|
|
|
And now you can issue certs with:
|
|
|
|
```
|
|
acme.sh --issue --dns dns_namecom -d example.com -d www.example.com
|
|
```
|
|
|
|
For issues, please report to https://github.com/raidenii/acme.sh/issues.
|
|
|
|
## 29. Use Dyn Managed DNS API to automatically issue cert
|
|
|
|
First, login to your Dyn Managed DNS account: https://portal.dynect.net/login/
|
|
|
|
It is recommended to add a new user specific for API access.
|
|
|
|
The minimum "Zones & Records Permissions" required are:
|
|
```
|
|
RecordAdd
|
|
RecordUpdate
|
|
RecordDelete
|
|
RecordGet
|
|
ZoneGet
|
|
ZoneAddNode
|
|
ZoneRemoveNode
|
|
ZonePublish
|
|
```
|
|
|
|
Pass the API user credentials to the environment:
|
|
```
|
|
export DYN_Customer="customer"
|
|
export DYN_Username="apiuser"
|
|
export DYN_Password="secret"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_dyn -d example.com -d www.example.com
|
|
```
|
|
|
|
The `DYN_Customer`, `DYN_Username` and `DYN_Password` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 30. Use pdd.yandex.ru API
|
|
|
|
```
|
|
export PDD_Token="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
|
|
```
|
|
|
|
Follow these instructions to get the token for your domain https://tech.yandex.com/domain/doc/concepts/access-docpage/
|
|
```
|
|
acme.sh --issue --dns dns_yandex -d mydomain.example.org
|
|
```
|
|
|
|
For issues, please report to https://github.com/non7top/acme.sh/issues.
|
|
|
|
## 31. Use Hurricane Electric
|
|
|
|
Hurricane Electric (https://dns.he.net/) doesn't have an API so just set your login credentials like so:
|
|
|
|
```
|
|
export HE_Username="yourusername"
|
|
export HE_Password="password"
|
|
```
|
|
|
|
Then you can issue your certificate:
|
|
|
|
```
|
|
acme.sh --issue --dns dns_he -d example.com -d www.example.com
|
|
```
|
|
|
|
The `HE_Username` and `HE_Password` settings will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
Please report any issues to https://github.com/angel333/acme.sh or to <me@ondrejsimek.com>.
|
|
|
|
## 32. Use UnoEuro API to automatically issue cert
|
|
|
|
First you need to login to your UnoEuro account to get your API key.
|
|
|
|
```
|
|
export UNO_Key="sdfsdfsdfljlbjkljlkjsdfoiwje"
|
|
export UNO_User="UExxxxxx"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_unoeuro -d example.com -d www.example.com
|
|
```
|
|
|
|
The `UNO_Key` and `UNO_User` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 33. Use INWX
|
|
|
|
[INWX](https://www.inwx.de/) offers an [xmlrpc api](https://www.inwx.de/de/help/apidoc) with your standard login credentials, set them like so:
|
|
|
|
```
|
|
export INWX_User="yourusername"
|
|
export INWX_Password="password"
|
|
```
|
|
|
|
Then you can issue your certificates with:
|
|
|
|
```
|
|
acme.sh --issue --dns dns_inwx -d example.com -d www.example.com
|
|
```
|
|
|
|
The `INWX_User` and `INWX_Password` settings will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
If your account is secured by mobile tan you have also defined the shared secret.
|
|
|
|
```
|
|
export INWX_Shared_Secret="shared secret"
|
|
```
|
|
|
|
You may need to re-enable the mobile tan to gain the shared secret.
|
|
|
|
## 34. User Servercow API v1
|
|
|
|
Create a new user from the servercow control center. Don't forget to activate **DNS API** for this user.
|
|
|
|
```
|
|
export SERVERCOW_API_Username=username
|
|
export SERVERCOW_API_Password=password
|
|
```
|
|
|
|
Now you cann issue a cert:
|
|
|
|
```
|
|
acme.sh --issue --dns dns_servercow -d example.com -d www.example.com
|
|
```
|
|
Both, `SERVERCOW_API_Username` and `SERVERCOW_API_Password` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 35. Use Namesilo.com API
|
|
|
|
You'll need to generate an API key at https://www.namesilo.com/account_api.php
|
|
Optionally you may restrict the access to an IP range there.
|
|
|
|
```
|
|
export Namesilo_Key="xxxxxxxxxxxxxxxxxxxxxxxx"
|
|
```
|
|
|
|
And now you can issue certs with:
|
|
|
|
```
|
|
acme.sh --issue --dns dns_namesilo --dnssleep 900 -d example.com -d www.example.com
|
|
```
|
|
|
|
## 36. Use autoDNS (InternetX)
|
|
|
|
[InternetX](https://www.internetx.com/) offers an [xml api](https://help.internetx.com/display/API/AutoDNS+XML-API) with your standard login credentials, set them like so:
|
|
|
|
```
|
|
export AUTODNS_USER="yourusername"
|
|
export AUTODNS_PASSWORD="password"
|
|
export AUTODNS_CONTEXT="context"
|
|
```
|
|
|
|
Then you can issue your certificates with:
|
|
|
|
```
|
|
acme.sh --issue --dns dns_autodns -d example.com -d www.example.com
|
|
```
|
|
|
|
The `AUTODNS_USER`, `AUTODNS_PASSWORD` and `AUTODNS_CONTEXT` settings will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 37. Use Azure DNS
|
|
|
|
You have to create a service principal first. See:[How to use Azure DNS](../../../wiki/How-to-use-Azure-DNS)
|
|
|
|
```
|
|
export AZUREDNS_SUBSCRIPTIONID="12345678-9abc-def0-1234-567890abcdef"
|
|
export AZUREDNS_TENANTID="11111111-2222-3333-4444-555555555555"
|
|
export AZUREDNS_APPID="3b5033b5-7a66-43a5-b3b9-a36b9e7c25ed"
|
|
export AZUREDNS_CLIENTSECRET="1b0224ef-34d4-5af9-110f-77f527d561bd"
|
|
```
|
|
|
|
Then you can issue your certificates with:
|
|
|
|
```
|
|
acme.sh --issue --dns dns_azure -d example.com -d www.example.com
|
|
```
|
|
|
|
`AZUREDNS_SUBSCRIPTIONID`, `AZUREDNS_TENANTID`,`AZUREDNS_APPID` and `AZUREDNS_CLIENTSECRET` settings will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 38. Use selectel.com(selectel.ru) domain API to automatically issue cert
|
|
|
|
First you need to login to your account to get your API key from: https://my.selectel.ru/profile/apikeys.
|
|
|
|
```sh
|
|
export SL_Key="sdfsdfsdfljlbjkljlkjsdfoiwje"
|
|
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_selectel -d example.com -d www.example.com
|
|
```
|
|
|
|
The `SL_Key` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 39. Use zonomi.com domain API to automatically issue cert
|
|
|
|
First you need to login to your account to find your API key from: http://zonomi.com/app/dns/dyndns.jsp
|
|
|
|
Your will find your api key in the example urls:
|
|
|
|
```sh
|
|
https://zonomi.com/app/dns/dyndns.jsp?host=example.com&api_key=1063364558943540954358668888888888
|
|
```
|
|
|
|
```sh
|
|
export ZM_Key="1063364558943540954358668888888888"
|
|
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_zonomi -d example.com -d www.example.com
|
|
```
|
|
|
|
The `ZM_Key` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 40. Use DreamHost DNS API
|
|
|
|
DNS API keys may be created at https://panel.dreamhost.com/?tree=home.api.
|
|
Ensure the created key has add and remove privelages.
|
|
|
|
```
|
|
export DH_API_KEY="<api key>"
|
|
acme.sh --issue --dns dns_dreamhost -d example.com -d www.example.com
|
|
```
|
|
|
|
The 'DH_API_KEY' will be saved in `~/.acme.sh/account.conf` and will
|
|
be reused when needed.
|
|
|
|
## 41. Use DirectAdmin API
|
|
The DirectAdmin interface has it's own Let's encrypt functionality, but this
|
|
script can be used to generate certificates for names which are not hosted on
|
|
DirectAdmin
|
|
|
|
User must provide login data and URL to the DirectAdmin incl. port.
|
|
You can create an user which only has access to
|
|
|
|
- CMD_API_DNS_CONTROL
|
|
- CMD_API_SHOW_DOMAINS
|
|
|
|
By using the Login Keys function.
|
|
See also https://www.directadmin.com/api.php and https://www.directadmin.com/features.php?id=1298
|
|
|
|
```
|
|
export DA_Api="https://remoteUser:remotePassword@da.domain.tld:8443"
|
|
export DA_Api_Insecure=1
|
|
```
|
|
Set `DA_Api_Insecure` to 1 for insecure and 0 for secure -> difference is whether ssl cert is checked for validity (0) or whether it is just accepted (1)
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_da -d example.com -d www.example.com
|
|
```
|
|
|
|
The `DA_Api` and `DA_Api_Insecure` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 42. Use KingHost DNS API
|
|
|
|
API access must be enabled at https://painel.kinghost.com.br/painel.api.php
|
|
|
|
```
|
|
export KINGHOST_Username="yourusername"
|
|
export KINGHOST_Password="yourpassword"
|
|
acme.sh --issue --dns dns_kinghost -d example.com -d *.example.com
|
|
```
|
|
|
|
The `KINGHOST_username` and `KINGHOST_Password` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 43. Use Zilore DNS API
|
|
|
|
First, get your API key at https://my.zilore.com/account/api
|
|
|
|
```
|
|
export Zilore_Key="5dcad3a2-36cb-50e8-cb92-000002f9"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_zilore -d example.com -d *.example.com
|
|
```
|
|
|
|
The `Zilore_Key` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 44. Use Loopia.se API
|
|
User must provide login credentials to the Loopia API.
|
|
The user needs the following permissions:
|
|
|
|
- addSubdomain
|
|
- updateZoneRecord
|
|
- getDomains
|
|
- removeSubdomain
|
|
|
|
Set the login credentials:
|
|
```
|
|
export LOOPIA_User="user@loopiaapi"
|
|
export LOOPIA_Password="password"
|
|
```
|
|
|
|
And to issue a cert:
|
|
```
|
|
acme.sh --issue --dns dns_loopia -d example.com -d *.example.com
|
|
```
|
|
|
|
The username and password will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
## 45. Use ACME DNS API
|
|
|
|
ACME DNS is a limited DNS server with RESTful HTTP API to handle ACME DNS challenges easily and securely.
|
|
https://github.com/joohoi/acme-dns
|
|
|
|
```
|
|
export ACMEDNS_UPDATE_URL="https://auth.acme-dns.io/update"
|
|
export ACMEDNS_USERNAME="<username>"
|
|
export ACMEDNS_PASSWORD="<password>"
|
|
export ACMEDNS_SUBDOMAIN="<subdomain>"
|
|
|
|
acme.sh --issue --dns dns_acmedns -d example.com -d www.example.com
|
|
```
|
|
|
|
The credentials will be saved in `~/.acme.sh/account.conf` and will
|
|
be reused when needed.
|
|
## 46. Use TELE3 API
|
|
|
|
First you need to login to your TELE3 account to set your API-KEY.
|
|
https://www.tele3.cz/system-acme-api.html
|
|
|
|
```
|
|
export TELE3_Key="MS2I4uPPaI..."
|
|
export TELE3_Secret="kjhOIHGJKHg"
|
|
|
|
acme.sh --issue --dns dns_tele3 -d example.com -d *.example.com
|
|
```
|
|
|
|
The TELE3_Key and TELE3_Secret will be saved in ~/.acme.sh/account.conf and will be reused when needed.
|
|
|
|
## 47. Use Euserv.eu API
|
|
|
|
First you need to login to your euserv.eu account and activate your API Administration (API Verwaltung).
|
|
[https://support.euserv.com](https://support.euserv.com)
|
|
|
|
Once you've activate, login to your API Admin Interface and create an API account.
|
|
Please specify the scope (active groups: domain) and assign the allowed IPs.
|
|
|
|
```
|
|
export EUSERV_Username="99999.user123"
|
|
export EUSERV_Password="Asbe54gHde"
|
|
```
|
|
|
|
Ok, let's issue a cert now: (Be aware to use the `--insecure` flag, cause euserv.eu is still using self-signed certificates!)
|
|
```
|
|
acme.sh --issue --dns dns_euserv -d example.com -d *.example.com --insecure
|
|
```
|
|
|
|
The `EUSERV_Username` and `EUSERV_Password` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
Please report any issues to https://github.com/initit/acme.sh or to <github@initit.de>
|
|
|
|
## 48. Use DNSPod.com domain API to automatically issue cert
|
|
|
|
First you need to get your API Key and ID by this [get-the-user-token](https://www.dnspod.com/docs/info.html#get-the-user-token).
|
|
|
|
```
|
|
export DPI_Id="1234"
|
|
export DPI_Key="sADDsdasdgdsf"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_dpi -d example.com -d www.example.com
|
|
```
|
|
|
|
The `DPI_Id` and `DPI_Key` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 49. Use Google Cloud DNS API to automatically issue cert
|
|
|
|
First you need to authenticate to gcloud.
|
|
|
|
```
|
|
gcloud init
|
|
```
|
|
|
|
**The `dns_gcloud` script uses the active gcloud configuration and credentials.**
|
|
There is no logic inside `dns_gcloud` to override the project and other settings.
|
|
If needed, create additional [gcloud configurations](https://cloud.google.com/sdk/gcloud/reference/topic/configurations).
|
|
You can change the configuration being used without *activating* it; simply set the `CLOUDSDK_ACTIVE_CONFIG_NAME` environment variable.
|
|
|
|
To issue a certificate you can:
|
|
```
|
|
export CLOUDSDK_ACTIVE_CONFIG_NAME=default # see the note above
|
|
acme.sh --issue --dns dns_gcloud -d example.com -d '*.example.com'
|
|
```
|
|
|
|
`dns_gcloud` also supports [DNS alias mode](https://github.com/Neilpang/acme.sh/wiki/DNS-alias-mode).
|
|
|
|
## 50. Use ConoHa API
|
|
|
|
First you need to login to your ConoHa account to get your API credentials.
|
|
|
|
```
|
|
export CONOHA_Username="xxxxxx"
|
|
export CONOHA_Password="xxxxxx"
|
|
export CONOHA_TenantId="xxxxxx"
|
|
export CONOHA_IdentityServiceApi="https://identity.xxxx.conoha.io/v2.0"
|
|
```
|
|
|
|
To issue a cert:
|
|
```
|
|
acme.sh --issue --dns dns_conoha -d example.com -d www.example.com
|
|
```
|
|
|
|
The `CONOHA_Username`, `CONOHA_Password`, `CONOHA_TenantId` and `CONOHA_IdentityServiceApi` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 51. Use netcup DNS API to automatically issue cert
|
|
|
|
First you need to login in your CCP account to get your API Key and API Password.
|
|
```
|
|
export NC_Apikey="<Apikey>"
|
|
export NC_Apipw="<Apipassword>"
|
|
export NC_CID="<Customernumber>"
|
|
```
|
|
|
|
Now, let's issue a cert:
|
|
```
|
|
acme.sh --issue --dns dns_netcup -d example.com -d www.example.com
|
|
```
|
|
|
|
The `NC_Apikey`,`NC_Apipw` and `NC_CID` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
## 52. Use GratisDNS.dk
|
|
|
|
GratisDNS.dk (https://gratisdns.dk/) does not provide an API to update DNS records (other than IPv4 and IPv6
|
|
dynamic DNS addresses). The acme.sh plugin therefore retrieves and updates domain TXT records by logging
|
|
into the GratisDNS website to read the HTML and posting updates as HTTP. The plugin needs to know your
|
|
userid and password for the GratisDNS website.
|
|
|
|
```sh
|
|
export GDNSDK_Username="..."
|
|
export GDNSDK_Password="..."
|
|
```
|
|
The username and password will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
|
|
Now you can issue a certificate.
|
|
|
|
Note: It usually takes a few minutes (usually 3-4 minutes) before the changes propagates to gratisdns.dk nameservers (ns3.gratisdns.dk often are slow),
|
|
and in rare cases I have seen over 5 minutes before google DNS catches it. Therefor a DNS sleep of at least 300 seconds are recommended-
|
|
|
|
```sh
|
|
acme.sh --issue --dns dns_gdnsdk --dnssleep 300 -d example.com -d *.example.com
|
|
```
|
|
|
|
## 53. Use Namecheap
|
|
|
|
You will need your namecheap username, API KEY (https://www.namecheap.com/support/api/intro.aspx) and your external IP address (or an URL to get it), this IP will need to be whitelisted at Namecheap.
|
|
Due to Namecheap's API limitation all the records of your domain will be read and re applied, make sure to have a backup of your records you could apply if any issue would arise.
|
|
|
|
```sh
|
|
export NAMECHEAP_USERNAME="..."
|
|
export NAMECHEAP_API_KEY="..."
|
|
export NAMECHEAP_SOURCEIP="..."
|
|
```
|
|
|
|
NAMECHEAP_SOURCEIP can either be an IP address or an URL to provide it (e.g. https://ifconfig.co/ip).
|
|
|
|
The username and password will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
Now you can issue a certificate.
|
|
|
|
```sh
|
|
acme.sh --issue --dns dns_namecheap -d example.com -d *.example.com
|
|
```
|
|
|
|
## 54. Use MyDNS.JP API
|
|
|
|
First, register to MyDNS.JP and get MasterID and Password.
|
|
|
|
```
|
|
export MYDNSJP_MasterID=MasterID
|
|
export MYDNSJP_Password=Password
|
|
```
|
|
|
|
To issue a certificate:
|
|
|
|
```
|
|
acme.sh --issue --dns dns_mydnsjp -d example.com -d www.example.com
|
|
```
|
|
The `MYDNSJP_MasterID` and `MYDNSJP_Password` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 55. Use hosting.de API
|
|
|
|
Create an API key in your hosting.de account here: https://secure.hosting.de
|
|
|
|
The key needs the following rights:
|
|
- DNS_ZONES_EDIT
|
|
- DNS_ZONES_LIST
|
|
|
|
Set your API Key and endpoint:
|
|
|
|
```
|
|
export HOSTINGDE_APIKEY='xxx'
|
|
export HOSTINGDE_ENDPOINT='https://secure.hosting.de'
|
|
```
|
|
|
|
The plugin can also be used for the http.net API. http.net customers have to set endpoint to https://partner.http.net.
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_hostingde -d example.com -d *.example.com
|
|
```
|
|
|
|
The hosting.de API key and endpoint will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 56. Use Neodigit.net API
|
|
|
|
```
|
|
export NEODIGIT_API_TOKEN="eXJxTkdUVUZmcHQ3QWJackQ4ZGlMejRDSklRYmo5VG5zcFFKK2thYnE0WnVnNnMy"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_neodigit -d example.com -d www.example.com
|
|
```
|
|
|
|
Neodigit API Token will be saved in `~/.acme.sh/account.conf` and will be used when needed.
|
|
|
|
## 57. Use Exoscale API
|
|
|
|
Create an API key and secret key in the Exoscale account section
|
|
|
|
Set your API and secret key:
|
|
|
|
```
|
|
export EXOSCALE_API_KEY='xxx'
|
|
export EXOSCALE_SECRET_KEY='xxx'
|
|
```
|
|
|
|
Now, let's issue a cert:
|
|
```
|
|
acme.sh --issue --dns dns_exoscale -d example.com -d www.example.com
|
|
```
|
|
|
|
The `EXOSCALE_API_KEY` and `EXOSCALE_SECRET_KEY` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 58. Using PointHQ API to issue certs
|
|
|
|
Log into [PointHQ account management](https://app.pointhq.com/profile) and copy the API key from the page there.
|
|
|
|
```export PointHQ_Key="apikeystringgoeshere"
|
|
exportPointHQ_Email="accountemail@yourdomain.com"
|
|
```
|
|
|
|
You can then issue certs by using:
|
|
```acme.sh --issue --dns dns_pointhq -d example.com -d www.example.com
|
|
```
|
|
|
|
## 59. Use Active24 API
|
|
|
|
Create an API token in the Active24 account section, documentation on https://faq.active24.com/cz/790131-REST-API-rozhran%C3%AD.
|
|
|
|
Set your API token:
|
|
|
|
```
|
|
export ACTIVE24_Token='xxx'
|
|
```
|
|
|
|
Now, let's issue a cert, set `dnssleep` for propagation new DNS record:
|
|
```
|
|
acme.sh --issue --dns dns_active24 -d example.com -d www.example.com --dnssleep 1000
|
|
```
|
|
|
|
The `ACTIVE24_Token` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 60. Use do.de API
|
|
|
|
Create an API token in your do.de account.
|
|
|
|
Set your API token:
|
|
```
|
|
export DO_LETOKEN='FmD408PdqT1E269gUK57'
|
|
```
|
|
|
|
To issue a certificate run:
|
|
```
|
|
acme.sh --issue --dns dns_doapi -d example.com -d *.example.com
|
|
```
|
|
|
|
The API token will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 61. Use Nexcess API
|
|
|
|
First, you'll need to login to the [Nexcess.net Client Portal](https://portal.nexcess.net) and [generate a new API token](https://portal.nexcess.net/api-token).
|
|
|
|
Once you have a token, set it in your systems environment:
|
|
|
|
```
|
|
export NW_API_TOKEN="YOUR_TOKEN_HERE"
|
|
export NW_API_ENDPOINT="https://portal.nexcess.net"
|
|
```
|
|
|
|
Finally, we'll issue the certificate: (Nexcess DNS publishes at max every 15 minutes, we recommend setting a 900 second `--dnssleep`)
|
|
|
|
```
|
|
acme.sh --issue --dns dns_nw -d example.com --dnssleep 900
|
|
```
|
|
|
|
The `NW_API_TOKEN` and `NW_API_ENDPOINT` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 62. Use Thermo.io API
|
|
|
|
First, you'll need to login to the [Thermo.io Client Portal](https://core.thermo.io) and [generate a new API token](https://core.thermo.io/api-token).
|
|
|
|
Once you have a token, set it in your systems environment:
|
|
|
|
```
|
|
export NW_API_TOKEN="YOUR_TOKEN_HERE"
|
|
export NW_API_ENDPOINT="https://core.thermo.io"
|
|
```
|
|
|
|
Finally, we'll issue the certificate: (Thermo DNS publishes at max every 15 minutes, we recommend setting a 900 second `--dnssleep`)
|
|
|
|
```
|
|
acme.sh --issue --dns dns_nw -d example.com --dnssleep 900
|
|
```
|
|
|
|
The `NW_API_TOKEN` and `NW_API_ENDPOINT` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 63. Use Futurehosting API
|
|
|
|
First, you'll need to login to the [Futurehosting Client Portal](https://my.futurehosting.com) and [generate a new API token](https://my.futurehosting.com/api-token).
|
|
|
|
Once you have a token, set it in your systems environment:
|
|
|
|
```
|
|
export NW_API_TOKEN="YOUR_TOKEN_HERE"
|
|
export NW_API_ENDPOINT="https://my.futurehosting.com"
|
|
```
|
|
|
|
Finally, we'll issue the certificate: (Futurehosting DNS publishes at max every 15 minutes, we recommend setting a 900 second `--dnssleep`)
|
|
|
|
```
|
|
acme.sh --issue --dns dns_nw -d example.com --dnssleep 900
|
|
```
|
|
|
|
The `NW_API_TOKEN` and `NW_API_ENDPOINT` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 64. Use Rackspace API
|
|
|
|
Set username and API key, which is available under "My Profile & Settings"
|
|
|
|
```
|
|
export RACKSPACE_Username='username'
|
|
export RACKSPACE_Apikey='xxx'
|
|
```
|
|
|
|
Now, let's issue a cert:
|
|
|
|
```
|
|
acme.sh --issue --dns dns_rackspace -d example.com -d www.example.com
|
|
```
|
|
|
|
## 65. Use Online API
|
|
|
|
First, you'll need to retrive your API key, which is available under https://console.online.net/en/api/access
|
|
|
|
```
|
|
export ONLINE_API_KEY='xxx'
|
|
```
|
|
|
|
To issue a cert run:
|
|
|
|
```
|
|
acme.sh --issue --dns dns_online -d example.com -d www.example.com
|
|
```
|
|
|
|
`ONLINE_API_KEY` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 66. Use MyDevil.net
|
|
|
|
Make sure that you can execute own binaries:
|
|
|
|
```sh
|
|
devil binexec on
|
|
```
|
|
|
|
Install acme.sh, or simply `git clone` it into some directory on your MyDevil host account (in which case you should link to it from your `~/bin` directory).
|
|
|
|
If you're not using private IP and depend on default IP provided by host, you may want to edit `crontab` too, and make sure that `acme.sh --cron` is run also after reboot (you can find out how to do that on their wiki pages).
|
|
|
|
To issue a new certificate, run:
|
|
|
|
```sh
|
|
acme.sh --issue --dns dns_mydevil -d example.com -d *.example.com
|
|
```
|
|
|
|
After certificate is ready, you can install it with [deploy command](../deploy/README.md#14-deploy-your-cert-on-mydevilnet).
|
|
|
|
## 67. Use Core-Networks API to automatically issue cert
|
|
|
|
First you need to login to your Core-Networks account to to set up an API-User.
|
|
Then export username and password to use these credentials.
|
|
|
|
```
|
|
export CN_User="user"
|
|
export CN_Password="passowrd"
|
|
```
|
|
|
|
Ok, let's issue a cert now:
|
|
```
|
|
acme.sh --issue --dns dns_cn -d example.com -d www.example.com
|
|
```
|
|
|
|
The `CN_User` and `CN_Password` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
## 68. Use NederHost API
|
|
|
|
Create an API token in Mijn NederHost.
|
|
|
|
Set your API key:
|
|
```
|
|
export NederHost_Key='xxx'
|
|
```
|
|
|
|
To issue a certificate run:
|
|
```
|
|
acme.sh --issue --dns dns_nederhost -d example.com -d *.example.com
|
|
```
|
|
|
|
## 69. Use OpenProvider API
|
|
|
|
First, you need to enable API access and retrieve your password hash on https://rcp.openprovider.eu/account/dashboard.php
|
|
|
|
```
|
|
export OPENPROVIDER_USER='username'
|
|
export OPENPROVIDER_PASSWORDHASH='xxx'
|
|
```
|
|
|
|
To issue a cert run:
|
|
|
|
```
|
|
acme.sh --issue --dns dns_openprovider -d example.com -d www.example.com
|
|
```
|
|
|
|
`OPENPROVIDER_USER` and `OPENPROVIDER_PASSWORDHASH` will be saved in `~/.acme.sh/account.conf` and will be reused when needed.
|
|
|
|
# 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 `~/.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 the DNS records.
|
|
3. Then you can use your API to issue cert like this:
|
|
|
|
```
|
|
acme.sh --issue --dns dns_myapi -d example.com -d www.example.com
|
|
```
|
|
|
|
For more details, please check our sample script: [dns_myapi.sh](dns_myapi.sh)
|
|
|
|
See: https://github.com/Neilpang/acme.sh/wiki/DNS-API-Dev-Guide
|
|
|
|
# Use lexicon DNS API
|
|
|
|
https://github.com/Neilpang/acme.sh/wiki/How-to-use-lexicon-dns-api
|
|
|
|
|