client

Documentation

Index

• func NewInstrumentedClient(next *http.Client) *http.Client
• type FakeACME
  • func (f *FakeACME) AcceptChallenge(ctx context.Context, chal *acme.Challenge) (*acme.Challenge, error)
  • func (f *FakeACME) CreateAccount(ctx context.Context, a *acme.Account) (*acme.Account, error)
  • func (f *FakeACME) CreateOrder(ctx context.Context, order *acme.Order) (*acme.Order, error)
  • func (f *FakeACME) DNS01ChallengeRecord(token string) (string, error)
  • func (f *FakeACME) Discover(ctx context.Context) (acme.Directory, error)
  • func (f *FakeACME) FinalizeOrder(ctx context.Context, finalizeURL string, csr []byte) (der [][]byte, err error)
  • func (f *FakeACME) GetAccount(ctx context.Context) (*acme.Account, error)
  • func (f *FakeACME) GetAuthorization(ctx context.Context, url string) (*acme.Authorization, error)
  • func (f *FakeACME) GetCertificate(ctx context.Context, url string) ([][]byte, error)
  • func (f *FakeACME) GetChallenge(ctx context.Context, url string) (*acme.Challenge, error)
  • func (f *FakeACME) GetOrder(ctx context.Context, url string) (*acme.Order, error)
  • func (f *FakeACME) HTTP01ChallengeResponse(token string) (string, error)
  • func (f *FakeACME) UpdateAccount(ctx context.Context, a *acme.Account) (*acme.Account, error)
  • func (f *FakeACME) WaitAuthorization(ctx context.Context, url string) (*acme.Authorization, error)
  • func (f *FakeACME) WaitOrder(ctx context.Context, url string) (*acme.Order, error)
• type Interface
• type Transport
  • func (it *Transport) RoundTrip(req *http.Request) (*http.Response, error)

Functions

func NewInstrumentedClient

func NewInstrumentedClient(next *http.Client) *http.Client

NewInstrumentedClient takes a *http.Client and returns a *http.Client that has its RoundTripper wrapped with instrumentation.

Types

type FakeACME

type FakeACME struct {
	FakeCreateOrder             func(ctx context.Context, order *acme.Order) (*acme.Order, error)
	FakeGetOrder                func(ctx context.Context, url string) (*acme.Order, error)
	FakeGetCertificate          func(ctx context.Context, url string) ([][]byte, error)
	FakeWaitOrder               func(ctx context.Context, url string) (*acme.Order, error)
	FakeFinalizeOrder           func(ctx context.Context, finalizeURL string, csr []byte) (der [][]byte, err error)
	FakeAcceptChallenge         func(ctx context.Context, chal *acme.Challenge) (*acme.Challenge, error)
	FakeGetChallenge            func(ctx context.Context, url string) (*acme.Challenge, error)
	FakeGetAuthorization        func(ctx context.Context, url string) (*acme.Authorization, error)
	FakeWaitAuthorization       func(ctx context.Context, url string) (*acme.Authorization, error)
	FakeCreateAccount           func(ctx context.Context, a *acme.Account) (*acme.Account, error)
	FakeGetAccount              func(ctx context.Context) (*acme.Account, error)
	FakeHTTP01ChallengeResponse func(token string) (string, error)
	FakeDNS01ChallengeRecord    func(token string) (string, error)
	FakeDiscover                func(ctx context.Context) (acme.Directory, error)
	FakeUpdateAccount           func(ctx context.Context, a *acme.Account) (*acme.Account, error)
}

FakeACME is a convenience structure to create a stub ACME implementation

func (*FakeACME) AcceptChallenge

func (f *FakeACME) AcceptChallenge(ctx context.Context, chal *acme.Challenge) (*acme.Challenge, error)

func (*FakeACME) CreateAccount

func (f *FakeACME) CreateAccount(ctx context.Context, a *acme.Account) (*acme.Account, error)

func (*FakeACME) CreateOrder

func (f *FakeACME) CreateOrder(ctx context.Context, order *acme.Order) (*acme.Order, error)

func (*FakeACME) DNS01ChallengeRecord

func (f *FakeACME) DNS01ChallengeRecord(token string) (string, error)

func (*FakeACME) Discover

func (f *FakeACME) Discover(ctx context.Context) (acme.Directory, error)

func (*FakeACME) FinalizeOrder

func (f *FakeACME) FinalizeOrder(ctx context.Context, finalizeURL string, csr []byte) (der [][]byte, err error)

func (*FakeACME) GetAccount

func (f *FakeACME) GetAccount(ctx context.Context) (*acme.Account, error)

func (*FakeACME) GetAuthorization

func (f *FakeACME) GetAuthorization(ctx context.Context, url string) (*acme.Authorization, error)

func (*FakeACME) GetCertificate

func (f *FakeACME) GetCertificate(ctx context.Context, url string) ([][]byte, error)

func (*FakeACME) GetChallenge

func (f *FakeACME) GetChallenge(ctx context.Context, url string) (*acme.Challenge, error)

func (*FakeACME) GetOrder

func (f *FakeACME) GetOrder(ctx context.Context, url string) (*acme.Order, error)

func (*FakeACME) HTTP01ChallengeResponse

func (f *FakeACME) HTTP01ChallengeResponse(token string) (string, error)

func (*FakeACME) UpdateAccount

func (f *FakeACME) UpdateAccount(ctx context.Context, a *acme.Account) (*acme.Account, error)

func (*FakeACME) WaitAuthorization

func (f *FakeACME) WaitAuthorization(ctx context.Context, url string) (*acme.Authorization, error)

func (*FakeACME) WaitOrder

func (f *FakeACME) WaitOrder(ctx context.Context, url string) (*acme.Order, error)

type Interface

type Interface interface {
	CreateOrder(ctx context.Context, order *acme.Order) (*acme.Order, error)
	GetOrder(ctx context.Context, url string) (*acme.Order, error)
	GetCertificate(ctx context.Context, url string) ([][]byte, error)
	WaitOrder(ctx context.Context, url string) (*acme.Order, error)
	FinalizeOrder(ctx context.Context, finalizeURL string, csr []byte) (der [][]byte, err error)
	AcceptChallenge(ctx context.Context, chal *acme.Challenge) (*acme.Challenge, error)
	GetChallenge(ctx context.Context, url string) (*acme.Challenge, error)
	GetAuthorization(ctx context.Context, url string) (*acme.Authorization, error)
	WaitAuthorization(ctx context.Context, url string) (*acme.Authorization, error)
	CreateAccount(ctx context.Context, a *acme.Account) (*acme.Account, error)
	GetAccount(ctx context.Context) (*acme.Account, error)
	HTTP01ChallengeResponse(token string) (string, error)
	DNS01ChallengeRecord(token string) (string, error)
	Discover(ctx context.Context) (acme.Directory, error)
	UpdateAccount(ctx context.Context, a *acme.Account) (*acme.Account, error)
}

type Transport

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

Transport is a http.RoundTripper that collects Prometheus metrics of every request it processes. It allows to be configured with callbacks that process request path and query into a suitable label value.

func (*Transport) RoundTrip

func (it *Transport) RoundTrip(req *http.Request) (*http.Response, error)

RoundTrip implements http.RoundTripper. It forwards the request to the next RoundTripper and measures the time it took in Prometheus summary.