Files
unkinben b4b8915d3e
ci/woodpecker/pr/build Pipeline was successful
ci/woodpecker/pr/test Pipeline was successful
ci/woodpecker/pr/pre-commit Pipeline was successful
Scaffold the bind-tsig secrets engine
A Vault/OpenBao secrets engine that manages BIND TSIG keys via the
bind-operator companion API (Vault -> HTTP API -> BindTSIGKey CRs).

- backend + cmd entry point (plugin.ServeMultiplex), modelled on
  vault-plugin-secrets-litellm
- config path: companion API url/token/tls + defaults
- static-roles/static-creds: stable named key with managed rotation
- roles/creds: dynamic, lease-bound keys (revoke deletes the CR)
- tsig_key secret type with revoke/renew
- HTTP client for the companion API contract (/v1/keys CRUD + rotate)
- Makefile, Woodpecker CI (pre-commit/build/test + tag release RPMs),
  nfpm packaging (vault + openbao flavours)
- e2e: mock companion API + Vault + OpenBao in docker-compose, full
  lifecycle per engine; unit tests for the dynamic + static flows
2026-07-15 21:29:33 +10:00

186 lines
5.7 KiB
Go

package bindtsig
import (
"context"
"errors"
"github.com/hashicorp/vault/sdk/framework"
"github.com/hashicorp/vault/sdk/logical"
)
const configStoragePath = "config"
// bindTSIGConfig is the connection to the bind-operator companion API.
type bindTSIGConfig struct {
APIURL string `json:"api_url"`
Token string `json:"token"`
CACert string `json:"ca_cert"`
TLSSkipVerify bool `json:"tls_skip_verify"`
RequestTimeoutSeconds int `json:"request_timeout_seconds"`
DefaultAlgorithm string `json:"default_algorithm"`
DefaultClusterRef string `json:"default_cluster_ref"`
}
func pathConfig(b *bindTSIGBackend) *framework.Path {
return &framework.Path{
Pattern: "config",
DisplayAttrs: &framework.DisplayAttributes{
OperationPrefix: "bind-tsig",
OperationSuffix: "config",
},
Fields: map[string]*framework.FieldSchema{
"api_url": {
Type: framework.TypeString,
Description: "Base URL of the bind-operator companion API, e.g. https://bind-tsig-api.bind-system.svc:8443.",
Required: true,
},
"token": {
Type: framework.TypeString,
Description: "Bearer token used to authenticate to the companion API.",
DisplayAttrs: &framework.DisplayAttributes{
Name: "API Token",
Sensitive: true,
},
},
"ca_cert": {
Type: framework.TypeString,
Description: "PEM CA certificate that signed the companion API's TLS certificate.",
},
"tls_skip_verify": {
Type: framework.TypeBool,
Description: "Skip TLS verification of the companion API (not recommended).",
Default: false,
},
"request_timeout_seconds": {
Type: framework.TypeInt,
Description: "HTTP timeout in seconds for calls to the companion API (default 30).",
Default: 30,
},
"default_algorithm": {
Type: framework.TypeString,
Description: "Default TSIG algorithm for keys when a role does not set one.",
Default: "hmac-sha256",
},
"default_cluster_ref": {
Type: framework.TypeString,
Description: "Default BindCluster a key is scoped to when a role does not set one.",
},
},
Operations: map[logical.Operation]framework.OperationHandler{
logical.ReadOperation: &framework.PathOperation{Callback: b.pathConfigRead},
logical.CreateOperation: &framework.PathOperation{Callback: b.pathConfigWrite},
logical.UpdateOperation: &framework.PathOperation{Callback: b.pathConfigWrite},
logical.DeleteOperation: &framework.PathOperation{Callback: b.pathConfigDelete},
},
ExistenceCheck: b.pathConfigExistenceCheck,
HelpSynopsis: "Configure the connection to the bind-operator companion API.",
HelpDescription: "Configure the URL and token the backend uses to manage BIND TSIG keys.",
}
}
func (b *bindTSIGBackend) pathConfigExistenceCheck(ctx context.Context, req *logical.Request, _ *framework.FieldData) (bool, error) {
config, err := getConfig(ctx, req.Storage)
if err != nil {
return false, err
}
return config != nil, nil
}
func (b *bindTSIGBackend) pathConfigRead(ctx context.Context, req *logical.Request, _ *framework.FieldData) (*logical.Response, error) {
config, err := getConfig(ctx, req.Storage)
if err != nil {
return nil, err
}
if config == nil {
return nil, nil
}
// The token is deliberately not returned.
return &logical.Response{
Data: map[string]interface{}{
"api_url": config.APIURL,
"tls_skip_verify": config.TLSSkipVerify,
"request_timeout_seconds": config.RequestTimeoutSeconds,
"default_algorithm": config.DefaultAlgorithm,
"default_cluster_ref": config.DefaultClusterRef,
},
}, nil
}
func (b *bindTSIGBackend) pathConfigWrite(ctx context.Context, req *logical.Request, data *framework.FieldData) (*logical.Response, error) {
config, err := getConfig(ctx, req.Storage)
if err != nil {
return nil, err
}
if config == nil {
if req.Operation == logical.UpdateOperation {
return nil, errors.New("config not found during update operation")
}
config = &bindTSIGConfig{}
}
if v, ok := data.GetOk("api_url"); ok {
config.APIURL = v.(string)
}
if v, ok := data.GetOk("token"); ok {
config.Token = v.(string)
}
if v, ok := data.GetOk("ca_cert"); ok {
config.CACert = v.(string)
}
if v, ok := data.GetOk("tls_skip_verify"); ok {
config.TLSSkipVerify = v.(bool)
}
if v, ok := data.GetOk("request_timeout_seconds"); ok {
config.RequestTimeoutSeconds = v.(int)
} else if req.Operation == logical.CreateOperation {
config.RequestTimeoutSeconds = data.Get("request_timeout_seconds").(int)
}
if v, ok := data.GetOk("default_algorithm"); ok {
config.DefaultAlgorithm = v.(string)
} else if req.Operation == logical.CreateOperation {
config.DefaultAlgorithm = data.Get("default_algorithm").(string)
}
if v, ok := data.GetOk("default_cluster_ref"); ok {
config.DefaultClusterRef = v.(string)
}
if config.APIURL == "" {
return logical.ErrorResponse("api_url is required"), nil
}
entry, err := logical.StorageEntryJSON(configStoragePath, config)
if err != nil {
return nil, err
}
if err := req.Storage.Put(ctx, entry); err != nil {
return nil, err
}
b.reset()
return nil, nil
}
func (b *bindTSIGBackend) pathConfigDelete(ctx context.Context, req *logical.Request, _ *framework.FieldData) (*logical.Response, error) {
if err := req.Storage.Delete(ctx, configStoragePath); err != nil {
return nil, err
}
b.reset()
return nil, nil
}
func getConfig(ctx context.Context, s logical.Storage) (*bindTSIGConfig, error) {
entry, err := s.Get(ctx, configStoragePath)
if err != nil {
return nil, err
}
if entry == nil {
return nil, nil
}
config := &bindTSIGConfig{}
if err := entry.DecodeJSON(config); err != nil {
return nil, err
}
return config, nil
}