-
Notifications
You must be signed in to change notification settings - Fork 1
dnsapi
If your DNS provider doesn't provide API access, you can use our DNS alias mode:
https://github.com/acmesh-official/acme.sh/wiki/DNS-alias-mode
Cloudflare Domain API offers two methods to automatically issue certs.
First you need to login to your Cloudflare account to get your API key. Each token generated is not stored on cloudflare account and will have expiry if not set correctly. You will get this in API keys section.
export CF_Key="sdfsdfsdfljlbjkljlkjsdfoiwje"
export CF_Email="[email protected]"Using the new cloudflare api token, you will get this after normal login and scroll down on dashboard and copy credentials.
export CF_Token="sdfsdfsdfljlbjkljlkjsdfoiwje"
export CF_Account_ID="xxxxxxxxxxxxx"In order to use the new token, the token currently needs access read access to Zone.Zone, and write access to Zone.DNS, across all Zones. See Issue #2398 for more info.
Alternatively, if the certificate only covers a single zone, you can restrict the API Token only for write access to Zone.DNS for a single domain, and then specify the CF_Zone_ID directly:
export CF_Token="sdfsdfsdfljlbjkljlkjsdfoiwje"
export CF_Account_ID="xxxxxxxxxxxxx"
export CF_Zone_ID="xxxxxxxxxxxxx"Ok, let's issue a cert now:
./acme.sh --issue --dns dns_cf -d example.com -d www.example.comThe CF_Key and CF_Email or CF_Tokenand CF_Account_IDwill be saved in ~/.acme.sh/account.conf and will be reused when needed.
The DNSPod.cn Domain API option requires that you first login to your account to get a DNSPod 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.comThe DP_Id and DP_Key will be saved in ~/.acme.sh/account.conf and will be reused when needed.
Removed
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.comThe GD_Key and GD_Secret will be saved in ~/.acme.sh/account.conf and will be reused when needed.
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=60Ok, let's issue a cert now:
./acme.sh --issue --dns dns_pdns -d example.com -d www.example.comThe PDNS_Url, PDNS_ServerId, PDNS_Token and PDNS_Ttl will be saved in ~/.acme.sh/account.conf and will be reused when needed.
https://github.com/Neilpang/acme.sh/wiki/How-to-use-OVH-domain-api
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.;
};
}Notes on BIND 9.16.1-Ubuntu 20.04.3 LTS
# dnssec-keygen no longer do tsig algorithm, so tsig-keygen (came with bind9)
tsig-keygen -a hmac-sha512 acme | sudo tee /etc/bind/acme.key
# as nsupdate need creation of *.jnl where zone file resides, read /var/log/syslog for error details
sudo chmod g+w /etc/bind
# similar to above steps: include key, allow-update with key on target zone
# echo 'include "/etc/bind/acme.key";' | sudo tee --append /etc/bind/named.conf.localFinally, 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.comThe NSUPDATE_SERVER, NSUPDATE_KEY, and NSUPDATE_ZONE settings will be saved in ~/.acme.sh/account.conf and will be reused when needed.
Get your API token at https://api.luadns.com/settings
export LUA_Key="sdfsdfsdfljlbjkljlkjsdfoiwje"
export LUA_Email="[email protected]"To issue a cert:
./acme.sh --issue --dns dns_lua -d example.com -d www.example.comThe LUA_Key and LUA_Email will be saved in ~/.acme.sh/account.conf and will be reused when needed.
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.comThe ME_Key and ME_Secret will be saved in ~/.acme.sh/account.conf and will be reused when needed.
https://github.com/Neilpang/acme.sh/wiki/How-to-use-Amazon-Route53-API
export AWS_ACCESS_KEY_ID=XXXXXXXXXX
export AWS_SECRET_ACCESS_KEY=XXXXXXXXXXXXXXXTo issue a cert:
./acme.sh --issue --dns dns_aws -d example.com -d www.example.comIf you get an AWS Route53 rate exceeded error, you can add a sleep time between api requests:
export AWS_DNS_SLOWRATE=1 (sleep between API requests in seconds)The AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY and AWS_DNS_SLOWRATE will be saved in ~/.acme.sh/account.conf and will be reused when needed. The AWS_DNS_SLOWRATE will enable the sleep between API requests to AWS servers. It will help to mitigate the AWS rate limit
First you need to login to your Aliyun account to get your RAM API key. https://ram.console.aliyun.com/users
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.comThe Ali_Key and Ali_Secret will be saved in ~/.acme.sh/account.conf and will be reused when needed.
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, DNS txt functions and Client functions.
export ISPC_User="xxx"
export ISPC_Password="xxx"
export ISPC_Api="https://ispc.domain.tld:8080/remote/json.php"
export ISPC_Api_Insecure=1If you have installed ISPConfig on a different port, then alter the 8080 accordingly. Leave ISPC_Api_Insecure set to 1 if you have no 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.comThe ISPC_User, ISPC_Password, ISPC_Apiand ISPC_Api_Insecure will be saved in ~/.acme.sh/account.conf and will be reused when needed.
First you need to login to your Alwaysdata account to get your API Key.
export AD_API_KEY="myalwaysdataapikey"Ok, let's issue a cert now:
./acme.sh --issue --dns dns_ad -d example.com -d www.example.comThe AD_API_KEY will be saved in ~/.acme.sh/account.conf and will be reused
when needed.
Cloud Manager: https://cloud.linode.com/profile/tokens
First you need to login to your Linode account to get your API Key.
- Click on "Add a Personal Access Token".
- Give the new key a "Label" (we recommend ACME)
- Give it Read/Write access to "Domains"
- "Submit" and copy the new key into the
LINODE_V4_API_KEYcommand below.
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:
./acme.sh --issue --dns dns_linode_v4 --dnssleep 900 -d example.com -d www.example.comThe LINODE_V4_API_KEY will be saved in ~/.acme.sh/account.conf and will be
reused when needed.
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.
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.
./acme.sh --issue --dns dns_freedns -d example.com -d www.example.comNote 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.
If you have any issues with FreeDNS API please report them here... https://github.com/Neilpang/acme.sh/issues/2305
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 2FATo issue a cert:
./acme.sh --issue --dns dns_cyon -d example.com -d www.example.comThe CY_Username, CY_Password and CY_OTP_Secret will be saved in ~/.acme.sh/account.conf and will be reused when needed.
Removed
You must enable the new Gandi LiveDNS API first and the create your api key, See: https://api.gandi.net/docs/livedns/
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.comFirst, generate a TSIG key for updating the zone.
keymgr tsig generate -t acme_key hmac-sha512 > /etc/knot/acme.keyInclude this key in your knot configuration file.
include: /etc/knot/acme.keyNext, 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.
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_aclFinally, 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`and optionally (if you use challenge alias zone)
export KNOT_ZONE="le.example.com"Ok, let's issue a cert now:
./acme.sh --issue --dns dns_knot -d example.com -d www.example.comThe KNOT_SERVER and KNOT_KEY and KNOT_ZONE settings will be saved in ~/.acme.sh/account.conf and will be reused when needed.
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.comYou 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.comThe CLOUDNS_AUTH_ID and CLOUDNS_AUTH_PASSWORD will be saved in ~/.acme.sh/account.conf and will be reused when needed.
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.comNote: 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.
First you need to create/obtain API tokens on your settings panel.
export VSCALE_API_KEY="sdfsdfsdfljlbjkljlkjsdfoiwje"Ok, let's issue a cert now:
./acme.sh --issue --dns dns_vscale -d example.com -d www.example.comFirst 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=yyyyyyyyyyyyyyyyyyyyyyyyyOk, let's issue a cert now:
./acme.sh --issue --dns dns_dynu -d example.com -d www.example.comThe Dynu_ClientId and Dynu_Secret will be saved in ~/.acme.sh/account.conf and will be reused when needed.
First you need to login to your DNSimple account and generate a new oauth token.
https://dnsimple.com/a/{your account id}/account/automation
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.comThe 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.
export NS1_Key="fdmlfsdklmfdkmqsdfk"Ok, let's issue a cert now:
./acme.sh --issue --dns dns_nsone -d example.com -d www.example.comexport 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
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.comIf you had Two-step Authentication enabled, make sure to change your security setting, read this guide for help: Using API with Two-step Authentication
For issues, please report to https://github.com/raidenii/acme.sh/issues.
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.comThe DYN_Customer, DYN_Username and DYN_Password will be saved in ~/.acme.sh/account.conf and will be reused when needed.
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.orgSometimes cloudflare / google doesn't pick new dns records fast enough. You can add --dnssleep XXX to params as workaround.
For issues, please report to https://github.com/non7top/acme.sh/issues.
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.comThe 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 [email protected].
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.comThe UNO_Key and UNO_User will be saved in ~/.acme.sh/account.conf and will be reused when needed.
INWX offers an xmlrpc api 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.comThe 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.
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=passwordNow you cann issue a cert:
./acme.sh --issue --dns dns_servercow -d example.com -d www.example.comBoth, SERVERCOW_API_Username and SERVERCOW_API_Password will be saved in ~/.acme.sh/account.conf and will be reused when needed.
You'll need to generate an API key at https://www.namesilo.com/account/api-manager 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.comInternetX offers an 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.comThe AUTODNS_USER, AUTODNS_PASSWORD and AUTODNS_CONTEXT settings will be saved in ~/.acme.sh/account.conf and will be reused when needed.
You have to create a service principal first. See: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.comAZUREDNS_SUBSCRIPTIONID, AZUREDNS_TENANTID,AZUREDNS_APPID and AZUREDNS_CLIENTSECRET settings will be saved in ~/.acme.sh/account.conf and will be reused when needed.
Alternatively, you can use Managed Identity assigned to a resource instead of a service prinvcipal.
You have to assign a managed identity to your resource, usually a VM, as described here. This identity requires DNS Zone Contributor role.
Before running acme.sh following variables need to bo set:
export AZUREDNS_SUBSCRIPTIONID="12345678-9abc-def0-1234-567890abcdef"
export AZUREDNS_MANAGEDIDENTITY=true
Issuing certificates using managed identity clears previously set settings: AZUREDNS_TENANTID, AZUREDNS_APPID, AZUREDNS_CLIENTSECRET.
AZUREDNS_SUBSCRIPTIONID and AZUREDNS_MANAGEDIDENTITY will be saved in ~/.acme.sh/account.conf for future use.
First you need to login to your account to get your API key from: https://my.selectel.ru/profile/apikeys.
export SL_Key="sdfsdfsdfljlbjkljlkjsdfoiwje"
Ok, let's issue a cert now:
./acme.sh --issue --dns dns_selectel -d example.com -d www.example.comThe SL_Key will be saved in ~/.acme.sh/account.conf and will be reused when needed.
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:
https://zonomi.com/app/dns/dyndns.jsp?host=example.com&api_key=1063364558943540954358668888888888export ZM_Key="1063364558943540954358668888888888"
Ok, let's issue a cert now:
./acme.sh --issue --dns dns_zonomi -d example.com -d www.example.comThe ZM_Key will be saved in ~/.acme.sh/account.conf and will be reused when needed.
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.comThe 'DH_API_KEY' will be saved in ~/.acme.sh/account.conf and will
be reused when needed.
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:[email protected]:8443"
export DA_Api_Insecure=1Set 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.comThe DA_Api and DA_Api_Insecure will be saved in ~/.acme.sh/account.conf and will be reused when needed.
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.comThe KINGHOST_username and KINGHOST_Password will be saved in ~/.acme.sh/account.conf and will be reused when needed.
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.comThe Zilore_Key will be saved in ~/.acme.sh/account.conf and will be reused when needed.
User must provide login credentials to the Loopia API. The user needs the following permissions:
- getDomains
- getSubdomains
- addSubdomain
- removeSubdomain
- getZoneRecords
- addZoneRecord
Set the API endpoint:
export LOOPIA_Api="https://api.loopia.<TLD>/RPCSERV"Depending on your hosting location, <TLD> is one of: com, no,
rs, se. The default endpoint is se TLD.
Set the login credentials:
export LOOPIA_User="user@loopiaapi"
export LOOPIA_Password="password"And to issue a cert run:
./acme.sh --issue --dns dns_loopia -d example.com -d *.example.comThe exported variables will be saved in ~/.acme.sh/account.conf and
will be reused when needed.
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
# Usage:
# export ACMEDNS_BASE_URL="https://auth.acme-dns.io"
#
# You can optionally define an already existing account:
#
# 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.
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.comThe TELE3_Key and TELE3_Secret will be saved in ~/.acme.sh/account.conf and will be reused when needed.
First you need to login to your euserv.eu account and activate your API Administration (API Verwaltung). 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 --insecureThe 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 [email protected]
First you need to get your API Key and ID by this 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.comThe DPI_Id and DPI_Key will be saved in ~/.acme.sh/account.conf and will be reused when needed.
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.
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.
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.comThe CONOHA_Username, CONOHA_Password, CONOHA_TenantId and CONOHA_IdentityServiceApi will be saved in ~/.acme.sh/account.conf and will be reused when needed.
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.comThe NC_Apikey,NC_Apipw and NC_CID will be saved in ~/.acme.sh/account.conf and will be reused when needed.
Removed
https://github.com/acmesh-official/acme.sh/pull/4049
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.
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.
./acme.sh --issue --dns dns_namecheap -d example.com -d *.example.comIf you find any bugs of namecheap dns API, please report here: https://github.com/Neilpang/acme.sh/issues/2107
First, register to MyDNS.JP and get MasterID and Password.
export MYDNSJP_MasterID=MasterID
export MYDNSJP_Password=PasswordTo issue a certificate:
./acme.sh --issue --dns dns_mydnsjp -d example.com -d *.example.comThe MYDNSJP_MasterID and MYDNSJP_Password will be saved in ~/.acme.sh/account.conf and will be reused when needed.
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.comThe hosting.de API key and endpoint will be saved in ~/.acme.sh/account.conf and will be reused when needed.
export NEODIGIT_API_TOKEN="eXJxTkdUVUZmcHQ3QWJackQ4ZGlMejRDSklRYmo5VG5zcFFKK2thYnE0WnVnNnMy"Ok, let's issue a cert now:
./acme.sh --issue --dns dns_neodigit -d example.com -d www.example.comNeodigit API Token will be saved in ~/.acme.sh/account.conf and will be used when needed.
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.comThe EXOSCALE_API_KEY and EXOSCALE_SECRET_KEY will be saved in ~/.acme.sh/account.conf and will be reused when needed.
Log into PointHQ account management and copy the API key from the page there.
exportPointHQ_Email="[email protected]"
You can then issue certs by using:
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 1000The ACTIVE24_Token will be saved in ~/.acme.sh/account.conf and will be reused when needed.
Create an API token in your do.de account (Create token here | Documentation).
Set your API token:
export DO_LETOKEN='FmD408PdqT1E269gUK57'To issue a certificate run:
./acme.sh --issue --dns dns_doapi -d example.com -d *.example.comThe API token will be saved in ~/.acme.sh/account.conf and will be reused when needed.
First, you'll need to login to the Nexcess.net Client Portal and generate a new 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 900The NW_API_TOKEN and NW_API_ENDPOINT will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs of Nexcess dns API, please report here: https://github.com/Neilpang/acme.sh/issues/2088
First, you'll need to login to the Thermo.io Client Portal and generate a new 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 900The NW_API_TOKEN and NW_API_ENDPOINT will be saved in ~/.acme.sh/account.conf and will be reused when needed.
First, you'll need to login to the Futurehosting Client Portal and generate a new 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 900The NW_API_TOKEN and NW_API_ENDPOINT will be saved in ~/.acme.sh/account.conf and will be reused when needed.
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.comIf you find any bugs of Rackspace dns API, please report here: https://github.com/Neilpang/acme.sh/issues/2091
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.comONLINE_API_KEY will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs of online.net dns API, please report here: https://github.com/Neilpang/acme.sh/issues/2093
Make sure that you can execute own binaries:
devil binexec onInstall 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:
./acme.sh --issue --dns dns_mydevil -d example.com -d *.example.comAfter certificate is ready, you can install it with deploy command.
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.comThe CN_User and CN_Password will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs of core-networks.de dns API, please report here: https://github.com/Neilpang/acme.sh/issues/2142
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.comIf you find any bugs of NederHost dns API, please report here: https://github.com/Neilpang/acme.sh/issues/2089
First, you'll need to retrive your API key. Estonian insructions https://help.zone.eu/kb/zoneid-api-v2/
export ZONE_Username=yourusername
export ZONE_Key=keygoeshereTo issue a cert run:
./acme.sh --issue -d example.com -d www.example.com --dns dns_zoneZONE_Username and ZONE_Key will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs of zone.eu (zone.ee) dns API, please report here: https://github.com/Neilpang/acme.sh/issues/2146
UltraDNS is a paid for service that provides DNS, as well as Web and Mail forwarding (as well as reporting, auditing, and advanced tools).
More information can be found here: https://www.security.neustar/lp/ultra20/index.html
The REST API documentation for this service is found here: https://portal.ultradns.com/static/docs/REST-API_User_Guide.pdf
Set your UltraDNS User name, and password; these would be the same you would use here:
https://portal.ultradns.com/ - or if you create an API only user, that username and password would be better utilized.
export ULTRA_USR="abcd"
export ULTRA_PWD="efgh"
To issue a cert run:
./acme.sh --issue --dns dns_ultra -d example.com -d www.example.comULTRA_USR and ULTRA_PWD will be saved in ~/.acme.sh/account.conf and will be resued when needed.
Sign up for dynDNS at https://desec.io first.
Set your API token (password) by generating one from your account on desec.io (it's also a good idea to restrict the IPv4 / IPv6 address(es) it can be used from).
export DEDYN_TOKEN=d41d8cd98f00b204e9800998ecf8427eTo issue a certificate run:
./acme.sh --issue --dns dns_desec -d foobar.dedyn.io -d *.foobar.dedyn.ioIf you find any bugs of deSEC.io API, please report here: https://github.com/Neilpang/acme.sh/issues/2180
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'
./acme.sh --issue --dns dns_openprovider -d example.com -d www.example.comOPENPROVIDER_USER and OPENPROVIDER_PASSWORDHASH will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs of OpenProvider dns API, please report here: https://github.com/Neilpang/acme.sh/issues/2104
Make sure you've configured MaraDNS properly and setup a zone file for your domain. See csv2(5).
Set the path to your zone file, and path to duende's pid file (see, duende(8) or ps -C duende o pid,cmd).
The pid file is used to ask duende to reload the configuration automatically after DNS records are added.
export MARA_ZONE_FILE="/etc/maradns/db.domain.com"
export MARA_DUENDE_PID_PATH="/run/maradns/etc_maradns_mararc.pid"Ensure that the acme.sh process has write access to the zone file and read access to the pid file.
Issuing a certificate:
./acme.sh --issue --dns dns_maradns -d example.com -d '*.example.com'MARA_ZONE_FILE and MARA_DUENDE_PID_PATH will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs of MaraDNS DNS API, please report here: https://github.com/Neilpang/acme.sh/issues/2072
First create an account at https://ddnss.de. After that create a new host record. In the defenition for the host make sure to set the checkbox for "Wildcard" and for "TXT".
Note your Api Key (aka "Update Key") displayed at ddnss.de and export in DDNSS_Token variable
export DDNSS_Token="e4155767few8erwf59353633tz342ce85werddc99432"**Note: Every Cert needs it own Update Key, if you already use the Update Key please generate a new one and export to DDNSS_Token before issue a new Cert. **
After that you can issue a new certificate:
./acme.sh --issue --dns dns_ddnss -d example.comIf you find any bugs of ddnss.de API, please report here: https://github.com/Neilpang/acme.sh/issues/2230
You need to export two variables. Your zonefile which the script will automatically edit:
export Nsd_ZoneFile="/etc/nsd/zones/example.com.zone"And something that calls the nsd-control reload command, either via a script:
export Nsd_Command="/usr/local/bin/sign-and-update.sh example.com"or directly:
export Nsd_Command="sudo nsd-control reload example.com"The variables are saved per-domain, not per-account.
To issue a new certificate, run:
./acme.sh --issue --dns dns_nsd -d example.com -d *.example.comIf you find any bugs of NLnetLabs NSD dns API, please report here: https://github.com/Neilpang/acme.sh/issues/2245
Schlundtech offers an xml api with your standard login credentials, set them like so:
export SCHLUNDTECH_USER="yourusername"
export SCHLUNDTECH_PASSWORD="password"Then you can issue your certificates with:
./acme.sh --issue --dns dns_schlundtech -d example.com -d www.example.comThe SCHLUNDTECH_USER and SCHLUNDTECH_PASSWORD settings will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs of Schlundtech.de API, please report here: https://github.com/Neilpang/acme.sh/issues/2246
export ONECOM_User="sdfsdfsdfljlbjkljlkjsdfoiwje"
export ONECOM_Password="[email protected]"Ok, let's issue a cert now:
./acme.sh --issue --dns dns_one -d example.com -d www.example.comNote:
It's no longer possible to add TXT Records with the Name "_acme-challenge" to the base Domain.
To override the fallback value, you must use a CNAME and proxy it.
For example:
CNAME _acme-challenge.yourdomain.com => proxy_acme-challenge.yourdomain.com
The TXT Records have to be created on proxy_acme-challenge.yourdomain.com
Since the default CNAME TTL is 3600 seconds, it is recommended to leave the CNAME record.
But if you would like to use the build-in SSL (for your Web-Site etc.) from one.com, you have to delete the Record.
You can set "ONECOM_KeepCnameProxy" to keep the CNAME record.
export ONECOM_KeepCnameProxy=1By default the CNAME record will be removed.
The ONECOM_User,ONECOM_Password and ONECOM_KeepCnameProxy will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs of one.com dns API, please report here: https://github.com/Neilpang/acme.sh/issues/2103
Acmeproxy can be used to as a single host in your network to request certificates through a DNS API. Clients can connect with one single host (the acmeproxy) so you don't need to store your DNS API credentials on every single host that wants to request a certificate.
export ACMEPROXY_ENDPOINT="https://acmeproxy.yourhost.com:9096"
export ACMEPROXY_USERNAME="username"
export ACMEPROXY_PASSWORD="password"Then you can issue your certificates with:
./acme.sh --issue --dns dns_acmeproxy -d example.com -d www.example.comThe ACMEPROXY_ENDPOINT, ACMEPROXY_USERNAME and ACMEPROXY_PASSWORD settings will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs of acmeproxy DNS API, please report here: https://github.com/Neilpang/acme.sh/issues/2251
Create an API token in your internetbs.net account.
Set your API token:
export INTERNETBS_API_KEY="..."
export INTERNETBS_API_PASSWORD="..."To issue a certificate run:
./acme.sh --issue --dns dns_internetbs -d example.com -d www.example.comThe INTERNETBS_API_KEY and INTERNETBS_API_PASSWORD will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs of internetbs.net API, please report here: https://github.com/Neilpang/acme.sh/issues/2261
Create an API token in your durabledns.com account.
Set your API token:
export DD_API_User="..."
export DD_API_Key="..."To issue a certificate run:
./acme.sh --issue --dns dns_durabledns -d example.com -d '*.example.com'The DD_API_User and DD_API_Key will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs of durabledns.com API, please report here: https://github.com/Neilpang/acme.sh/issues/2281
Set your API credentials:
export REGRU_API_Username='test'
export REGRU_API_Password='test'To issue a certificate run:
./acme.sh --issue --dns dns_regru -d 'example.com' -d '*.example.com'The REGRU_API_Username and REGRU_API_Password will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs of reg.ru API, please report here: Issue #2336
RU:
Установите свои учетные данные API:
В Настройки API для авторизации устанавливаем пароль в настройках "Альтернативный пароль", и добавляем IP в "Диапазоны IP-адресов" для избежание ошибки
response='{
"charset" : "utf-8",
"error_code" : "ACCESS_DENIED_FROM_IP",
"error_params" : {
"command_name" : "service/get_list"
},
"error_text" : "Access to API from this IP denied",
"messagestore" : null,
"result" : "error"
}'
Диапазоны IP-адресов
acme-v02.api.letsencrypt.org - 172.65.32.248 для получения SSL и api.reg.ru - 194.58.116.30 для тхт записи _acme-challenge
Для авторизатции в API выполните:
export REGRU_API_Username='водим свой логин для входа на REG.RU'
export REGRU_API_Password='водим пароль каторый настроили в настройках API для авторизации'Для получения сертификата выполните:
./acme.sh --issue --dns dns_regru -d 'example.com' -d '*.example.com'Настройки для авторизации REGRU_API_Username и REGRU_API_Password будут сохранены в ~/.acme.sh/account.conf и будут использоваться повторно при необходимости из конфига acme.
Если вы обнаружите какие-либо ошибки в API reg.ru, сообщите об этом здесь: Issue #2336
You'll need an API key for your Vultr account which you can find under the Account settings and you'll want to ensure the API key is allowed for any IPs you might be using acme.sh with.
Vultr supports creating sub-accounts with limited permissions, and it's a good idea to create a sub-account with only the 'Manage DNS' permission and use an API key from that sub-account.
export VULTR_API_KEY="<Your API key>"To issue a cert:
./acme.sh --issue --dns dns_vultr -d example.com -d www.example.comThe VULTR_API_KEY will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs of Vultr API, please report here: Issue #2374
支持京东云 jdcloud.com 的免费dns服务. 请先登陆控制台获取 api key id 和 api key secret:
https://uc.jdcloud.com/account/accesskey
export JD_ACCESS_KEY_ID="sdfsdfsdfljlbjkljlkjsdfoiwje"
export JD_ACCESS_KEY_SECRET="xxxxxxx"然后生成证书:
./acme.sh --issue --dns dns_jd -d example.com -d www.example.comJD_ACCESS_KEY_ID 和 JD_ACCESS_KEY_SECRET 会自动保存在这里 ~/.acme.sh/account.conf, 下次再生成证书时, 可以自动重用.
高级选项:
- 默认使用的是
cn-north-1区域. 目前不需要改动, 如果需要改的话, 再生成证书之前执行:
export JD_REGION="cn-north-1" # 这里写你要改的区域有 bug 的话可以报到这里: https://github.com/Neilpang/acme.sh/issues/2388
Create a role user in your Account -> Settings -> ShareAccess
Set the Access Control like bellow:
QueryDNSZoneRRList(dnszone=*):ALLOW
UpdateDNSZone():ALLOW
Remember the role id and role password.
export Hexonet_Login='username!roleId'
export Hexonet_Password="role password"For example:
My user name is neilpang, my role id is: testid. So I use the following format:
export Hexonet_Login='neilpang!testid'To issue a cert:
./acme.sh --issue --dns dns_hexonet -d example.com -d www.example.comThe Hexonet_Login and Hexonet_Password will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs, please report here:
https://github.com/Neilpang/acme.sh/issues/2389
You'll have to get a Domeneshop API key and secret (https://api.domeneshop.no/docs/).
export DOMENESHOP_Token="1234567890"
export DOMENESHOP_Secret="1234567890abcdefghijklmnopqrstuvw"Ok, let's issue a cert now:
./acme.sh --issue --dns dns_domeneshop -d example.com -d www.example.comThe DOMENESHOP_Token and DOMENESHOP_Secret will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs, please report here:
https://github.com/Neilpang/acme.sh/issues/2457
First you need to login to your OPNsense account and create an API Key for a user with access to the Bind service.
https://docs.opnsense.org/development/api.html
export OPNs_Host="opnsense.example.com"
export OPNs_Port="443"
export OPNs_Key="qocfU9RSbt8vTIBcnW8bPqCrpfAHMDvj5OzadE7Str+rbjyCyk7u6yMrSCHtBXabgDDXx/dY0POUp7ZA"
export OPNs_Token="pZEQ+3ce8dDlfBBdg3N8EpqpF5I1MhFqdxX06le6Gl8YzyQvYCfCzNaFX9O9+IOSyAs7X71fwdRiZ+Lv"
export OPNs_Api_Insecure=0Ok, let's issue a cert now:
./acme.sh --issue --dns dns_opnsense -d example.com -d www.example.comThe OPNs_Host, OPNs_Port, OPNs_Key, OPNs_Token and OPNs_Api_Insecure will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs, please report here:
https://github.com/Neilpang/acme.sh/issues/2480
First you need to login to your RcodeZero account, enable the REST API and generate an ACME API token (only the ACME API token will work wih acme.sh. It has limited access and could only be used to add/remove challenges to the zones).
https://my.rcodezero.at/enableapi
export RCODE0_API_TOKEN="acme_1232342342343OEH1G1gDcKNMsN7mx9EZgSU6AX79u5KRSxWnC"Ok, let's issue a cert now:
./acme.sh --issue --dns dns_rcode0 -d example.com -d www.example.comThe RCODE0_API_TOKEN will be saved in ~/.acme.sh/account.conf and will be reused when needed.
The RcodeZero API driver supports two addtional environment variables
export RCODE0_URL=https://my.rcodezero.atUse a different RcodeZero API Endpoint (e.g. the RcodeZero Testsystem)
export RCODE0_TTL=60Use a different TTL for the generated records
If you find any bugs, please report here:
https://github.com/Neilpang/acme.sh/issues/2490
Use the MailinaBox (MIAB) Custom DNS REST API interface to MIAB DNS. You only need to set your MIAB login credentials and the fully qualified domain name of the MIAB Server. Suggest single quote over double quote to ensure characters are not interpreted by the shell - important for passwords.
export MIAB_Username='your_MIAB_admin_username'
export MIAB_Password='your_MIAB_admin_password'
export MIAB_Server='FQDN_of_your_MIAB_Server'To issue a cert:
./acme.sh --issue --dns dns_miab -d example.com -d www.example.comThe MIAB_Username, MIAB_Password and MIAB_Server will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs, please report here:
https://github.com/Neilpang/acme.sh/issues/2550
You need to login to nic.ru account and register your application here.
You need to define the following environment variables befor issuing a cert:
-
NIC_Username- login for sitenic.ruin form000000/NIC-D -
NIC_Password- password for sitenic.ru. It may be administrative or technical password (details) -
NIC_ClientID- your application identifier (details) -
NIC_ClientSecret- your application secret NIC_Tokenis base64 encoded string<client_id>:<client_secret>. This variable is deprecated. It is used for backward compatibility. If NIC_ClientID and NIC_ClientSecret are not defined, then they are calculated using old NIC_Token variable.
export NIC_Username='000000/NIC-D'
export NIC_Password='xxxxxxxx'
export NIC_ClientID='xxxxxxxx'
export NIC_ClientSecret='xxxxxxxx'To issue a cert:
./acme.sh --issue --dns dns_nic -d domain.com -d www.domain.comThe NIC_Username, NIC_Password, NIC_ClientID and NIC_ClientSecret will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs, please report here:
https://github.com/Neilpang/acme.sh/issues/2547
Docs:
- https://www.nic.ru/help/upload/file/API_DNS-hosting-en.pdf
- https://www.nic.ru/help/oauth-server_5809.html
First you need to login to your Leaseweb account to get your API Key.
export LSW_Key="safas-3fs3sd-34sdf-safss"Ok, let's issue a cert now:
./acme.sh --issue --dns dns_leaseweb -d example.com -d www.example.comThe LSW_Key will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs, please report here: https://github.com/Neilpang/acme.sh/issues/2558
First you need to obtain your API Key from variomedia's customer support.
export VARIOMEDIA_API_TOKEN="sdfsdfsdfljlbjkljlkjsdfoiwjesdfsdfsdfljlbjkljlkjsdfoiwje"Ok, let's issue a cert now:
./acme.sh --issue --dns dns_variomedia -d example.com -d www.example.comThe VARIOMEDIA_API_TOKEN will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs, please report here: https://github.com/Neilpang/acme.sh/issues/2564
Before using the module, you must set your Plesk user name and password, and the address of your Plesk XML API (sometimes called a URI, URL or web link). The URI usually looks similar to this:
https://address-of-my-plesk-server.net:8443/enterprise/control/agent.php
All commands are CASE SENSITIVE:
export pleskxml_uri="address of my Plesk server's API"
export pleskxml_user="my plesk username"
export pleskxml_pass="my plesk password"Ok, let's issue a cert now:
./acme.sh --issue --dns dns_pleskxml -d example.com -d www.example.comThe pleskxml_uri, pleskxml_user and pleskxml_pass will be saved in ~/.acme.sh/account.conf and reused when needed.
If you find any bugs, please report here: https://github.com/Neilpang/acme.sh/issues/2577
PDNS Manager is a web frontend for Power DNS.
This script uses PDNS Manager API and its "Update via GET request" method. So only single record update possible and no wildcards, for now.
export PDNS_MANAGER_URL=https://mypdnsmanagerurl.nx
export PDNS_MANAGER_RECORDID=<record id>
export PDNS_MANAGER_PASSWORD=<record password>- Add your domain to PDNS Manager.
- Create a password for your record.
Then issue a new certificate:
./acme.sh --issue -d example.com --dns dns_pdnsmanagerGet your API token at https://console.misaka.io/settings
export Misaka_Key="sdfsdfsdfljlbjkljlkjsdfoiwje"To issue a cert:
./acme.sh --issue --dns dns_misaka -d example.com -d www.example.comYou need to sign up for API access here or select 'User' -> 'Security' from the top menu and select 'signup' in the 'easyDNS REST API' section after logging in to your account. API Docs: https://sandbox.rest.easydns.net:3001/
Note that initially you are only granted API access to a sandbox environment, not your live DNS settings.
export EASYDNS_Token="xxxxxxxxxxxxxxx.xxxxxxxx"
export EASYDNS_Key="apixxxxxxxxxxxxxx.xxxxxxxx"Ok, let's issue a cert now:
./acme.sh --issue --dns dns_easydns -d example.com -d www.example.comThe EASYDNS_Token and EASYDNS_Key will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs, please report here:
https://github.com/acmesh-official/acme.sh/issues/2647
Docs: https://github.com/vshosting/clouddns
export CLOUDDNS_EMAIL="[email protected]"
export CLOUDDNS_PASSWORD="xxxxxxxx"
export CLOUDDNS_CLIENT_ID="xxxxxxxxxxxxxxxxxxxx"Ok, let's issue a cert now:
./acme.sh --issue --dns dns_clouddns -d example.com -d www.example.comThe CLOUDDNS_EMAIL, CLOUDDNS_PASSWORD and CLOUDDNS_CLIENT_ID will be saved in ~/.acme.sh/account.conf and will be reused when needed.
If you find any bugs, please report here:
https://github.com/Neilpang/acme.sh/issues/2699
This uses the dynv6 SSH API to issue the certificate. You will need a ssh key to authenticate. You can specify your own key with export KEY="path/to/keyfile" or if no key is specified one will be created for you which you will have to add here. In both cases the path to the keyfile will be saved for reuse.
Alternatively you can use the HTTP REST API. For this you will need a HTTP Token, which you can generate from the dynv6 website. Use it with export DYNV6_TOKEN="value".
If both a SSH Key and a HTTP Token are specified the REST API will be used.
To issue a cert use:
./acme.sh --issue --dns dns_dynv6 -d www.example.dynv6.netIf you find any bugs, please report here:
https://github.com/acmesh-official/acme.sh/issues/2702
You need your login credentials for All-Inkl (https://kas.all-inkl.com).
export KAS_Login="....."
export KAS_Authtype="sha1"
export KAS_Authdata="....."Now you are able to issue a cert:
./acme.sh --issue --dns dns_kas -d example.com -d www.example.comThe KAS_Login, KAS_Authtype and KAS_Authdata will be saved in ~/.acme.sh/account.conf and will be reused when needed.
Get your API credentials at https://manage.constellix.com/users
export CONSTELLIX_Key="XXX"
export CONSTELLIX_Secret="XXX"To issue a cert:
./acme.sh --issue --dns dns_constellix -d example.com -d www.example.comThe CONSTELLIX_Key and CONSTELLIX_Secret will be saved in ~/.acme.sh/account.conf and will be reused when needed.
Get your API credentials at https://namemaster.de DNS/API
export NM_user="XXX"
export NM_sha256="XXX"To issue a cert:
./acme.sh --issue --dns dns_nm -d example.com -d www.example.comThe NM_user and NM_sha256 will be saved in ~/.acme.sh/account.conf and will be reused when needed.
How get your API credentials: https://api.adm.tools/osnovnie-polozheniya/dostup-k-api/
# Your login:
HostingUkraine_Login="XXX"
# Your api token:
HostingUkraine_Token="XXX"
To issue a cert:
./acme.sh --issue --dns dns_hostingukraine -d yourdomain.com -d www.yourdomain.comTo issue a wildcard cert:
./acme.sh --issue --dns dns_hostingukraine -d yourdomain.com -d '*.yourdomain.com' The HostingUkraine_Login and HostingUkraine_Token will be saved in ~/.acme.sh/account.conf and will be reused when needed.
Get your API token at https://npanel.arvancloud.com/profile/api-keys
export Arvan_Token="fsdasdfsdfljlbjkljlkjsdfoiwje"To issue a cert:
./acme.sh --issue --dns dns_arvan -d example.com -d www.example.comThe Arvan_Token will be saved in ~/.acme.sh/account.conf and will be reused when needed.
You must activate Dynamic DNS in Joker.com DNS configuration first. Username and password below refer to Dynamic DNS authentication, not your Joker.com login credentials. See https://joker.com/faq/content/11/427/en/what-is-dynamic-dns-dyndns.html.
NOTE: This script does not support wildcard certificates, because Joker.com API does not support adding two TXT records with the same subdomain. Adding the second record will overwrite the first one. See https://joker.com/faq/content/6/496/en/let_s-encrypt-support.html:
... this request will replace all TXT records for the specified label by the provided content...
Report bugs to https://github.com/acmesh-official/acme.sh/issues/2840
export JOKER_USERNAME="xxxx"
export JOKER_PASSWORD="xxxx"To issue a cert:
./acme.sh --issue --dns dns_joker -d example.comThe JOKER_USERNAME and JOKER_PASSWORD will be saved in ~/.acme.sh/account.conf and will be reused when needed.
1984Hosting 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 1984Hosting
website to read the HTML and posting updates as HTTP. The plugin needs to
know your username and password for the 1984Hosting website.
export One984HOSTING_Username=<your_username>
export One984HOSTING_Password=<your_password>You need only provide this the first time you run the acme.sh client with 1984Hosting
validation and then again whenever you change your password at the 1984Hosting site.
The acme.sh 1984Hosting plugin does not store your username or password,
but rather saves an authentication token returned by 1984Hosting
in ~/.acme.sh/account.conf and reuses it when needed.
Ok, let's issue a cert now:
./acme.sh --issue --dns dns_1984hosting -d example.com -d *.example.comIf you have any issues with 1984Hosting DNS API please report them here.
Get your api token following instruction here at https://admin.arubabusiness.it/DashBoard/WebApiGuide.aspx
export ARUBA_TK="sdfsdfsdfljlbjkljlkjsdfoiwje" #ARUBA API Token
export ARUBA_AK="xxxxxxxxxxxxx" #ARUBA Username
export ARUBA_AS="xxxxxxxxxxxxx" #ARUBA PasswordOk, let's issue a cert now:
./acme.sh --issue --dns dns_aruba -d example.com -d www.example.comIf you find any bugs, please report here: https://github.com/JTrotta/acme.sh/issues
First you need to login to your TransIP account to get your private key.
export TRANSIP_Username="MyUserName"
export TRANSIP_Key_File="private_key"Note: TransIP is rather slow, so adding a --dnssleep of 300 might be adviced. Note 2: if the DNS fails with something like
Please refer to https://curl.haxx.se/libcurl/c/libcurl-errors.html for error code: 60
== Info: SSL certificate problem: unable to get local issuer certificate
Than maybe the root CA of TransIP is NOT in your cacerts. You can check this manually with
curl -vvI https://api.transip.nl
Currently, the root CA of TransIP is COMODO_RSA_Certification_Authority.crt you can add this trusted root CA with
--ca-bundle COMODO_RSA_Certification_Authority.crt
This script will create a new access token with a default lifetime of 30 minutes. Note that these tokens are by default IP-whitelisted and will not work if your IP is not whitelisted in the Transip control panel.
To issue a cert:
./acme.sh --issue --dns dns_transip --dnssleep 300 -d example.com -d www.example.comexport DF_user="XXX"
export DF_password="XXX"To issue a cert:
./acme.sh --issue --dns dns_df -d example.com -d www.example.comThe df_user and df_password will be saved in ~/.acme.sh/account.conf and will be reused when needed.
export NJALLA_Token="XXX"To issue a cert:
./acme.sh --issue --dns dns_njalla -d example.com -d www.example.comPlease report any bugs here: https://github.com/acmesh-official/acme.sh/issues/2913
Obtain an account token from https://vercel.com/account/tokens.
export VERCEL_TOKEN="sdfsdfsdfljlbjkljlkjsdfoiwje"To issue a cert:
./acme.sh --issue --dns dns_vercel -d example.com -d www.example.comFirst you need to create/obtain API tokens on your Hetzner DNS console.
export HETZNER_Token="somelongrandomstring"Ok, let's issue a cert now:
./acme.sh --issue --dns dns_hetzner -d example.com -d www.example.comThe HETZNER_Token settings will be saved in [acme.sh-config-home-path]/account.conf
and will be reused when needed.
The domain(s) zone_id(s) will be saved in CERT_HOME/[domain]/[domain].conf
in order to avoid multiple get_zone_id requests two months later.
If you're not already using the new "gases" name servers (hydrogen, oxygen and helium) don't forget to change the domain's whois ns section to them and wait about 24-48 Hours. See Hetzner wiki.
Contact kapper.net support via [email protected] to get your kapper.net DNS Panel API Key and Secret.
For initialzation call following in commandline
export KAPPERNETDNS_Key="yourKAPPERNETapikey"
export KAPPERNETDNS_Secret="yourKAPPERNETapisecret"You can start the acme.sh with following parameters for testing
./acme.sh --issue --dns dns_kappernet -d <example.com>
or for a wildcertificate
./acme.sh --issue --dns dns_kappernet -d <example.com> -d *.<example.com>
Please replace "<example.com>" with the name of the domain you wish to create a certificate for.
After the test you can replace your kapper.net DNS Panel API Key and Secret, it is stored in ~/.acme.sh/account.conf.
For repeated calls use
./acme.sh --issue --dns dns_kappernet -d <example.com>First create your WAPI password and add your IP address to access list at customer portal. For more info visit, https://kb.wedos.com/en/kategorie/wapi-api-interface/
Set variables:
export WEDOS_User='[email protected]'
export WEDOS_Pass='xxx123'
or use sha1 hash of WEDOS_Pass directly
export WEDOS_Hash='xxxxxxxxxx'Issue your certs:
./acme.sh --issue --dns dns_wedos -d xxx.xx -d www.xxx.xxWEDOS_User and WEDOS_Hash will be stored in ~/.acme.sh/account.conf and will be reused when needed.
Shellrent API offers one method to automatically issue certs.
First you need to login to your Shellrent account to get your API key. In order to use the token, you need to authorize your IP to have access to it. More Info on https://api.shellrent.com and https://guide.shellrent.com
export SH_Username="usrXXXX"
export SH_Token="sdfsdfsdfljlbjkljlkjsdfoiwje"Alternatively, if the certificate only covers a single zone, you can speed up the process by specify the SH_Domain_ID directly:
export SH_Username="usrXXXX"
export SH_Token="sdfsdfsdfljlbjkljlkjsdfoiwje"
export SH_Domain_ID="xxxxxxxxxxxxx"Let's issue a cert now:
./acme.sh --issue --dns dns_shellrent -d example.com -d www.example.comThe SH_Username and SH_Token and SH_Domain_ID will be saved in ~/.acme.sh/account.conf and will be reused when needed.
This provider supports OpenStack Designate for creating DNS records.
Report any issues to https://github.com/acmesh-official/acme.sh/issues/3054
This provider requires the OpenStack Client (python-openstackclient) and Designate client (python-designateclient) be installed and available in your path.
It also requires you use Keystone V3 credentials, which can be either password or application credentials provided as environment variables. Any other authentication method will not save your credentials for renewal.
You will most likely want to source your OpenStack RC file to set your environment variables:
. openrc.sh
or manually like:
export OS_AUTH_URL=https://keystone.example.com:5000/
export OS_USERNAME=<username>
export OS_PASSWORD=<password>
export OS_PROJECT_NAME=<project name>
export OS_PROJECT_DOMAIN_NAME=Default
export OS_USER_DOMAIN_NAME=DefaultTo issue a cert:
./acme.sh --issue --dns dns_openstack -d example.comYour OpenStack credentials will be saved to ~/.acme.sh/account.conf and reused on renewal.
-
Generate a Personal Access Token at https://app.netlify.com/user/applications
-
Set your token for use with
export NETLIFY_ACCESS_TOKEN='arstdhneioqwfpgjluyzxcvbkm'- Issue a cert with:
./acme.sh --issue --dns dns_netlify -d example.com -d www.example.comThis provider supports the Akamai Edge DNS API for creating DNS records.
Report any issues to https://github.com/acmesh-official/acme.sh/issues/3157
This provider requires Akamai Open Edgegrid Credentials with EdgeDNS API access authorization. To create and establish your Akamai OPEN CREDENTIALS, see the authorization and credentials sections of the Akamai Developer Get Started guide.
The Akamai Open Edgegrid credentials must be specified as environment variables as follows:
export AKAMAI_CLIENT_TOKEN=<akamai edgegrid client token>
export AKAMAI_ACCESS_TOKEN=<akamai edgegrid access token>
export AKAMAI_CLIENT_SECRET=<akamai edgegrid client secret>
export AKAMAI_HOST=<akamai edgegrid api host>To issue a cert:
./acme.sh --issue --dns dns_edgedns -d example.comYour Akamai Edgegrid credentials will be saved to ~/.acme.sh/account.conf and reused on renewal.
WEDOS DNS provider comes from Czech Republic. DNS API implementation for WEDOS require your WEDOS's account to allow WAPI interface. You have to login to WEDOS administration, in setting allow WAPI interface (in days when this manual were written it was for free completelly). Configure WAPI interface to XML interface and register the IP addresses (IPv4 and IPv6) of the server where you plan to use acme.sh. That is from the manual side.
By doing this setting you should have WEDOS web account username and configured WAPI password. This must be configured to your acme.sh account in the first execution of acme.sh script. To save it to ~/.acme.sh/account.conf (and for subsequent acme.sh executions) just execute following before first execution of acme.sh script.
export WEDOS_Username=<your user name to login to wedos web account>
export WEDOS_Wapipass=<your WAPI passwords you setup using wedos web pages>Then you can issue a certificates:
./acme.sh --issue --dns dns_wedos -d "*.example.com" -d "examle.com"If you face any bug, please use this page to report it. But before reporting run the acme.sh with --debug 2 switch and append full acme.sh output to the issue report.
Enjoy it.
Obtain an api key and secret from https://admin.websupport.sk/en/auth/apiKey
export WS_ApiKey="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
export WS_ApiSecret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"To issue a cert:
./acme.sh --issue --dns dns_websupport -d "*.example.com" -d "examle.com"Report any issues to https://github.com/akulumbeg/acme.sh/issues
Infomaniak hosts a large number of domains and other hosted services. Create a token with Domain scope in the API dashboard at https://manager.infomaniak.com/v3/<account_id>/api/dashboard and export it as an environment variable:
export INFOMANIAK_API_TOKEN=xxx
./acme.sh --issue --dns dns_infomaniak -d example.com -d www.example.comPlease report any issue to https://github.com/acmesh-official/acme.sh/issues/3188
Bookmyname hosts domains and has a small API.
Export your login/pass as an environment variable:
export BOOKMYNAME_USERNAME=xxx
export BOOKMYNAME_PASSWORD=yyy
./acme.sh --issue --dns dns_bookmyname --dnssleep 600 -d example.com -d www.example.comPlease report any issue to https://github.com/acmesh-official/acme.sh/issues/3209
For DNS records managed via https://engine.anexia-it.com/clouddns
Export your token as an environment variable:
export ANX_Token='XXXXXXXXXXXXXXXXXXX'
./acme.sh --issue --dns dns_anx -d example.com -d www.example.comPlease report any issue to https://github.com/acmesh-official/acme.sh/issues/3238
Note that in order the script to be working properly acme.sh should be installed on Synology itself.
To issue a cert:
./acme.sh --issue --dns dns_synology_dsm -d example.com -d www.example.comTo issue a wildcard cert:
./acme.sh --issue --dns dns_synology_dsm -d example.com -d *.example.com
You can find more details here
Please report any issue here
Export your credentials as an environment variable:
About "DomainName" parameters see: https://support.huaweicloud.com/api-iam/iam_01_0006.html
export HUAWEICLOUD_Username=<Your Username> # IAM Username
export HUAWEICLOUD_Password=<Your Password>
export HUAWEICLOUD_DomainName=<Your DomainName>To issue a cert:
./acme.sh --issue --dns dns_huaweicloud -d example.com -d www.example.comTo issue a wildcard cert:
./acme.sh --issue --dns dns_huaweicloud -d example.com -d *.example.comExport your credentials, you will find your API key by logging in to your Simply.com account here:
export SIMPLY_AccountName=<Your accountname>
export SIMPLY_ApiKey=<Your API-key>To issue a cert:
./acme.sh --issue --dns dns_simply -d example.com -d www.example.comTo issue a wildcard cert:
./acme.sh --issue --dns dns_simply -d example.com -d *.example.comExport your credentials as an environment variable:
export WORLD4YOU_USERNAME=<customer-id>
export WORLD4YOU_PASSWORD=<password>To issue a cert:
./acme.sh --issue --dns dns_world4you -d example.com -d www.example.comTo issue a wildcard cert:
./acme.sh --issue --dns dns_world4you -d example.com -d *.example.comFirst, you'll need to retrieve your Api Key
export SCALEWAY_API_TOKEN='xxx'To issue a cert run:
./acme.sh --issue --dns dns_scaleway -d example.com -d www.example.comPlease report any issue here
export LS_Key="KEY"Ok, let's issue a cert now:
./acme.sh --issue --dns dns_ls -d example.com -d www.example.comExport your credentials as an environment variable:
export RACKCORP_APIUUID="UUIDHERE"
export RACKCORP_APISECRET="SECRETHERE"To issue a cert:
./acme.sh --issue --dns dns_rackcorp -d example.com -d www.example.comTo issue a wildcard cert:
./acme.sh --issue --dns dns_rackcorp -d example.com -d *.example.comRead Getting Started to learn how to create an API key. Export your credentials as environment variables:
export IONOS_PREFIX="..."
export IONOS_SECRET="..."To issue a certificate, execute:
./acme.sh --issue --dns dns_ionos -d example.com -d www.example.comTo issue a wildcard certificate, execute:
./acme.sh --issue --dns dns_ionos -d example.com -d *.example.comRead Getting Started to learn how to create an API key. Export your credentials as environment variables:
export PORKBUN_API_KEY="..."
export PORKBUN_SECRET_API_KEY="..."To issue a certificate, execute:
./acme.sh --issue --dns dns_porkbun -d example.com -d www.example.comTo issue a wildcard certificate, execute:
./acme.sh --issue --dns dns_porkbun -d example.com -d *.example.comPCextreme B.V. is a Dutch cloud provider offering cloud services under the family name Aurora. Head over to DNS & Health Checks > Users to get your API credentials. Export your credentials as environment variables:
export AURORA_Key="..."
export AURORA_Secret="..."To issue a certificate, execute:
./acme.sh --issue --dns dns_aurora -d example.com -d www.example.comPlease report any issue to https://github.com/acmesh-official/acme.sh/issues/3459
Azion is a Edge Computing Platform to build modern applications at edge. This API reflects the Intelligent DNS product. Read this documentation to create an username/password and permissions to use this plugin.
Export your username/password as environment variables:
export AZION_Email="[email protected]"
export AZION_Password="password"To issue a certificate, execute:
./acme.sh --issue --dns dns_azion -d example.com -d www.example.comPlease report any issue to https://github.com/acmesh-official/acme.sh/issues/3555
See: https://github.com/acmesh-official/acme.sh/wiki/Using-Oracle-Cloud-Infrastructure-DNS
Créer un token API sur votre compte Hostline Hébergement VPS.
Ajouter les variables API suivantes :
export HOSTLINE_Token="xxx" (obligatoire)
export HOSTLINE_Url="https://api.hostline.fr" (optionnel)
export HOSTLINE_Ttl="60" ttl custom record (optionnel)Pour générer un certificat exécuter la commande correspondante à votre cas :
./acme.sh --issue --dns dns_hostline -d www.example.com # simple domain
./acme.sh --issue --dns dns_hostline -d example.com -d www.example.com # multi domain
./acme.sh --issue --dns dns_hostline -d example.com -d *.example.com # wildcardLes variables HOSTLINE_Token, HOSTLINE_Url (optionnel) et HOSTLINE_Ttl (optionnel) doivent être définies dans le fichier /root/.acme.sh/account.conf.
Si vous rencontrez un problème sur l'API Hostline Hébergement VPS, merci de rapporter votre problème sur le lien suivant : https://github.com/acmesh-official/acme.sh/issues/3675
Veesp offers HTTP REST API to manage vital details of account and services like DNS. Your standard login credentials is needed:
export VEESP_User="[email protected]"
export VEESP_Password="password"To issue a cert:
./acme.sh --issue --dns dns_veesp -d example.com -d www.example.comThe VEESP_User and VEESP_Password will be saved in ~/.acme.sh/account.conf and will be reused when needed.
Please report any issue to https://github.com/acmesh-official/acme.sh/issues/3712
First you need to log into the cPanel interface and generate an API key for your account (under Security -> Manage API Tokens). Then set your username, api token and hostname:
export cPanel_Username=username
export cPanel_Apitoken=apitoken
export cPanel_Hostname=https://hostname:portexample
export cPanel_Username=myadminuseratnordicway
export cPanel_Apitoken=CXJ8HRXFNS363RQ71Z51TKM9KTHRFZVE
export cPanel_Hostname=https://cp04.nordicway.dk:2083Ok, let's issue a cert now:
./acme.sh --issue --dns dns_cpanel -d example.com -d www.example.com(see https://api.docs.cpanel.net/cpanel/introduction/#cpanel-or-webmail-session-url-1 regarding cPanel ports)
The cPanel_Username, cPanel_Apitoken and cPanel_Hostname will be saved in ~/.acme.sh/account.conf and will be reused when needed.
Please report any issue to https://github.com/acmesh-official/acme.sh/issues/3732
!!! IMPORTANT: Make sure the verson of ISPMan supports TXT records !!!
The dns_ispman.sh api Adds & Deletes domain TXT records by authenticating into the ISPMan Customer Control Panel and executing related HTTP POST & GET requests.
The dns_ispman.sh api requires your <domain> and <passwd> for authentication:
export ISPMan_Username=<domain>
export ISPMan_Password=<passwd>The ISPMan_Username and ISPMan_Password will be saved in $LE_WORKING_DIR/account.conf and will be reused for certificate renewals.
Ok, let's issue a cert:
./acme.sh --issue --dns dns_ispman -d example.com -d *.example.comPlease report bugs to https://github.com/acmesh-official/acme.sh/issues/3751
export DNSHOME_Subdomain=""
export DNSHOME_SubdomainPassword=""Ok, let's issue a cert now:
./acme.sh --issue --dns dns_dnshome -d subdomain.ddnsdomain.tldThe DNSHOME_Subdomain and DNSHOME_SubdomainPassword will be saved in the domain conf and will be reused when needed.
Please report any issue to https://github.com/acmesh-official/acme.sh/issues/3819
First obtain you API key from the control panel.
export MB_AK="Key"
export MB_AS="Secret"Ok, let's issue a cert now:
./acme.sh --issue --dns dns_mythic_beasts --domain example.comThe credentials will be saved in ~/.acme.sh/account.conf and will be reused when needed.
Please report any issue to https://github.com/acmesh-official/acme.sh/issues/3848
First generate your dns zone key. Open your existing nameserver entry, click on [Passwort für dynamic DNS generieren] and save your zone. This generates a new key for your zone.
export SDNS_ZONE_KEY="Key"Ok, let's issue a cert now:
./acme.sh --issue --dns dns_sdns --domain example.comS-dns nameservers use anycast. It is therefore possible that the server next to your location already provides the new record, while the CA reaches another one that does not have the TXT record yet. To avoid such timing errors the dnssleep flag can be set to a value of 240 seconds.
./acme.sh --issue --dns dns_sdns --domain example.com --dnssleep 240Create an account at ud reselling.
There is no option to use an API key, so you just need to set your credentials as environment variables:
export UDR_USER="..."
export UDR_PASS="..."To issue a certificate, execute:
./acme.sh --issue --dns dns_udr -d example.com -d www.example.comTo issue a wildcard certificate, execute:
./acme.sh --issue --dns dns_udr -d example.com -d *.example.comThe UDR_USER and UDR_PASS will be saved in ~/.acme.sh/account.conf and will be reused when needed.
Login to your curanet account, create a new API Application, and use client_id and secret as shown below
export CURANET_AUTHCLIENTID="..."
export CURANET_AUTHSECRET="..."To issue a certificate, execute:
./acme.sh --issue --dns dns_curanet -d example.com -d www.example.comTo issue a wildcard certificate, execute:
./acme.sh --issue --dns dns_curanet -d example.com -d *.example.comThe CURANET_AUTHCLIENTID and CURANET_AUTHSECRET will be saved in ~/.acme.sh/account.conf and will be reused when needed.
First, verify that API access is already enabled:
- Go to ArtFiles.de's DCP (Domain Control Panel).
- Click Passwords in the left menu.
- To the menu's right, the drop-down menu for Active is either
activeorinactive. - If Active is already set to
active, skip this step. Otherwise, enter your desired password into both text boxes, save it somewhere else (e. g. Firefox, KeePass, etc.) & click Apply below. - Copy User name's value, i. e. the one that starts with
api& then continues with your account number which is something likea12345678.
Export AF_API_Username & AF_API_Password only once (saved into domain's config file upon 1st successful script run):
export AF_API_Username="api12345678"
export AF_API_Password="apiPassword"To issue a certificate, execute:
./acme.sh --issue --dns dns_artfiles -d yourDomain.tldTo issue a wildcard certificate, execute:
./acme.sh --issue --dns dns_artfiles -d yourDomain.tld -d *.yourDomain.tldPlease report any issue at Eagle3386/acme.sh/issues.
Create an account at Geoscaling.
Set your credentials as environment variables:
export GEOSCALING_Username="..."
export GEOSCALING_Password="..."To issue a certificate, execute:
./acme.sh --issue --dns dns_geoscaling -d example.com -d www.example.comTo issue a wildcard certificate, execute:
./acme.sh --issue --dns dns_geoscaling -d example.com -d '*.example.com'The GEOSCALING_Username and GEOSCALING_Password will be saved in ~/.acme.sh/account.conf and will be reused when needed.
Report bugs at this issue.
Get an API key in your fornex.com account page. Then
export FORNEX_API_KEY="Key"To issue a cert, run command:
./acme.sh --issue --dns dns_fornex -d example.comTo issue a wildcard certificate, execute:
./acme.sh --issue --dns dns_fornex -d example.com -d '*.example.com'Use your credentials
export [email protected]
export DnsServices_Password=YouPassword
To issue a cert, run command:
./acme.sh --issue --dns dns_dnsservices -d example.com
To issue a wildcard certificate, run command:
./acme.sh --issue --dns dns_dnsservices -d example.com -d '*.example.com'
You are able to create a free account on app.nodion.com and add an API key used by acme.sh by visiting the settings page. Please take this token and set it as env variable.
export NODION_API_KEY="Token"To issue a certificate, execute:
acme.sh --issue --dns dns_nodion -d example.comTo issue a wildcard certificate, execute:
acme.sh --issue --dns dns_nodion -d *.example.comUse your credentials
export LA_Id="appid"
export LA_Key="apikey"
To issue a cert, run command:
./acme.sh --issue --dns dns_la -d example.com
To issue a wildcard certificate, run command:
./acme.sh --issue --dns dns_la -d example.com -d *.example.com
Create a new service account with role dns.editor and create authorized key for him.
Required parameters:
export YC_Folder_ID="YC Folder ID"
export YC_SA_ID="Service Account ID"
export YC_SA_Key_ID="Service Account IAM Key ID"
# You need use YC_SA_Key_File_PEM_b64 or YC_SA_Key_File_Path
export YC_SA_Key_File_PEM_b64="Base64 content of private.key"
export YC_SA_Key_File_Path="/path/to/private.key"Optional parameters:
export YC_Zone_ID="DNS Zone ID"Now you cann issue a cert:
./acme.sh --issue --dns dns_yc -d example.com -d www.example.comBoth, YC_Folder_ID, YC_SA_ID, YC_SA_Key_ID, YC_SA_Key_File_PEM_b64 or YC_SA_Key_File_Path and YC_Zone_ID will be saved in ~/.acme.sh/account.conf and will be reused when needed.
- create a new TXT record for a subdomainname with the needed prefix e.g. "_acme-challenge.example.com" (default) or "alias.example.com" (dns alias mode)
- for wildcard subdomains add a second TXT record for the identical subdomainname
- edit the TXT record and note the ID in (...) behind the subdomainname
- export each subdomainname (including the prefix) and the corresponding record IDs in SELFHOSTDNS_MAP like "subdomainname:RID1:RID2"
- at least one RID must be set, up to two are supported for wildcard subdomains
- each entry must be seperated by a space
- export username and password in SELFHOSTDNS_USERNAME and SELFHOSTDNS_PASSWORD
Note: For username you have to use your account / customer number. You can find them in any invoice or on the right top of the selfhost dashboard.
export SELFHOSTDNS_USERNAME="myname"
export SELFHOSTDNS_PASSWORD="mypass"
export SELFHOSTDNS_MAP="_acme-challenge.example.com:12345:98765 alias.example.com:11111"
acme.sh --issue -d example.com --dns dns_selfhost
If your API is not supported yet, you can write your own DNS API.
Let's assume you want to name it 'myapi':
- Create a bash script named
~/.acme.sh/dns_myapi.sh, - In the script you must have a function named
dns_myapi_add()which will be called by acme.sh to add the DNS records. - Then you can use your API to issue cert like this:
./acme.sh --issue --dns dns_myapi -d example.com -d www.example.comFor more details, please check our sample script: dns_myapi.sh
See: DNS API Dev Guide
More APIs coming soon...