clients

Documentation

Overview

Package clients defines API clients for interacting with select APIs.

Index

• func RunEndToEnd(ctx context.Context, cfg *config.E2ERunnerConfig) error
• type APIServerClient
  • func NewAPIServerClient(base, apiKey string, opts ...Option) (*APIServerClient, error)
  • func (c *APIServerClient) Certificate(ctx context.Context, in *api.VerificationCertificateRequest) (*api.VerificationCertificateResponse, error)
  • func (c *APIServerClient) Verify(ctx context.Context, in *api.VerifyCodeRequest) (*api.VerifyCodeResponse, error)
• type AdminAPIServerClient
  • func NewAdminAPIServerClient(base, apiKey string, opts ...Option) (*AdminAPIServerClient, error)
  • func (c *AdminAPIServerClient) BatchIssueCode(ctx context.Context, in *api.BatchIssueCodeRequest) (*api.BatchIssueCodeResponse, error)
  • func (c *AdminAPIServerClient) CheckCodeStatus(ctx context.Context, in *api.CheckCodeStatusRequest) (*api.CheckCodeStatusResponse, error)
  • func (c *AdminAPIServerClient) IssueCode(ctx context.Context, in *api.IssueCodeRequest) (*api.IssueCodeResponse, error)
• type AndroidTarget
• type App
• type AppSyncClient
  • func NewAppSyncClient(base string, opts ...Option) (*AppSyncClient, error)
  • func (c *AppSyncClient) AppSync(ctx context.Context) (*AppsResponse, error)
• type AppsResponse
• type ENXRedirectClient
  • func NewENXRedirectClient(base string, opts ...Option) (*ENXRedirectClient, error)
  • func (c *ENXRedirectClient) AndroidAssetLinks(ctx context.Context) ([]*api.AndroidDataResponse, error)
  • func (c *ENXRedirectClient) AppleSiteAssociation(ctx context.Context) (*api.IOSDataResponse, error)
  • func (c *ENXRedirectClient) CheckRedirect(ctx context.Context, userAgent string) (*http.Response, error)
  • func (c *ENXRedirectClient) RunE2E(ctx context.Context) error
• type KeyServerClient
  • func NewKeyServerClient(base string, opts ...Option) (*KeyServerClient, error)
  • func (c *KeyServerClient) Publish(ctx context.Context, in *keyserver.Publish) (*keyserver.PublishResponse, error)
  • func (c *KeyServerClient) Stats(ctx context.Context, in *keyserver.StatsRequest, authToken string) (*keyserver.StatsResponse, error)
• type Option
  • func WithHostOverride(host string) Option
  • func WithMaxBodySize(max int64) Option
  • func WithTimeout(d time.Duration) Option

Functions

func RunEndToEnd

func RunEndToEnd(ctx context.Context, cfg *config.E2ERunnerConfig) error

RunEndToEnd - code that exercises the verification and key server, simulating a mobile device uploading TEKs.

Types

type APIServerClient

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

APIServerClient is a client that talks to a device API server.

func NewAPIServerClient

func NewAPIServerClient(base, apiKey string, opts ...Option) (*APIServerClient, error)

NewAPIServerClient creates a new API server http client.

func (*APIServerClient) Certificate

func (c *APIServerClient) Certificate(ctx context.Context, in *api.VerificationCertificateRequest) (*api.VerificationCertificateResponse, error)

Certificate calls the /certificate endpoint to exchange a token for a certificate.

func (*APIServerClient) Verify

func (c *APIServerClient) Verify(ctx context.Context, in *api.VerifyCodeRequest) (*api.VerifyCodeResponse, error)

Verify calls the /verify endpoint to convert a code into a token.

type AdminAPIServerClient

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

AdminAPIServerClient is a client that talks to an admin API server.

func NewAdminAPIServerClient

func NewAdminAPIServerClient(base, apiKey string, opts ...Option) (*AdminAPIServerClient, error)

NewAdminAPIServerClient creates a new admin API server http client.

func (*AdminAPIServerClient) BatchIssueCode

func (c *AdminAPIServerClient) BatchIssueCode(ctx context.Context, in *api.BatchIssueCodeRequest) (*api.BatchIssueCodeResponse, error)

