dnsproviders

module
v0.1.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 18, 2018 License: MIT

README

DNS providers for Caddy

These providers can be used to help solve the ACME DNS challenge by plugging them into Caddy 0.9 and newer:

import _ "github.com/caddyserver/dnsproviders/<provider>"

You can then use this in your Caddyfile with the tls directive like so:

tls {
	dns <provider>
}

Credentials for your DNS provider should be set in environment variables. This information is in the Automatic HTTPS page of the Caddy documentation. For more information about using your DNS provider, see the docs for your provider directly.

If you specify a DNS provider, the DNS challenge will be used exclusively; other challenge types will be disabled. Be aware that some DNS providers may be slow in applying changes.

About these packages

Caddy 0.9 and newer supports solving the ACME DNS challenge. This challenge is unique because the server that is requesting a TLS certificate does not need to start a listener and be accessible from external networks. This quality is essential when behind load balancers or in other advanced networking scenarios.

The DNS challenge sets a DNS record and the ACME server verifies its correctness in order to issue the certificate. Caddy can do this for you automatically, but it needs credentials to your DNS provider to do so. Since every DNS provider is different, we have these adapters you can plug into Caddy in order to complete this challenge.

The underlying logic that actually solves the challenge is implemented in a different package not far away from here. Caddy uses xenolf/lego, a library originally written for use in Caddy, to solve ACME challenges. If you wish to add a new provider, see the documentation for that library and write your own provider implementation. Then writing the adapter for Caddy is very easy: just copy+paste any of these existing ones, replace the names and tweak a few things, and submit a pull request. Done!

Directories

Path Synopsis
Package auroradns adapts the lego AuroraDNS DNS provider for Caddy.
Package auroradns adapts the lego AuroraDNS DNS provider for Caddy.
Package azure adapts the lego azure DNS provider for Caddy.
Package azure adapts the lego azure DNS provider for Caddy.
Package cloudflare adapts the lego Cloudflare DNS provider for Caddy.
Package cloudflare adapts the lego Cloudflare DNS provider for Caddy.
Package cloudxns adapts the lego CloudXNS DNS provider for Caddy.
Package cloudxns adapts the lego CloudXNS DNS provider for Caddy.
Package digitalocean adapts the lego DigitalOcean DNS provider for Caddy.
Package digitalocean adapts the lego DigitalOcean DNS provider for Caddy.
Package dnsimple adapts the lego DNSimple DNS provider for Caddy.
Package dnsimple adapts the lego DNSimple DNS provider for Caddy.
Package dnsimple adapts the lego DNS Made Easy DNS provider for Caddy.
Package dnsimple adapts the lego DNS Made Easy DNS provider for Caddy.
Package dnspod adapts the lego Dnspod DNS provider for Caddy.
Package dnspod adapts the lego Dnspod DNS provider for Caddy.
Package dyn adapts the lego Dyn DNS provider for Caddy.
Package dyn adapts the lego Dyn DNS provider for Caddy.
Package exoscale adapts the lego Exoscale DNS provider for Caddy.
Package exoscale adapts the lego Exoscale DNS provider for Caddy.
Package gandi adapts the lego Gandi DNS provider for Caddy.
Package gandi adapts the lego Gandi DNS provider for Caddy.
Package gandiv5 adapts the lego Gandiv5 DNS provider for Caddy.
Package gandiv5 adapts the lego Gandiv5 DNS provider for Caddy.
Package godaddy adapts the lego GoDaddy DNS provider for Caddy.
Package godaddy adapts the lego GoDaddy DNS provider for Caddy.
Package googlecloud adapts the lego Google Cloud DNS provider for Caddy.
Package googlecloud adapts the lego Google Cloud DNS provider for Caddy.
Package lightsail adapts the lego AWS Lightsail DNS provider for Caddy.
Package lightsail adapts the lego AWS Lightsail DNS provider for Caddy.
Package linode adapts the lego Linode DNS provider for Caddy.
Package linode adapts the lego Linode DNS provider for Caddy.
Package namecheap adapts the lego NameCheap DNS provider for Caddy.
Package namecheap adapts the lego NameCheap DNS provider for Caddy.
Package otc adapts the lego Open Telekom Cloud Managed DNS provider for Caddy.
Package otc adapts the lego Open Telekom Cloud Managed DNS provider for Caddy.
Package ovh adapts the lego OVH DNS provider for Caddy.
Package ovh adapts the lego OVH DNS provider for Caddy.
Package pdns adapts the lego PowerDNS provider for Caddy.
Package pdns adapts the lego PowerDNS provider for Caddy.
Package rackspace adapts the lego Rackspace DNS provider for Caddy.
Package rackspace adapts the lego Rackspace DNS provider for Caddy.
Package rfc2136 adapts the lego RFC 2136 dynamic update DNS provider for Caddy.
Package rfc2136 adapts the lego RFC 2136 dynamic update DNS provider for Caddy.
Package route53 adapts the lego Route53 DNS provider for Caddy.
Package route53 adapts the lego Route53 DNS provider for Caddy.
Package vultr adapts the lego Vultr DNS provider for Caddy.
Package vultr adapts the lego Vultr DNS provider for Caddy.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL