package acme import ( "crypto/tls" "crypto/x509" "fmt" "io/ioutil" fmtlog "log" "net/url" "reflect" "strings" "sync" "time" "github.com/BurntSushi/ty/fun" "github.com/cenk/backoff" "github.com/containous/flaeg" "github.com/containous/traefik/log" "github.com/containous/traefik/rules" "github.com/containous/traefik/safe" traefiktls "github.com/containous/traefik/tls" "github.com/containous/traefik/types" "github.com/containous/traefik/version" "github.com/pkg/errors" "github.com/sirupsen/logrus" "github.com/xenolf/lego/acme" legolog "github.com/xenolf/lego/log" "github.com/xenolf/lego/providers/dns" ) var ( // OSCPMustStaple enables OSCP stapling as from https://github.com/xenolf/lego/issues/270 OSCPMustStaple = false ) // Configuration holds ACME configuration provided by users type Configuration struct { Email string `description:"Email address used for registration"` ACMELogging bool `description:"Enable debug logging of ACME actions."` CAServer string `description:"CA server to use."` Storage string `description:"Storage to use."` EntryPoint string `description:"EntryPoint to use."` KeyType string `description:"KeyType used for generating certificate private key. Allow value 'EC256', 'EC384', 'RSA2048', 'RSA4096', 'RSA8192'. Default to 'RSA4096'"` OnHostRule bool `description:"Enable certificate generation on frontends Host rules."` OnDemand bool `description:"Enable on demand certificate generation. This will request a certificate from Let's Encrypt during the first TLS handshake for a hostname that does not yet have a certificate."` // Deprecated DNSChallenge *DNSChallenge `description:"Activate DNS-01 Challenge"` HTTPChallenge *HTTPChallenge `description:"Activate HTTP-01 Challenge"` TLSChallenge *TLSChallenge `description:"Activate TLS-ALPN-01 Challenge"` Domains []types.Domain `description:"CN and SANs (alternative domains) to each main domain using format: --acme.domains='main.com,san1.com,san2.com' --acme.domains='*.main.net'. No SANs for wildcards domain. Wildcard domains only accepted with DNSChallenge"` } // Provider holds configurations of the provider. type Provider struct { *Configuration Store Store certificates []*Certificate account *Account client *acme.Client certsChan chan *Certificate configurationChan chan<- types.ConfigMessage certificateStore *traefiktls.CertificateStore clientMutex sync.Mutex configFromListenerChan chan types.Configuration pool *safe.Pool } // Certificate is a struct which contains all data needed from an ACME certificate type Certificate struct { Domain types.Domain Certificate []byte Key []byte } // DNSChallenge contains DNS challenge Configuration type DNSChallenge struct { Provider string `description:"Use a DNS-01 based challenge provider rather than HTTPS."` DelayBeforeCheck flaeg.Duration `description:"Assume DNS propagates after a delay in seconds rather than finding and querying nameservers."` preCheckTimeout time.Duration preCheckInterval time.Duration } // HTTPChallenge contains HTTP challenge Configuration type HTTPChallenge struct { EntryPoint string `description:"HTTP challenge EntryPoint"` } // TLSChallenge contains TLS challenge Configuration type TLSChallenge struct{} // SetConfigListenerChan initializes the configFromListenerChan func (p *Provider) SetConfigListenerChan(configFromListenerChan chan types.Configuration) { p.configFromListenerChan = configFromListenerChan } // SetCertificateStore allow to initialize certificate store func (p *Provider) SetCertificateStore(certificateStore *traefiktls.CertificateStore) { p.certificateStore = certificateStore } // ListenConfiguration sets a new Configuration into the configFromListenerChan func (p *Provider) ListenConfiguration(config types.Configuration) { p.configFromListenerChan <- config } // ListenRequest resolves new certificates for a domain from an incoming request and return a valid Certificate to serve (onDemand option) func (p *Provider) ListenRequest(domain string) (*tls.Certificate, error) { acmeCert, err := p.resolveCertificate(types.Domain{Main: domain}, false) if acmeCert == nil || err != nil { return nil, err } certificate, err := tls.X509KeyPair(acmeCert.Certificate, acmeCert.PrivateKey) return &certificate, err } // Init for compatibility reason the BaseProvider implements an empty Init func (p *Provider) Init(_ types.Constraints) error { acme.UserAgent = fmt.Sprintf("containous-traefik/%s", version.Version) if p.ACMELogging { legolog.Logger = fmtlog.New(log.WriterLevel(logrus.InfoLevel), "legolog: ", 0) } else { legolog.Logger = fmtlog.New(ioutil.Discard, "", 0) } if p.Store == nil { return errors.New("no store found for the ACME provider") } var err error p.account, err = p.Store.GetAccount() if err != nil { return fmt.Errorf("unable to get ACME account : %v", err) } // Reset Account if caServer changed, thus registration URI can be updated if p.account != nil && p.account.Registration != nil && !isAccountMatchingCaServer(p.account.Registration.URI, p.CAServer) { log.Info("Account URI does not match the current CAServer. The account will be reset") p.account = nil } p.certificates, err = p.Store.GetCertificates() if err != nil { return fmt.Errorf("unable to get ACME certificates : %v", err) } return nil } func isAccountMatchingCaServer(accountURI string, serverURI string) bool { aru, err := url.Parse(accountURI) if err != nil { log.Infof("Unable to parse account.Registration URL : %v", err) return false } cau, err := url.Parse(serverURI) if err != nil { log.Infof("Unable to parse CAServer URL : %v", err) return false } return cau.Hostname() == aru.Hostname() } // Provide allows the file provider to provide configurations to traefik // using the given Configuration channel. func (p *Provider) Provide(configurationChan chan<- types.ConfigMessage, pool *safe.Pool) error { p.pool = pool p.watchCertificate() p.watchNewDomains() p.configurationChan = configurationChan p.refreshCertificates() p.deleteUnnecessaryDomains() for i := 0; i < len(p.Domains); i++ { domain := p.Domains[i] safe.Go(func() { if _, err := p.resolveCertificate(domain, true); err != nil { log.Errorf("Unable to obtain ACME certificate for domains %q : %v", strings.Join(domain.ToStrArray(), ","), err) } }) } p.renewCertificates() ticker := time.NewTicker(24 * time.Hour) pool.Go(func(stop chan bool) { for { select { case <-ticker.C: p.renewCertificates() case <-stop: ticker.Stop() return } } }) return nil } func (p *Provider) getClient() (*acme.Client, error) { p.clientMutex.Lock() defer p.clientMutex.Unlock() if p.client != nil { return p.client, nil } account, err := p.initAccount() if err != nil { return nil, err } log.Debug("Building ACME client...") caServer := "https://acme-v02.api.letsencrypt.org/directory" if len(p.CAServer) > 0 { caServer = p.CAServer } log.Debug(caServer) client, err := acme.NewClient(caServer, account, account.KeyType) if err != nil { return nil, err } // New users will need to register; be sure to save it if account.GetRegistration() == nil { log.Info("Register...") reg, err := client.Register(true) if err != nil { return nil, err } account.Registration = reg } // Save the account once before all the certificates generation/storing // No certificate can be generated if account is not initialized err = p.Store.SaveAccount(account) if err != nil { return nil, err } if p.DNSChallenge != nil && len(p.DNSChallenge.Provider) > 0 { log.Debugf("Using DNS Challenge provider: %s", p.DNSChallenge.Provider) err = dnsOverrideDelay(p.DNSChallenge.DelayBeforeCheck) if err != nil { return nil, err } var provider acme.ChallengeProvider provider, err = dns.NewDNSChallengeProviderByName(p.DNSChallenge.Provider) if err != nil { return nil, err } client.ExcludeChallenges([]acme.Challenge{acme.HTTP01, acme.TLSALPN01}) err = client.SetChallengeProvider(acme.DNS01, provider) if err != nil { return nil, err } // Same default values than LEGO p.DNSChallenge.preCheckTimeout = 60 * time.Second p.DNSChallenge.preCheckInterval = 2 * time.Second // Set the precheck timeout into the DNSChallenge provider if challengeProviderTimeout, ok := provider.(acme.ChallengeProviderTimeout); ok { p.DNSChallenge.preCheckTimeout, p.DNSChallenge.preCheckInterval = challengeProviderTimeout.Timeout() } } else if p.HTTPChallenge != nil && len(p.HTTPChallenge.EntryPoint) > 0 { log.Debug("Using HTTP Challenge provider.") client.ExcludeChallenges([]acme.Challenge{acme.DNS01, acme.TLSALPN01}) err = client.SetChallengeProvider(acme.HTTP01, &challengeHTTP{Store: p.Store}) if err != nil { return nil, err } } else if p.TLSChallenge != nil { log.Debug("Using TLS Challenge provider.") client.ExcludeChallenges([]acme.Challenge{acme.HTTP01, acme.DNS01}) err = client.SetChallengeProvider(acme.TLSALPN01, &challengeTLSALPN{Store: p.Store}) if err != nil { return nil, err } } else { return nil, errors.New("ACME challenge not specified, please select TLS or HTTP or DNS Challenge") } p.client = client return p.client, nil } func (p *Provider) initAccount() (*Account, error) { if p.account == nil || len(p.account.Email) == 0 { var err error p.account, err = NewAccount(p.Email, p.KeyType) if err != nil { return nil, err } } // Set the KeyType if not already defined in the account if len(p.account.KeyType) == 0 { p.account.KeyType = GetKeyType(p.KeyType) } return p.account, nil } func (p *Provider) watchNewDomains() { p.pool.Go(func(stop chan bool) { for { select { case config := <-p.configFromListenerChan: for _, frontend := range config.Frontends { for _, route := range frontend.Routes { domainRules := rules.Rules{} domains, err := domainRules.ParseDomains(route.Rule) if err != nil { log.Errorf("Error parsing domains in provider ACME: %v", err) continue } if len(domains) == 0 { log.Debugf("No domain parsed in rule %q", route.Rule) continue } log.Debugf("Try to challenge certificate for domain %v founded in Host rule", domains) var domain types.Domain if len(domains) > 0 { domain = types.Domain{Main: domains[0]} if len(domains) > 1 { domain.SANs = domains[1:] } safe.Go(func() { if _, err := p.resolveCertificate(domain, false); err != nil { log.Errorf("Unable to obtain ACME certificate for domains %q detected thanks to rule %q : %v", strings.Join(domains, ","), route.Rule, err) } }) } } } case <-stop: return } } }) } func (p *Provider) resolveCertificate(domain types.Domain, domainFromConfigurationFile bool) (*acme.CertificateResource, error) { domains, err := p.getValidDomains(domain, domainFromConfigurationFile) if err != nil { return nil, err } // Check provided certificates uncheckedDomains := p.getUncheckedDomains(domains, !domainFromConfigurationFile) if len(uncheckedDomains) == 0 { return nil, nil } log.Debugf("Loading ACME certificates %+v...", uncheckedDomains) client, err := p.getClient() if err != nil { return nil, fmt.Errorf("cannot get ACME client %v", err) } var certificate *acme.CertificateResource bundle := true if p.useCertificateWithRetry(uncheckedDomains) { certificate, err = obtainCertificateWithRetry(domains, client, p.DNSChallenge.preCheckTimeout, p.DNSChallenge.preCheckInterval, bundle) } else { certificate, err = client.ObtainCertificate(domains, bundle, nil, OSCPMustStaple) } if err != nil { return nil, fmt.Errorf("unable to generate a certificate for the domains %v: %v", uncheckedDomains, err) } if certificate == nil { return nil, fmt.Errorf("domains %v do not generate a certificate", uncheckedDomains) } if len(certificate.Certificate) == 0 || len(certificate.PrivateKey) == 0 { return nil, fmt.Errorf("domains %v generate certificate with no value: %v", uncheckedDomains, certificate) } log.Debugf("Certificates obtained for domains %+v", uncheckedDomains) if len(uncheckedDomains) > 1 { domain = types.Domain{Main: uncheckedDomains[0], SANs: uncheckedDomains[1:]} } else { domain = types.Domain{Main: uncheckedDomains[0]} } p.addCertificateForDomain(domain, certificate.Certificate, certificate.PrivateKey) return certificate, nil } func (p *Provider) useCertificateWithRetry(domains []string) bool { // Check if we can use the retry mechanism only if we use the DNS Challenge and if is there are at least 2 domains to check if p.DNSChallenge != nil && len(domains) > 1 { rootDomain := "" for _, searchWildcardDomain := range domains { // Search a wildcard domain if not already found if len(rootDomain) == 0 && strings.HasPrefix(searchWildcardDomain, "*.") { rootDomain = strings.TrimPrefix(searchWildcardDomain, "*.") if len(rootDomain) > 0 { // Look for a root domain which matches the wildcard domain for _, searchRootDomain := range domains { if rootDomain == searchRootDomain { // If the domains list contains a wildcard domain and its root domain, we can use the retry mechanism to obtain the certificate return true } } } // There is only one wildcard domain in the slice, if its root domain has not been found, the retry mechanism does not have to be used return false } } } return false } func obtainCertificateWithRetry(domains []string, client *acme.Client, timeout, interval time.Duration, bundle bool) (*acme.CertificateResource, error) { var certificate *acme.CertificateResource var err error operation := func() error { certificate, err = client.ObtainCertificate(domains, bundle, nil, OSCPMustStaple) return err } notify := func(err error, time time.Duration) { log.Errorf("Error obtaining certificate retrying in %s", time) } // Define a retry backOff to let LEGO tries twice to obtain a certificate for both wildcard and root domain ebo := backoff.NewExponentialBackOff() ebo.MaxElapsedTime = 2 * timeout ebo.MaxInterval = interval rbo := backoff.WithMaxRetries(ebo, 2) err = backoff.RetryNotify(safe.OperationWithRecover(operation), rbo, notify) if err != nil { log.Errorf("Error obtaining certificate: %v", err) return nil, err } return certificate, nil } func dnsOverrideDelay(delay flaeg.Duration) error { if delay == 0 { return nil } if delay > 0 { log.Debugf("Delaying %d rather than validating DNS propagation now.", delay) acme.PreCheckDNS = func(_, _ string) (bool, error) { time.Sleep(time.Duration(delay)) return true, nil } } else { return fmt.Errorf("delayBeforeCheck: %d cannot be less than 0", delay) } return nil } func (p *Provider) addCertificateForDomain(domain types.Domain, certificate []byte, key []byte) { p.certsChan <- &Certificate{Certificate: certificate, Key: key, Domain: domain} } // deleteUnnecessaryDomains deletes from the configuration : // - Duplicated domains // - Domains which are checked by wildcard domain func (p *Provider) deleteUnnecessaryDomains() { var newDomains []types.Domain for idxDomainToCheck, domainToCheck := range p.Domains { keepDomain := true for idxDomain, domain := range p.Domains { if idxDomainToCheck == idxDomain { continue } if reflect.DeepEqual(domain, domainToCheck) { if idxDomainToCheck > idxDomain { log.Warnf("The domain %v is duplicated in the configuration but will be process by ACME provider only once.", domainToCheck) keepDomain = false } break } // Check if CN or SANS to check already exists // or can not be checked by a wildcard var newDomainsToCheck []string for _, domainProcessed := range domainToCheck.ToStrArray() { if idxDomain < idxDomainToCheck && isDomainAlreadyChecked(domainProcessed, domain.ToStrArray()) { // The domain is duplicated in a CN log.Warnf("Domain %q is duplicated in the configuration or validated by the domain %v. It will be processed once.", domainProcessed, domain) continue } else if domain.Main != domainProcessed && strings.HasPrefix(domain.Main, "*") && isDomainAlreadyChecked(domainProcessed, []string{domain.Main}) { // Check if a wildcard can validate the domain log.Warnf("Domain %q will not be processed by ACME provider because it is validated by the wildcard %q", domainProcessed, domain.Main) continue } newDomainsToCheck = append(newDomainsToCheck, domainProcessed) } // Delete the domain if both Main and SANs can be validated by the wildcard domain // otherwise keep the unchecked values if newDomainsToCheck == nil { keepDomain = false break } domainToCheck.Set(newDomainsToCheck) } if keepDomain { newDomains = append(newDomains, domainToCheck) } } p.Domains = newDomains } func (p *Provider) watchCertificate() { p.certsChan = make(chan *Certificate) p.pool.Go(func(stop chan bool) { for { select { case cert := <-p.certsChan: certUpdated := false for _, domainsCertificate := range p.certificates { if reflect.DeepEqual(cert.Domain, domainsCertificate.Domain) { domainsCertificate.Certificate = cert.Certificate domainsCertificate.Key = cert.Key certUpdated = true break } } if !certUpdated { p.certificates = append(p.certificates, cert) } err := p.saveCertificates() if err != nil { log.Error(err) } case <-stop: return } } }) } func (p *Provider) saveCertificates() error { err := p.Store.SaveCertificates(p.certificates) p.refreshCertificates() return err } func (p *Provider) refreshCertificates() { config := types.ConfigMessage{ ProviderName: "ACME", Configuration: &types.Configuration{ Backends: map[string]*types.Backend{}, Frontends: map[string]*types.Frontend{}, TLS: []*traefiktls.Configuration{}, }, } for _, cert := range p.certificates { certificate := &traefiktls.Certificate{CertFile: traefiktls.FileOrContent(cert.Certificate), KeyFile: traefiktls.FileOrContent(cert.Key)} config.Configuration.TLS = append(config.Configuration.TLS, &traefiktls.Configuration{Certificate: certificate, EntryPoints: []string{p.EntryPoint}}) } p.configurationChan <- config } func (p *Provider) renewCertificates() { log.Info("Testing certificate renew...") for _, certificate := range p.certificates { crt, err := getX509Certificate(certificate) // If there's an error, we assume the cert is broken, and needs update // <= 30 days left, renew certificate if err != nil || crt == nil || crt.NotAfter.Before(time.Now().Add(24*30*time.Hour)) { client, err := p.getClient() if err != nil { log.Infof("Error renewing certificate from LE : %+v, %v", certificate.Domain, err) continue } log.Infof("Renewing certificate from LE : %+v", certificate.Domain) renewedCert, err := client.RenewCertificate(acme.CertificateResource{ Domain: certificate.Domain.Main, PrivateKey: certificate.Key, Certificate: certificate.Certificate, }, true, OSCPMustStaple) if err != nil { log.Errorf("Error renewing certificate from LE: %v, %v", certificate.Domain, err) continue } if len(renewedCert.Certificate) == 0 || len(renewedCert.PrivateKey) == 0 { log.Errorf("domains %v renew certificate with no value: %v", certificate.Domain.ToStrArray(), certificate) continue } p.addCertificateForDomain(certificate.Domain, renewedCert.Certificate, renewedCert.PrivateKey) } } } // Get provided certificate which check a domains list (Main and SANs) // from static and dynamic provided certificates func (p *Provider) getUncheckedDomains(domainsToCheck []string, checkConfigurationDomains bool) []string { log.Debugf("Looking for provided certificate(s) to validate %q...", domainsToCheck) allDomains := p.certificateStore.GetAllDomains() // Get ACME certificates for _, certificate := range p.certificates { allDomains = append(allDomains, strings.Join(certificate.Domain.ToStrArray(), ",")) } // Get Configuration Domains if checkConfigurationDomains { for i := 0; i < len(p.Domains); i++ { allDomains = append(allDomains, strings.Join(p.Domains[i].ToStrArray(), ",")) } } return searchUncheckedDomains(domainsToCheck, allDomains) } func searchUncheckedDomains(domainsToCheck []string, existentDomains []string) []string { var uncheckedDomains []string for _, domainToCheck := range domainsToCheck { if !isDomainAlreadyChecked(domainToCheck, existentDomains) { uncheckedDomains = append(uncheckedDomains, domainToCheck) } } if len(uncheckedDomains) == 0 { log.Debugf("No ACME certificate to generate for domains %q.", domainsToCheck) } else { log.Debugf("Domains %q need ACME certificates generation for domains %q.", domainsToCheck, strings.Join(uncheckedDomains, ",")) } return uncheckedDomains } func getX509Certificate(certificate *Certificate) (*x509.Certificate, error) { tlsCert, err := tls.X509KeyPair(certificate.Certificate, certificate.Key) if err != nil { log.Errorf("Failed to load TLS keypair from ACME certificate for domain %q (SAN : %q), certificate will be renewed : %v", certificate.Domain.Main, strings.Join(certificate.Domain.SANs, ","), err) return nil, err } crt := tlsCert.Leaf if crt == nil { crt, err = x509.ParseCertificate(tlsCert.Certificate[0]) if err != nil { log.Errorf("Failed to parse TLS keypair from ACME certificate for domain %q (SAN : %q), certificate will be renewed : %v", certificate.Domain.Main, strings.Join(certificate.Domain.SANs, ","), err) } } return crt, err } // getValidDomains checks if given domain is allowed to generate a ACME certificate and return it func (p *Provider) getValidDomains(domain types.Domain, wildcardAllowed bool) ([]string, error) { domains := domain.ToStrArray() if len(domains) == 0 { return nil, errors.New("unable to generate a certificate in ACME provider when no domain is given") } if strings.HasPrefix(domain.Main, "*") { if !wildcardAllowed { return nil, fmt.Errorf("unable to generate a wildcard certificate in ACME provider for domain %q from a 'Host' rule", strings.Join(domains, ",")) } if p.DNSChallenge == nil { return nil, fmt.Errorf("unable to generate a wildcard certificate in ACME provider for domain %q : ACME needs a DNSChallenge", strings.Join(domains, ",")) } if strings.HasPrefix(domain.Main, "*.*") { return nil, fmt.Errorf("unable to generate a wildcard certificate in ACME provider for domain %q : ACME does not allow '*.*' wildcard domain", strings.Join(domains, ",")) } } for _, san := range domain.SANs { if strings.HasPrefix(san, "*") { return nil, fmt.Errorf("unable to generate a certificate in ACME provider for domains %q: SAN %q can not be a wildcard domain", strings.Join(domains, ","), san) } } domains = fun.Map(types.CanonicalDomain, domains).([]string) return domains, nil } func isDomainAlreadyChecked(domainToCheck string, existentDomains []string) bool { for _, certDomains := range existentDomains { for _, certDomain := range strings.Split(certDomains, ",") { if types.MatchDomain(domainToCheck, certDomain) { return true } } } return false }