kv

package module
v0.5.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Apr 15, 2019 License: MPL-2.0 Imports: 26 Imported by: 40

README

Vault Plugin: Key-Value Secrets Backend Build Status

This is a standalone backend plugin for use with Hashicorp Vault. This plugin provides Key-Value functionality to Vault.

Please note: We take Vault's security and our users' trust very seriously. If you believe you have found a security issue in Vault, please responsibly disclose by contacting us at security@hashicorp.com.

- Vault Website: https://www.vaultproject.io
- KV Docs: https://www.vaultproject.io/docs/secrets/kv/index.html
- Main Project Github: https://www.github.com/hashicorp/vault

Getting Started

This is a Vault plugin and is meant to work with Vault. This guide assumes you have already installed Vault and have a basic understanding of how Vault works.

Otherwise, first read this guide on how to get started with Vault.

To learn specifically about how plugins work, see documentation on Vault plugins.

Usage

Please see documentation for the plugin on the Vault website.

This plugin is currently built into Vault and by default is accessed at kv. To enable this in a running Vault server:

$ vault secrets enable kv
Success! Enabled the kv secrets engine at: kv/

Additionally starting with Vault 0.10 this backend is by default mounted at secret/.

Developing

If you wish to work on this plugin, you'll first need Go installed on your machine (version 1.10+ is required).

For local dev first make sure Go is properly installed, including setting up a GOPATH. Next, clone this repository into $GOPATH/src/github.com/hashicorp/vault-plugin-secrets-kv. You can then download any required build tools by bootstrapping your environment:

$ make bootstrap

To compile a development version of this plugin, run make or make dev. This will put the plugin binary in the bin and $GOPATH/bin folders. dev mode will only generate the binary for your platform and is faster:

$ make
$ make dev

Put the plugin binary into a location of your choice. This directory will be specified as the plugin_directory in the Vault config used to start the server.

...
plugin_directory = "path/to/plugin/directory"
...

Start a Vault server with this config file:

$ vault server -config=path/to/config.json ...
...

Once the server is started, register the plugin in the Vault server's plugin catalog:

$ vault write sys/plugins/catalog/kv \
        sha_256=<expected SHA256 Hex value of the plugin binary> \
        command="vault-plugin-secrets-kv"
...
Success! Data written to: sys/plugins/catalog/kv

Note you should generate a new sha256 checksum if you have made changes to the plugin. Example using openssl:

openssl dgst -sha256 $GOPATH/vault-plugin-secrets-kv
...
SHA256(.../go/bin/vault-plugin-secrets-kv)= 896c13c0f5305daed381952a128322e02bc28a57d0c862a78cbc2ea66e8c6fa1

Enable the auth plugin backend using the secrets enable plugin command:

$ vault secrets enable -plugin-name='kv' plugin
...

Successfully enabled 'plugin' at 'kv'!
Tests

