97a6346da0
Most of our objects use int64 timestamps derived from `UnixNano()` instead of `time.Time` objects. Switch the keyring metadata to use `UnixNano()` for consistency across the API.
102 lines
2.6 KiB
Go
102 lines
2.6 KiB
Go
package api
|
|
|
|
import (
|
|
"fmt"
|
|
"net/url"
|
|
)
|
|
|
|
// Keyring is used to access the Secure Variables keyring
|
|
type Keyring struct {
|
|
client *Client
|
|
}
|
|
|
|
// Keyring returns a handle to the Keyring endpoint
|
|
func (c *Client) Keyring() *Keyring {
|
|
return &Keyring{client: c}
|
|
}
|
|
|
|
// EncryptionAlgorithm chooses which algorithm is used for
|
|
// encrypting / decrypting entries with this key
|
|
type EncryptionAlgorithm string
|
|
|
|
const (
|
|
EncryptionAlgorithmAES256GCM EncryptionAlgorithm = "aes256-gcm"
|
|
)
|
|
|
|
// RootKey wraps key metadata and the key itself. The key must be
|
|
// base64 encoded
|
|
type RootKey struct {
|
|
Meta *RootKeyMeta
|
|
Key string
|
|
}
|
|
|
|
// RootKeyMeta is the metadata used to refer to a RootKey.
|
|
type RootKeyMeta struct {
|
|
KeyID string // UUID
|
|
Algorithm EncryptionAlgorithm
|
|
CreateTime int64
|
|
CreateIndex uint64
|
|
ModifyIndex uint64
|
|
State RootKeyState
|
|
}
|
|
|
|
// RootKeyState enum describes the lifecycle of a root key.
|
|
type RootKeyState string
|
|
|
|
const (
|
|
RootKeyStateInactive RootKeyState = "inactive"
|
|
RootKeyStateActive = "active"
|
|
RootKeyStateRekeying = "rekeying"
|
|
RootKeyStateDeprecated = "deprecated"
|
|
)
|
|
|
|
// List lists all the keyring metadata
|
|
func (k *Keyring) List(q *QueryOptions) ([]*RootKeyMeta, *QueryMeta, error) {
|
|
var resp []*RootKeyMeta
|
|
qm, err := k.client.query("/v1/operator/keyring/keys", &resp, q)
|
|
if err != nil {
|
|
return nil, nil, err
|
|
}
|
|
return resp, qm, nil
|
|
}
|
|
|
|
// Delete deletes a specific inactive key from the keyring
|
|
func (k *Keyring) Delete(opts *KeyringDeleteOptions, w *WriteOptions) (*WriteMeta, error) {
|
|
wm, err := k.client.delete(fmt.Sprintf("/v1/operator/keyring/key/%v",
|
|
url.PathEscape(opts.KeyID)), nil, nil, w)
|
|
return wm, err
|
|
}
|
|
|
|
// KeyringDeleteOptions are parameters for the Delete API
|
|
type KeyringDeleteOptions struct {
|
|
KeyID string // UUID
|
|
}
|
|
|
|
// Update upserts a key into the keyring
|
|
func (k *Keyring) Update(key *RootKey, w *WriteOptions) (*WriteMeta, error) {
|
|
wm, err := k.client.write("/v1/operator/keyring/keys", key, nil, w)
|
|
return wm, err
|
|
}
|
|
|
|
// Rotate requests a key rotation
|
|
func (k *Keyring) Rotate(opts *KeyringRotateOptions, w *WriteOptions) (*RootKeyMeta, *WriteMeta, error) {
|
|
qp := url.Values{}
|
|
if opts != nil {
|
|
if opts.Algorithm != "" {
|
|
qp.Set("algo", string(opts.Algorithm))
|
|
}
|
|
if opts.Full {
|
|
qp.Set("full", "true")
|
|
}
|
|
}
|
|
resp := &struct{ Key *RootKeyMeta }{}
|
|
wm, err := k.client.write("/v1/operator/keyring/rotate?"+qp.Encode(), nil, resp, w)
|
|
return resp.Key, wm, err
|
|
}
|
|
|
|
// KeyringRotateOptions are parameters for the Rotate API
|
|
type KeyringRotateOptions struct {
|
|
Full bool
|
|
Algorithm EncryptionAlgorithm
|
|
}
|