acme

Documentation

Index

• Variables
• type ACME
  • func (a *ACME) CreateClusterConfig(leadership *cluster.Leadership, tlsConfig *tls.Config, ...) error
  • func (a *ACME) CreateLocalConfig(tlsConfig *tls.Config, checkOnDemandDomain func(domain string) bool) error
  • func (a *ACME) LoadCertificateForDomains(domains []string)
• type Account
  • func NewAccount(email string) (*Account, error)
  • func (a *Account) GetEmail() string
  • func (a *Account) GetPrivateKey() crypto.PrivateKey
  • func (a *Account) GetRegistration() *acme.RegistrationResource
  • func (a *Account) Init() error
• type Certificate
• type ChallengeCert
  • func TLSSNI01ChallengeCert(keyAuth string) (ChallengeCert, string, error)
• type Domain
• type Domains
  • func (ds *Domains) Get() interface{}
  • func (ds *Domains) Set(str string) error
  • func (ds *Domains) SetValue(val interface{})
  • func (ds *Domains) String() string
• type DomainsCertificate
• type DomainsCertificates
  • func (dc *DomainsCertificates) Init() error
  • func (dc *DomainsCertificates) Len() int
  • func (dc *DomainsCertificates) Less(i, j int) bool
  • func (dc *DomainsCertificates) Swap(i, j int)
• type LocalStore
  • func NewLocalStore(file string) *LocalStore
  • func (s *LocalStore) Begin() (cluster.Transaction, cluster.Object, error)
  • func (s *LocalStore) Get() cluster.Object
  • func (s *LocalStore) Load() (cluster.Object, error)

Variables

var (
	// OSCPMustStaple enables OSCP stapling as from https://github.com/xenolf/lego/issues/270
	OSCPMustStaple = false
)

Types

type ACME

type ACME struct {
	Email             string   `description:"Email address used for registration"`
	Domains           []Domain `` /* 162-byte string literal not displayed */
	Storage           string   `description:"File or key used for certificates storage."`
	StorageFile       string   // deprecated
	OnDemand          bool     `` /* 178-byte string literal not displayed */
	OnHostRule        bool     `description:"Enable certificate generation on frontends Host rules."`
	CAServer          string   `description:"CA server to use."`
	EntryPoint        string   `description:"Entrypoint to proxy acme challenge to."`
	DNSProvider       string   `description:"Use a DNS based challenge provider rather than HTTPS."`
	DelayDontCheckDNS int      `description:"Assume DNS propagates after a delay in seconds rather than finding and querying nameservers."`
	ACMELogging       bool     `description:"Enable debug logging of ACME actions."`

	TLSConfig *tls.Config `description:"TLS config in case wildcard certs are used"`
	// contains filtered or unexported fields
}

ACME allows to connect to lets encrypt and retrieve certs

func (*ACME) CreateClusterConfig

func (a *ACME) CreateClusterConfig(leadership *cluster.Leadership, tlsConfig *tls.Config, checkOnDemandDomain func(domain string) bool) error

CreateClusterConfig creates a tls.config using ACME configuration in cluster mode

func (*ACME) CreateLocalConfig

func (a *ACME) CreateLocalConfig(tlsConfig *tls.Config, checkOnDemandDomain func(domain string) bool) error

CreateLocalConfig creates a tls.config using local ACME configuration

func (*ACME) LoadCertificateForDomains

func (a *ACME) LoadCertificateForDomains(domains []string)

LoadCertificateForDomains loads certificates from ACME for given domains

type Account

type Account struct {
	Email              string
	Registration       *acme.RegistrationResource
	PrivateKey         []byte
	DomainsCertificate DomainsCertificates
	ChallengeCerts     map[string]*ChallengeCert
}

Account is used to store lets encrypt registration info

func NewAccount

func NewAccount(email string) (*Account, error)

NewAccount creates an account

func (*Account) GetEmail

func (a *Account) GetEmail() string

GetEmail returns email

func (*Account) GetPrivateKey

func (a *Account) GetPrivateKey() crypto.PrivateKey

GetPrivateKey returns private key

func (*Account) GetRegistration

func (a *Account) GetRegistration() *acme.RegistrationResource

GetRegistration returns lets encrypt registration resource

func (*Account) Init

func (a *Account) Init() error

Init inits account struct

type Certificate

type Certificate struct {
	Domain        string
	CertURL       string
	CertStableURL string
	PrivateKey    []byte
	Certificate   []byte
}

Certificate is used to store certificate info

type ChallengeCert

type ChallengeCert struct {
	Certificate []byte
	PrivateKey  []byte
	// contains filtered or unexported fields
}

ChallengeCert stores a challenge certificate

func TLSSNI01ChallengeCert

func TLSSNI01ChallengeCert(keyAuth string) (ChallengeCert, string, error)

TLSSNI01ChallengeCert returns a certificate and target domain for the `tls-sni-01` challenge

type Domain

type Domain struct {
	Main string
	SANs []string
}

Domain holds a domain name with SANs

type Domains

type Domains []Domain

Domains parse []Domain

func (*Domains) Get

func (ds *Domains) Get() interface{}

Get []Domain

func (*Domains) Set

func (ds *Domains) Set(str string) error

Set []Domain

func (*Domains) SetValue

func (ds *Domains) SetValue(val interface{})

SetValue sets []Domain into the parser

func (*Domains) String

func (ds *Domains) String() string

String returns []Domain in string

type DomainsCertificate

type DomainsCertificate struct {
	Domains     Domain
	Certificate *Certificate
	// contains filtered or unexported fields
}

DomainsCertificate contains a certificate for multiple domains

type DomainsCertificates

type DomainsCertificates struct {
	Certs []*DomainsCertificate
	// contains filtered or unexported fields
}

DomainsCertificates stores a certificate for multiple domains

func (*DomainsCertificates) Init

func (dc *DomainsCertificates) Init() error

Init inits DomainsCertificates

func (*DomainsCertificates) Len

func (dc *DomainsCertificates) Len() int

func (*DomainsCertificates) Less

func (dc *DomainsCertificates) Less(i, j int) bool

func (*DomainsCertificates) Swap

func (dc *DomainsCertificates) Swap(i, j int)

type LocalStore

type LocalStore struct {
	// contains filtered or unexported fields
}

LocalStore is a store using a file as storage

func NewLocalStore

func NewLocalStore(file string) *LocalStore

NewLocalStore create a LocalStore

func (*LocalStore) Begin

func (s *LocalStore) Begin() (cluster.Transaction, cluster.Object, error)

Begin creates a transaction with the KV store.

func (*LocalStore) Get

func (s *LocalStore) Get() cluster.Object

Get atomically a struct from the file storage

func (*LocalStore) Load

func (s *LocalStore) Load() (cluster.Object, error)

Load loads file into store