letsencrypt

Documentation

Index

• Constants
• type Account
  • func NewAccount(email string, apiVer ApiVersion, keyType lego.KeyType) (*Account, error)
  • func (a *Account) GetEmail() string
  • func (a *Account) GetPrivateKey() crypto.PrivateKey
  • func (a *Account) GetRegistration() *lego.RegistrationResource
  • func (a *Account) Save() error
• type AcmeCertificate
• type ApiVersion
• type Client
  • func NewClient(email string, kt KeyType, apiVer ApiVersion, provider ProviderOpts) (*Client, error)
  • func (c *Client) ApiVersion() string
  • func (c *Client) CertPath(certName string) string
  • func (c *Client) ConfigPath() string
  • func (c *Client) EnableDebug()
  • func (c *Client) GetStoredCertificate(certName string, domains []string) (bool, *AcmeCertificate)
  • func (c *Client) Issue(certName string, domains []string) (*AcmeCertificate, map[string]error)
  • func (c *Client) ProviderName() string
  • func (c *Client) Renew(certName string) (*AcmeCertificate, error)
• type KeyType
• type Provider
• type ProviderFactory
• type ProviderOpts

Constants

const (
	StorageDir       = "/etc/letsencrypt"
	ProductionApiUri = "https://acme-v01.api.letsencrypt.org/directory"
	StagingApiUri    = "https://acme-staging.api.letsencrypt.org/directory"
)

const (
	CLOUDFLARE   = Provider("CloudFlare")
	DIGITALOCEAN = Provider("DigitalOcean")
	ROUTE53      = Provider("Route53")
	DNSIMPLE     = Provider("DNSimple")
	DYN          = Provider("Dyn")
	VULTR        = Provider("Vultr")
	OVH          = Provider("Ovh")
	GANDI        = Provider("Gandi")
	HTTP         = Provider("HTTP")
)

Types

type Account

type Account struct {
	Email        string                     `json:"email"`
	Registration *lego.RegistrationResource `json:"registrations"`
	// contains filtered or unexported fields
}

func NewAccount

func NewAccount(email string, apiVer ApiVersion, keyType lego.KeyType) (*Account, error)

NewAccount creates a new or gets a stored LE account for the given email

func (*Account) GetEmail

func (a *Account) GetEmail() string

GetEmail returns the email address for the account

func (*Account) GetPrivateKey

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

GetPrivateKey returns the private RSA account key.

func (*Account) GetRegistration

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

GetRegistration returns the server registration

func (*Account) Save

func (a *Account) Save() error

Save the account to disk

type AcmeCertificate

type AcmeCertificate struct {
	lego.CertificateResource
	DnsNames     string    `json:"dnsNames"`
	ExpiryDate   time.Time `json:"expiryDate"`
	SerialNumber string    `json:"serialNumber"`
}

AcmeCertificate represents a CA issued certificate, PrivateKey and Certificate are both PEM encoded.

Anonymous fields: PrivateKey []byte Certificate []byte Domain string

type ApiVersion

type ApiVersion string

const (
	Production ApiVersion = "Production"
	Sandbox    ApiVersion = "Sandbox"
)

type Client

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

Client represents a Lets Encrypt client

func NewClient

func NewClient(email string, kt KeyType, apiVer ApiVersion, provider ProviderOpts) (*Client, error)

NewClient returns a new Lets Encrypt client

func (*Client) ApiVersion

func (c *Client) ApiVersion() string

func (*Client) CertPath

func (c *Client) CertPath(certName string) string

func (*Client) ConfigPath

func (c *Client) ConfigPath() string

func (*Client) EnableDebug

func (c *Client) EnableDebug()

EnableDebugLogging enables logging in the upstream lego library

func (*Client) GetStoredCertificate

func (c *Client) GetStoredCertificate(certName string, domains []string) (bool, *AcmeCertificate)

GetStoredCertificate returns the locally stored certificate for the given domains

func (*Client) Issue

func (c *Client) Issue(certName string, domains []string) (*AcmeCertificate, map[string]error)

Issue obtains a new SAN certificate from the Lets Encrypt CA

func (*Client) ProviderName

func (c *Client) ProviderName() string

func (*Client) Renew

func (c *Client) Renew(certName string) (*AcmeCertificate, error)

Renew renewes the given stored certificate

type KeyType

type KeyType string

const (
	RSA2048 KeyType = "RSA-2048"
	RSA4096 KeyType = "RSA-4096"
	RSA8192 KeyType = "RSA-8192"
	EC256   KeyType = "ECDSA-256"
	EC384   KeyType = "ECDSA-384"
)

type Provider

type Provider string

type ProviderFactory

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

type ProviderOpts

type ProviderOpts struct {
	Provider Provider

	// CloudFlare credentials
	CloudflareEmail string
	CloudflareKey   string

	// DigitalOcean credentials
	DoAccessToken string

	// AWS Route 53 credentials
	AwsAccessKey string
	AwsSecretKey string

	// DNSimple credentials
	DNSimpleEmail string
	DNSimpleKey   string

	// Dyn credentials
	DynCustomerName string
	DynUserName     string
	DynPassword     string

	// Vultr credentials
	VultrApiKey string

	// OVH credentials
	OvhApplicationKey    string
	OvhApplicationSecret string
	OvhConsumerKey       string

	// Gandi credentials
	GandiApiKey string
}

ProviderOpts is used to configure the DNS provider used by the Let's Encrypt client for domain validation