If you are developing this plugin and want to verify it is still functioning (and you haven't broken anything else), we recommend running the tests.

To run the tests, invoke make test:

$ make test

You can also specify a TESTARGS variable to filter tests like so:

$ make test TESTARGS='--run=TestConfig'

Documentation

Overview

Package kv is a generated protocol buffer package.

It is generated from these files: 

types.proto

It has these top-level messages: 

Configuration
VersionMetadata
KeyMetadata
Version
UpgradeInfo

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Factory 

func Factory(ctx context.Context, conf *logical.BackendConfig) (logical.Backend, error)

Factory will return a logical backend of type versionedKVBackend or PassthroughBackend based on the config passed in.

func LeaseSwitchedPassthroughBackend 

func LeaseSwitchedPassthroughBackend(ctx context.Context, conf *logical.BackendConfig, leases bool) (logical.Backend, error)

LeaseSwitchedPassthroughBackend returns a PassthroughBackend with leases switched on or off

func LeasedPassthroughBackendFactory 

func LeasedPassthroughBackendFactory(ctx context.Context, conf *logical.BackendConfig) (logical.Backend, error)

LeasedPassthroughBackendFactory returns a PassthroughBackend with leases switched on

func PassthroughBackendFactory 

func PassthroughBackendFactory(ctx context.Context, conf *logical.BackendConfig) (logical.Backend, error)

PassthroughBackendFactory returns a PassthroughBackend with leases switched off

func VersionedKVFactory 

func VersionedKVFactory(ctx context.Context, conf *logical.BackendConfig) (logical.Backend, error)

Factory returns a new backend as logical.Backend.

Types

type Configuration 

type Configuration struct {
	MaxVersions uint32 `protobuf:"varint,1,opt,name=max_versions,json=maxVersions" json:"max_versions,omitempty"`
	CasRequired bool   `protobuf:"varint,2,opt,name=cas_required,json=casRequired" json:"cas_required,omitempty"`
}

func (*Configuration) Descriptor 

func (*Configuration) Descriptor() ([]byte, []int)

func (*Configuration) GetCasRequired 

func (m *Configuration) GetCasRequired() bool

func (*Configuration) GetMaxVersions 

func (m *Configuration) GetMaxVersions() uint32

func (*Configuration) ProtoMessage 

func (*Configuration) ProtoMessage()

func (*Configuration) Reset 

func (m *Configuration) Reset()

func (*Configuration) String 

func (m *Configuration) String() string

type KeyMetadata 

type KeyMetadata struct {
	// Key is the key for this entry
	Key string `protobuf:"bytes,1,opt,name=key" json:"key,omitempty"`
	// Versions is the map of versionID -> VersionMetadata.
	// Useful when listing all versions.
	Versions map[uint64]*VersionMetadata `` /* 137-byte string literal not displayed */
	// CurrentVersion is the latest version of the value
	CurrentVersion uint64 `protobuf:"varint,3,opt,name=current_version,json=currentVersion" json:"current_version,omitempty"`
	// OldestVersion is the oldest version of the value.
	OldestVersion uint64 `protobuf:"varint,4,opt,name=oldest_version,json=oldestVersion" json:"oldest_version,omitempty"`
	// Created time is when the metadata was created.
	CreatedTime *google_protobuf.Timestamp `protobuf:"bytes,5,opt,name=created_time,json=createdTime" json:"created_time,omitempty"`
	// Updated time was the last time the metadata version
	// was updated.
	UpdatedTime *google_protobuf.Timestamp `protobuf:"bytes,6,opt,name=updated_time,json=updatedTime" json:"updated_time,omitempty"`
	// MaxVersions specifies how many versions to keep around.
	// If empty value, defaults to the configured Max
	// for the mount.
	MaxVersions uint32 `protobuf:"varint,7,opt,name=max_versions,json=maxVersions" json:"max_versions,omitempty"`
	// CasRequired specifies if the cas parameter is
	// required for this key
	CasRequired bool `protobuf:"varint,8,opt,name=cas_required,json=casRequired" json:"cas_required,omitempty"`
}

func (*KeyMetadata) AddVersion 

func (k *KeyMetadata) AddVersion(createdTime, deletionTime *timestamp.Timestamp, configMaxVersions uint32) (*VersionMetadata, uint64)

AddVersion adds a version to the key metadata and moves the sliding window of max versions. It returns the newly added version and the version to delete from storage.

func (*KeyMetadata) Descriptor 

func (*KeyMetadata) Descriptor() ([]byte, []int)

func (*KeyMetadata) GetCasRequired 

func (m *KeyMetadata) GetCasRequired() bool

func (*KeyMetadata) GetCreatedTime 

func (m *KeyMetadata) GetCreatedTime() *google_protobuf.Timestamp

func (*KeyMetadata) GetCurrentVersion 

func (m *KeyMetadata) GetCurrentVersion() uint64

func (*KeyMetadata) GetKey 

func (m *KeyMetadata) GetKey() string

func (*KeyMetadata) GetMaxVersions 

func (m *KeyMetadata) GetMaxVersions() uint32

func (*KeyMetadata) GetOldestVersion 

func (m *KeyMetadata) GetOldestVersion() uint64

func (*KeyMetadata) GetUpdatedTime 

func (m *KeyMetadata) GetUpdatedTime() *google_protobuf.Timestamp

func (*KeyMetadata) GetVersions 

func (m *KeyMetadata) GetVersions() map[uint64]*VersionMetadata

func (*KeyMetadata) ProtoMessage 

func (*KeyMetadata) ProtoMessage()

func (*KeyMetadata) Reset 

func (m *KeyMetadata) Reset()

func (*KeyMetadata) String 

func (m *KeyMetadata) String() string

type Passthrough 

type Passthrough interface {
	// contains filtered or unexported methods
}

type PassthroughBackend 

type PassthroughBackend struct {
	*framework.Backend
	// contains filtered or unexported fields
}

PassthroughBackend is used storing secrets directly into the physical backend. The secrets are encrypted in the durable storage and custom TTL information can be specified, but otherwise this backend doesn't do anything fancy.

func (*PassthroughBackend) GeneratesLeases 

func (b *PassthroughBackend) GeneratesLeases() bool

type UpgradeInfo 

type UpgradeInfo struct {
	// Started time is when the upgrade was started.
	StartedTime *google_protobuf.Timestamp `protobuf:"bytes,1,opt,name=started_time,json=startedTime" json:"started_time,omitempty"`
	// done is set to true once the backend has been successfully
	// upgraded.
	Done bool `protobuf:"varint,2,opt,name=done" json:"done,omitempty"`
}

func (*UpgradeInfo) Descriptor 

func (*UpgradeInfo) Descriptor() ([]byte, []int)

func (*UpgradeInfo) GetDone 

func (m *UpgradeInfo) GetDone() bool

func (*UpgradeInfo) GetStartedTime 

func (m *UpgradeInfo) GetStartedTime() *google_protobuf.Timestamp

func (*UpgradeInfo) ProtoMessage 

func (*UpgradeInfo) ProtoMessage()

func (*UpgradeInfo) Reset 

func (m *UpgradeInfo) Reset()

func (*UpgradeInfo) String 

func (m *UpgradeInfo) String() string

type Version 

type Version struct {
	// Data is a JSON object with string keys that
	// represents the user supplied data.
	Data []byte `protobuf:"bytes,1,opt,name=data,proto3" json:"data,omitempty"`
	// CreatedTime is when the version was created.
	CreatedTime *google_protobuf.Timestamp `protobuf:"bytes,2,opt,name=created_time,json=createdTime" json:"created_time,omitempty"`
	// DeletionTime is the time this version becomes invalid.
	// Set to Now() to delete the version before the configured
	// deletion time.
	DeletionTime *google_protobuf.Timestamp `protobuf:"bytes,3,opt,name=deletion_time,json=deletionTime" json:"deletion_time,omitempty"`
}

func (*Version) Descriptor 

func (*Version) Descriptor() ([]byte, []int)

func (*Version) GetCreatedTime 

func (m *Version) GetCreatedTime() *google_protobuf.Timestamp

func (*Version) GetData 

func (m *Version) GetData() []byte

func (*Version) GetDeletionTime 

func (m *Version) GetDeletionTime() *google_protobuf.Timestamp

func (*Version) ProtoMessage 

func (*Version) ProtoMessage()

func (*Version) Reset 

func (m *Version) Reset()

func (*Version) String 

func (m *Version) String() string

type VersionMetadata 

type VersionMetadata struct {
	// CreatedTime is when the version was created.
	CreatedTime *google_protobuf.Timestamp `protobuf:"bytes,1,opt,name=created_time,json=createdTime" json:"created_time,omitempty"`
	// DeletionTime is the time this version becomes invalid.
	// Set to Now() to delete the version before the configured
	// delete time.
	DeletionTime *google_protobuf.Timestamp `protobuf:"bytes,2,opt,name=deletion_time,json=deletionTime" json:"deletion_time,omitempty"`
	// Destroyed is used to specify this version is
	// a has been removed and the underlying data deleted.
	Destroyed bool `protobuf:"varint,3,opt,name=destroyed" json:"destroyed,omitempty"`
}

func (*VersionMetadata) Descriptor 

func (*VersionMetadata) Descriptor() ([]byte, []int)

func (*VersionMetadata) GetCreatedTime 

func (m *VersionMetadata) GetCreatedTime() *google_protobuf.Timestamp

func (*VersionMetadata) GetDeletionTime 

func (m *VersionMetadata) GetDeletionTime() *google_protobuf.Timestamp

func (*VersionMetadata) GetDestroyed 

func (m *VersionMetadata) GetDestroyed() bool

func (*VersionMetadata) ProtoMessage 

func (*VersionMetadata) ProtoMessage()

func (*VersionMetadata) Reset 

func (m *VersionMetadata) Reset()

func (*VersionMetadata) String 

func (m *VersionMetadata) String() string

Source Files

View all Source files

Directories

Path Synopsis
cmd
vault-plugin-secrets-kv

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.