ordermanager

Documentation

Index

• Constants
• Variables
• type Interface
  • func New(ctx context.Context, cb OrderUpCallback, chlr challenger.Interface) (Interface, error)
• type OrderUpCallback

Constants

const (
	// Staging is the Let's Encrypt staging endpoint, which provides significantly
	// higher quotas for use during development, but issues certificates that are
	// not signed by it's root CA.
	Staging = "https://acme-staging-v02.api.letsencrypt.org/directory"

	// Production is the Let's Encrypt production endpoint, which issues certificates
	// signed by their root CA.  This allows ~50 certificates to be issued per
	// registered domain per week.
	Production = autocert.DefaultACMEDirectory
)

Variables

var (
	// Endpoint is the ACME API to use, it defaults to Production, but
	// can be pointed at Staging or other compatible endpoints.
	Endpoint = Production

	// UserAgent is the HTTP user agent that is used with the ACME client,
	// so that traffic from this client may be distinguished from others.
	// It is intentionally exposed as a mutable variable in case users with
	// to distinguish their traffic further.
	UserAgent = "knative.dev/net-http01"
)

var ErrHTTP01Unavailable = errors.New("The CA didn't list HTTP01 as a viable certificate challenge.")

ErrHTTP01Unavailable is the error returned when the HTTP01 challenge option isn't available in the order we receive.

Types

type Interface

type Interface interface {
	Order(ctx context.Context, domains []string, owner interface{}) (challenges []*apis.URL, cert *tls.Certificate, err error)
}

Interface defines the interface for ordering new certificates.

func New

func New(ctx context.Context, cb OrderUpCallback, chlr challenger.Interface) (Interface, error)

New creates a new OrderManager.

type OrderUpCallback

type OrderUpCallback func(owner interface{})

OrderUpCallback is the signature of the function for notifying owners that their order is up, and that they should invoke Order again to pick it up.