vault/api/cliconfig/config.go
Vault Automation 0c6c13dd38
license: update headers to IBM Corp. (#10229) (#10233)
* license: update headers to IBM Corp.
* `make proto`
* update offset because source file changed

Signed-off-by: Ryan Cragun <me@ryan.ec>
Co-authored-by: Ryan Cragun <me@ryan.ec>
2025-10-21 15:20:20 -06:00

102 lines
3.0 KiB
Go

// Copyright IBM Corp. 2016, 2025
// SPDX-License-Identifier: MPL-2.0
package cliconfig
import (
"fmt"
"os"
"github.com/hashicorp/go-multierror"
"github.com/hashicorp/hcl"
"github.com/hashicorp/hcl/hcl/ast"
"github.com/mitchellh/go-homedir"
)
const (
// defaultConfigPath is the default path to the configuration file
defaultConfigPath = "~/.vault"
// configPathEnv is the environment variable that can be used to
// override where the Vault configuration is.
configPathEnv = "VAULT_CONFIG_PATH"
)
// Config is the CLI configuration for Vault that can be specified via
// a `$HOME/.vault` file which is HCL-formatted (therefore HCL or JSON).
type defaultConfig struct {
// TokenHelper is the executable/command that is executed for storing
// and retrieving the authentication token for the Vault CLI. If this
// is not specified, then vault's internal token store will be used, which
// stores the token on disk unencrypted.
TokenHelper string `hcl:"token_helper"`
}
// loadConfig reads the configuration from the given path. If path is
// empty, then the default path will be used, or the environment variable
// if set.
func loadConfig(path string) (config *defaultConfig, duplicate bool, err error) {
if path == "" {
path = defaultConfigPath
}
if v := os.Getenv(configPathEnv); v != "" {
path = v
}
// NOTE: requires HOME env var to be set
path, err = homedir.Expand(path)
if err != nil {
return nil, false, fmt.Errorf("error expanding config path %q: %w", path, err)
}
contents, err := os.ReadFile(path)
if err != nil && !os.IsNotExist(err) {
return nil, false, err
}
conf, duplicate, err := parseConfig(string(contents))
if err != nil {
return nil, duplicate, fmt.Errorf("error parsing config file at %q: %w; ensure that the file is valid; Ansible Vault is known to conflict with it", path, err)
}
return conf, duplicate, nil
}
// parseConfig parses the given configuration as a string.
func parseConfig(contents string) (config *defaultConfig, duplicate bool, err error) {
// TODO (HCL_DUP_KEYS_DEPRECATION): on removal stage change this to a simple hcl.Parse, effectively treating
// duplicate keys as an error. Also get rid of all of these "duplicate" named return values
root, duplicate, err := parseAndCheckForDuplicateHclAttributes(contents)
if err != nil {
return nil, duplicate, err
}
// Top-level item should be the object list
list, ok := root.Node.(*ast.ObjectList)
if !ok {
return nil, duplicate, fmt.Errorf("failed to parse config; does not contain a root object")
}
valid := map[string]struct{}{
"token_helper": {},
}
var validationErrors error
for _, item := range list.Items {
key := item.Keys[0].Token.Value().(string)
if _, ok := valid[key]; !ok {
validationErrors = multierror.Append(validationErrors, fmt.Errorf("invalid key %q on line %d", key, item.Assign.Line))
}
}
if validationErrors != nil {
return nil, duplicate, validationErrors
}
var c defaultConfig
if err := hcl.DecodeObject(&c, list); err != nil {
return nil, duplicate, err
}
return &c, duplicate, nil
}