store

type ErrMaliciousServer ¶

type ErrMaliciousServer struct{}

ErrMaliciousServer indicates the server returned a response that is highly suspected of being malicious. i.e. it attempted to send us more data than the known size of a particular role metadata.

func (err ErrMaliciousServer) Error() string

type ErrMetaNotFound ¶

type ErrMetaNotFound struct{}

ErrMetaNotFound indicates we did not find a particular piece of metadata in the store

func (err ErrMetaNotFound) Error() string

type ErrServerUnavailable ¶

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

ErrServerUnavailable indicates an error from the server. code allows us to populate the http error we received

func (err ErrServerUnavailable) Error() string

type FilesystemStore ¶

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

FilesystemStore is a store in a locally accessible directory

func NewFilesystemStore(baseDir, metaSubDir, metaExtension, targetsSubDir string) (*FilesystemStore, error)

func (f *FilesystemStore) GetMeta(name string, size int64) ([]byte, error)

func (f *FilesystemStore) SetMeta(name string, meta []byte) error

func (f *FilesystemStore) SetMultiMeta(metas map[string][]byte) error

type HTTPStore ¶

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

HTTPStore manages pulling and pushing metadata from and to a remote service over HTTP. It assumes the URL structure of the remote service maps identically to the structure of the TUF repo: <baseURL>/<metaPrefix>/(root|targets|snapshot|timestamp).json <baseURL>/<targetsPrefix>/foo.sh

If consistent snapshots are disabled, it is advised that caching is not enabled. Simple set a cachePath (and ensure it's writeable) to enable caching.

func (s HTTPStore) GetKey(role string) ([]byte, error)

func (s HTTPStore) GetMeta(name string, size int64) ([]byte, error)

func (s HTTPStore) GetTarget(path string) (io.ReadCloser, error)

func (s HTTPStore) SetMeta(name string, blob []byte) error

func (s HTTPStore) SetMultiMeta(metas map[string][]byte) error

type LocalStore ¶

type LocalStore interface {
	MetadataStore
	TargetStore
}

LocalStore represents a local TUF sture

type MetadataStore ¶

type MetadataStore interface {
	GetMeta(name string, size int64) ([]byte, error)
	SetMeta(name string, blob []byte) error
	SetMultiMeta(map[string][]byte) error
}

MetadataStore must be implemented by anything that intends to interact with a store of TUF files

type PublicKeyStore ¶

type PublicKeyStore interface {
	GetKey(role string) ([]byte, error)
}

PublicKeyStore must be implemented by a key service

type RemoteStore ¶

type RemoteStore interface {
	MetadataStore
	PublicKeyStore
	GetTarget(path string) (io.ReadCloser, error)
}

RemoteStore is similar to LocalStore with the added expectation that it should provide a way to download targets once located

func NewHTTPStore(baseURL, metaPrefix, metaExtension, targetsPrefix, keyExtension string, roundTrip http.RoundTripper) (RemoteStore, error)

func NewMemoryStore(meta map[string][]byte, files map[string][]byte) RemoteStore

type TargetStore ¶

type TargetStore interface {
	WalkStagedTargets(paths []string, targetsFn targetsWalkFunc) error
}

TargetStore represents a collection of targets that can be walked similarly to walking a directory, passing a callback that receives the path and meta for each target