wfe

Documentation

Index

• Constants
• type BodylessResponseWriter
  • func (mrw BodylessResponseWriter) Write(buf []byte) (int, error)
• type WebFrontEndImpl
  • func NewWebFrontEndImpl() (WebFrontEndImpl, error)
  • func (wfe *WebFrontEndImpl) Authorization(response http.ResponseWriter, request *http.Request)
  • func (wfe *WebFrontEndImpl) BuildID(response http.ResponseWriter, request *http.Request)
  • func (wfe *WebFrontEndImpl) Certificate(response http.ResponseWriter, request *http.Request)
  • func (wfe *WebFrontEndImpl) Directory(response http.ResponseWriter, request *http.Request)
  • func (wfe *WebFrontEndImpl) HandleFunc(mux *http.ServeMux, pattern string, h func(http.ResponseWriter, *http.Request), ...)
  • func (wfe *WebFrontEndImpl) Handler() (http.Handler, error)
  • func (wfe *WebFrontEndImpl) Index(response http.ResponseWriter, request *http.Request)
  • func (wfe *WebFrontEndImpl) Issuer(response http.ResponseWriter, request *http.Request)
  • func (wfe *WebFrontEndImpl) NewAuthorization(response http.ResponseWriter, request *http.Request)
  • func (wfe *WebFrontEndImpl) NewCertificate(response http.ResponseWriter, request *http.Request)
  • func (wfe *WebFrontEndImpl) NewRegistration(response http.ResponseWriter, request *http.Request)
  • func (wfe *WebFrontEndImpl) Registration(response http.ResponseWriter, request *http.Request)
  • func (wfe *WebFrontEndImpl) RevokeCertificate(response http.ResponseWriter, request *http.Request)
  • func (wfe *WebFrontEndImpl) Terms(response http.ResponseWriter, request *http.Request)

Constants

const (
	DirectoryPath  = "/directory"
	NewRegPath     = "/acme/new-reg"
	RegPath        = "/acme/reg/"
	NewAuthzPath   = "/acme/new-authz"
	AuthzPath      = "/acme/authz/"
	NewCertPath    = "/acme/new-cert"
	CertPath       = "/acme/cert/"
	RevokeCertPath = "/acme/revoke-cert"
	TermsPath      = "/terms"
	IssuerPath     = "/acme/issuer-cert"
	BuildIDPath    = "/build"
)

Paths are the ACME-spec identified URL path-segments for various methods

Types

type BodylessResponseWriter

type BodylessResponseWriter struct {
	http.ResponseWriter
}

BodylessResponseWriter wraps http.ResponseWriter, discarding anything written to the body.

func (BodylessResponseWriter) Write

func (mrw BodylessResponseWriter) Write(buf []byte) (int, error)

type WebFrontEndImpl

type WebFrontEndImpl struct {
	RA    core.RegistrationAuthority
	SA    core.StorageGetter
	Stats statsd.Statter

	// URL configuration parameters
	BaseURL   string
	NewReg    string
	RegBase   string
	NewAuthz  string
	AuthzBase string
	NewCert   string
	CertBase  string

	// JSON encoded endpoint directory
	DirectoryJSON []byte

	// Issuer certificate (DER) for /acme/issuer-cert
	IssuerCert []byte

	// URL to the current subscriber agreement (should contain some version identifier)
	SubscriberAgreementURL string

	// Cache settings
	CertCacheDuration           time.Duration
	CertNoCacheExpirationWindow time.Duration
	IndexCacheDuration          time.Duration
	IssuerCacheDuration         time.Duration
	// contains filtered or unexported fields
}

func NewWebFrontEndImpl

func NewWebFrontEndImpl() (WebFrontEndImpl, error)

NewWebFrontEndImpl constructs a web service for Boulder

func (*WebFrontEndImpl) Authorization

func (wfe *WebFrontEndImpl) Authorization(response http.ResponseWriter, request *http.Request)

Authorization is used by clients to submit an update to one of their authorizations.

func (*WebFrontEndImpl) BuildID

func (wfe *WebFrontEndImpl) BuildID(response http.ResponseWriter, request *http.Request)

BuildID tells the requestor what build we're running.

func (*WebFrontEndImpl) Certificate

func (wfe *WebFrontEndImpl) Certificate(response http.ResponseWriter, request *http.Request)

Certificate is used by clients to request a copy of their current certificate, or to request a reissuance of the certificate.

func (*WebFrontEndImpl) Directory

func (wfe *WebFrontEndImpl) Directory(response http.ResponseWriter, request *http.Request)

func (*WebFrontEndImpl) HandleFunc

func (wfe *WebFrontEndImpl) HandleFunc(mux *http.ServeMux, pattern string, h func(http.ResponseWriter, *http.Request), methods ...string)

HandleFunc registers a handler at the given path. It's http.HandleFunc(), but with a wrapper around the handler that provides some generic per-request functionality:

* Set a Replay-Nonce header.

• Respond http.StatusMethodNotAllowed for HTTP methods other than those listed.

• Never send a body in response to a HEAD request. (Anything written by the handler will be discarded if the method is HEAD.)

func (*WebFrontEndImpl) Handler

func (wfe *WebFrontEndImpl) Handler() (http.Handler, error)

Handler returns an http.Handler that uses various functions for various ACME-specified paths.

func (*WebFrontEndImpl) Index

func (wfe *WebFrontEndImpl) Index(response http.ResponseWriter, request *http.Request)

Index serves a simple identification page. It is not part of the ACME spec.

func (*WebFrontEndImpl) Issuer

func (wfe *WebFrontEndImpl) Issuer(response http.ResponseWriter, request *http.Request)

Issuer obtains the issuer certificate used by this instance of Boulder.

func (*WebFrontEndImpl) NewAuthorization

func (wfe *WebFrontEndImpl) NewAuthorization(response http.ResponseWriter, request *http.Request)

NewAuthorization is used by clients to submit a new ID Authorization

func (*WebFrontEndImpl) NewCertificate

func (wfe *WebFrontEndImpl) NewCertificate(response http.ResponseWriter, request *http.Request)

NewCertificate is used by clients to request the issuance of a cert for an authorized identifier.

func (*WebFrontEndImpl) NewRegistration

func (wfe *WebFrontEndImpl) NewRegistration(response http.ResponseWriter, request *http.Request)

NewRegistration is used by clients to submit a new registration/account

func (*WebFrontEndImpl) Registration

func (wfe *WebFrontEndImpl) Registration(response http.ResponseWriter, request *http.Request)

Registration is used by a client to submit an update to their registration.

func (*WebFrontEndImpl) RevokeCertificate

func (wfe *WebFrontEndImpl) RevokeCertificate(response http.ResponseWriter, request *http.Request)

RevokeCertificate is used by clients to request the revocation of a cert.

func (*WebFrontEndImpl) Terms

func (wfe *WebFrontEndImpl) Terms(response http.ResponseWriter, request *http.Request)

Terms is used by the client to obtain the current Terms of Service / Subscriber Agreement to which the subscriber must agree.