fortanix

Documentation

Index

• type APIKey
  • func (k APIKey) String() string
• type Config
• type Conn
  • func Connect(ctx context.Context, config *Config) (*Conn, error)
  • func (c *Conn) Create(ctx context.Context, name string, value []byte) error
  • func (c *Conn) Delete(ctx context.Context, name string) error
  • func (c *Conn) Get(ctx context.Context, name string) ([]byte, error)
  • func (c *Conn) List(ctx context.Context) (kms.Iter, error)
  • func (c *Conn) Status(ctx context.Context) (kms.State, error)

Types

type APIKey

type APIKey string

APIKey is a Fortanix API key for authenticating to a Fortanix SDKMS instance.

func (APIKey) String

func (k APIKey) String() string

String returns a string representation of the API key that can be sent to a Fortanix SDKMS as part of the request headers.

type Config

type Config struct {
	// Endpoint is the Fortanix SDKMS instance endpoint.
	Endpoint string

	// GroupID is ID of the Fortanix SDKMS group newly created
	// keys will belong to.
	//
	// Fortanix SDKMS uses groups as collection of (security) objects.
	// Typically, applications can access some/all objects within groups
	// the application is assigned to.
	GroupID string

	// APIKey is the application's Fortanix SDKMS API key used to authenticate
	// operations. It is sent on each request as part of the request headers.
	APIKey APIKey

	// CAPath is an optional path to a CA certificate or directory
	// containing CA certificates.
	//
	// If not empty, the KeyStore will use the specified CAs to
	// verify the Fortanix SDKMS server certificate.
	CAPath string
}

Config is a structure containing configuration options for connecting to a Fortanix SDKMS server.

type Conn

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

Conn is a connection to a Fortanix SDKMS server.

func Connect

func Connect(ctx context.Context, config *Config) (*Conn, error)

Connect establishes and returns a Conn to a Fortanix SDKMS server using the given config.

func (*Conn) Create

func (c *Conn) Create(ctx context.Context, name string, value []byte) error

Create stors the given key at the Fortanix SDKMS if and only if no entry with the given name exists.

If no such entry exists, Create returns kes.ErrKeyExists.

func (*Conn) Delete

func (c *Conn) Delete(ctx context.Context, name string) error

Delete deletes the key associated with the given name from the Fortanix SDKMS. It may not return an error if no entry for the given name exists.

func (*Conn) Get

func (c *Conn) Get(ctx context.Context, name string) ([]byte, error)

Get returns the key associated with the given name.

If there is no such entry, Get returns kes.ErrKeyNotFound.

func (*Conn) List

func (c *Conn) List(ctx context.Context) (kms.Iter, error)

List returns a new Iterator over the Fortanix SDKMS keys.

The returned iterator may or may not reflect any concurrent changes to the Fortanix SDKMS instance - i.e. creates or deletes. Further, it does not provide any ordering guarantees.

func (*Conn) Status

func (c *Conn) Status(ctx context.Context) (kms.State, error)

Status returns the current state of the Fortanix SDKMS instance. In particular, whether it is reachable and the network latency.