BatchIssueCode calls the /batch-issue endpoint. Callers must check the HTTP response code.

func (*AdminAPIServerClient) CheckCodeStatus

func (c *AdminAPIServerClient) CheckCodeStatus(ctx context.Context, in *api.CheckCodeStatusRequest) (*api.CheckCodeStatusResponse, error)

CheckCodeStatus uses the Admin API to retrieve the status of an OTP code.

func (*AdminAPIServerClient) IssueCode

func (c *AdminAPIServerClient) IssueCode(ctx context.Context, in *api.IssueCodeRequest) (*api.IssueCodeResponse, error)

IssueCode calls the /issue endpoint. Callers must check the HTTP response code.

type AndroidTarget

type AndroidTarget struct {
	Namespace              string `json:"namespace"`
	AppName                string `json:"app_name,omitempty"`
	PackageName            string `json:"package_name"`
	SHA256CertFingerprints string `json:"sha256_cert_fingerprints"`
}

AndroidTarget holds the android metadata for an App of AppResponse.

type App

type App struct {
	Region        string `json:"region"`
	IsEnx         bool   `json:"is_enx,omitempty"`
	AndroidTarget `json:"android_target"`
}

App represents single app for the AppResponse body.

type AppSyncClient

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

AppSyncClient is a client that talks to the appsync service.

func NewAppSyncClient

func NewAppSyncClient(base string, opts ...Option) (*AppSyncClient, error)

NewAppSyncClient creates a new app sync service http client.

func (*AppSyncClient) AppSync

func (c *AppSyncClient) AppSync(ctx context.Context) (*AppsResponse, error)

AppSync triggers an application sync.

type AppsResponse

type AppsResponse struct {
	Apps []App `json:"apps"`
}

AppsResponse is the body for the published list of android apps.

type ENXRedirectClient

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

ENXRedirectClient is a client that talks to the enx-redirect service.

func NewENXRedirectClient

func NewENXRedirectClient(base string, opts ...Option) (*ENXRedirectClient, error)

NewENXRedirectClient creates a new enx-redirect service http client.

func (*ENXRedirectClient) AndroidAssetLinks

func (c *ENXRedirectClient) AndroidAssetLinks(ctx context.Context) ([]*api.AndroidDataResponse, error)

AndroidAssetLinks calls and parses the Android assetlinks file.

func (*ENXRedirectClient) AppleSiteAssociation

func (c *ENXRedirectClient) AppleSiteAssociation(ctx context.Context) (*api.IOSDataResponse, error)

AppleSiteAssociation calls and parses the Apple site association file.

func (*ENXRedirectClient) CheckRedirect

func (c *ENXRedirectClient) CheckRedirect(ctx context.Context, userAgent string) (*http.Response, error)

CheckRedirect processes the redirect. It returns the http response. It does not follow any redirects or check the response status.

func (*ENXRedirectClient) RunE2E

func (c *ENXRedirectClient) RunE2E(ctx context.Context) error

RunE2E uses the client to exercise an end-to-end test of the ENX redirector.

type KeyServerClient

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

KeyServerClient is a client that talks to the key-server

func NewKeyServerClient

func NewKeyServerClient(base string, opts ...Option) (*KeyServerClient, error)

NewKeyServerClient creates a new key-server http client.

func (*KeyServerClient) Publish

func (c *KeyServerClient) Publish(ctx context.Context, in *keyserver.Publish) (*keyserver.PublishResponse, error)

Publish uploads TEKs to the key server

func (*KeyServerClient) Stats

func (c *KeyServerClient) Stats(ctx context.Context, in *keyserver.StatsRequest, authToken string) (*keyserver.StatsResponse, error)

Stats calls the /v1/stats endpoint to get key-server statistics.

type Option

type Option func(c *client) *client

Option is a customization option for the client.

func WithHostOverride

func WithHostOverride(host string) Option

WithHostOverride creates a new client that overrides the Host header.

func WithMaxBodySize

func WithMaxBodySize(max int64) Option

WithMaxBodySize sets a custom max body size for each request. The default is 64kib.

func WithTimeout

func WithTimeout(d time.Duration) Option

WithTimeout sets a custom timeout for each request. The default is 5s.