Help us shape the future of Go! Take the 2026 Go Developer Survey

Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

client

package

Go to main page

Versions in this module

v0

v0.2.0

Nov 2, 2026

v0.1.1

Oct 18, 2026

Changes in this version

+ type StatusError struct

+ Body string

+ Code int

+ Status string

+ func (e *StatusError) Error() string

v0.1.0

Oct 15, 2026

Changes in this version

+ const MaxBodyBytes

+ var DefaultEnrollBackoff = Backoff

+ var ErrBodyTooLarge = errors.New("control plane answer exceeds the body cap")

+ var ErrNotFound = errors.New("control plane does not serve this endpoint")

+ func DoWithChallenge(httpClient *http.Client, now func() time.Time, ...) (*http.Response, error)

+ func DoWithChallengeRetry(ctx context.Context, httpClient *http.Client, now func() time.Time, b Backoff, ...) (*http.Response, error)

+ func NewHTTPClient(timeout time.Duration, allowInsecure func() bool, component string) *http.Client

+ func ReadBody(r io.Reader) ([]byte, error)

+ func SetChallengeHeaders(req *http.Request, priv crypto.PrivKey, payload []byte, ts int64) error

+ type Backoff struct

+ Budget time.Duration

+ Initial time.Duration

+ Max time.Duration

+ type Client struct

+ func New(baseURL string, httpClient *http.Client) *Client

+ func (c *Client) ExchangeToken(ctx context.Context, biscuit []byte, req *api.TokenExchangeRequest) (*api.TokenExchangeResponse, error)

+ func (c *Client) FetchEgress(ctx context.Context, biscuit []byte) (*api.EgressAssignmentsResponse, error)

+ func (c *Client) FetchInfo(ctx context.Context) (*api.ControlPlaneInfoResponse, error)

+ func (c *Client) FetchKeys(ctx context.Context, trusted []ed25519.PublicKey) ([]ed25519.PublicKey, error)

+ func (c *Client) FetchPolicy(ctx context.Context, biscuit []byte) (*api.PolicyConfigGetResponse, error)

+ func (c *Client) FetchRevocations(ctx context.Context, biscuit []byte) (*api.RevocationsResponse, error)

+ func (c *Client) MintSTSToken(ctx context.Context, biscuit []byte, req *api.STSTokenRequest) (*api.STSTokenResponse, error)

+ func (c *Client) ReportCatalog(ctx context.Context, biscuit []byte, services []*api.ServiceInfo) error

+ func (c *Client) WithClock(now func() time.Time) *Client

+ func (c *Client) WithIdentity(peerID string, priv crypto.PrivKey) *Client

+ type FileTokenSource struct

+ func NewFileTokenSource(path string) *FileTokenSource

+ func (s *FileTokenSource) FetchToken(_ context.Context) (string, error)

+ type TokenSource interface

+ FetchToken func(ctx context.Context) (string, error)

v0.1.0-rc.10

Oct 14, 2026