HashiCorp Vault Go 客户端库使用教程

HashiCorp Vault Go 客户端库使用教程

vault-client-go HashiCorp Vault Go Client Library generated from OpenAPI spec. 项目地址: https://gitcode.com/gh_mirrors/va/vault-client-go

1. 项目介绍

HashiCorp Vault Go Client Library 是一个用 Go 语言编写的客户端库，用于与 HashiCorp Vault 进行交互。这个库是基于 OpenAPI 规范生成的，提供了对 Vault API 的访问，使得在 Go 应用程序中集成 Vault 变得更加简单。

2. 项目快速启动

以下是一个快速启动 Vault Go 客户端库的示例：

首先，确保你已经安装了 Go 环境。

go get -u github.com/hashicorp/vault-client-go

然后，你可以创建一个简单的 Go 文件来启动一个客户端，并与 Vault 进行交互：

package main

import (
	"context"
	"log"
	"time"

	"github.com/hashicorp/vault-client-go"
	"github.com/hashicorp/vault-client-go/schema"
)

func main() {
	ctx := context.Background()

	// 初始化 Vault 客户端
	client, err := vault.New(vault.WithAddress("http://127.0.0.1:8200"), vault.WithRequestTimeout(30*time.Second))
	if err != nil {
		log.Fatal(err)
	}

	// 使用根令牌进行身份验证（不安全）
	if err := client.SetToken("my-token"); err != nil {
		log.Fatal(err)
	}

	// 写入一个秘密
	if _, err := client.Secrets.KvV2Write(ctx, "foo", schema.KvV2WriteRequest{
		Data: map[string]any{
			"password1": "abc123",
			"password2": "correct horse battery staple",
		},
	}, vault.WithMountPath("secret")); err != nil {
		log.Fatal(err)
	}
	log.Println("secret written successfully")

	// 读取秘密
	s, err := client.Secrets.KvV2Read(ctx, "foo", vault.WithMountPath("secret"))
	if err != nil {
		log.Fatal(err)
	}
	log.Println("secret retrieved:", s.Data.Data)
}

确保你的 Vault 服务器正在运行，并且使用了 -dev 模式。

3. 应用案例和最佳实践

• 身份验证：在生产环境中，建议使用 approle 或其他平台特定的身份验证方法，而不是使用根令牌。
• 请求修改：你可以通过装饰器修改请求，例如添加自定义头或修改请求的超时时间。
• 错误处理：正确处理可能出现的错误，例如网络问题或 Vault 返回的错误。

4. 典型生态项目

• Vault Operator for Kubernetes：用于在 Kubernetes 环境中部署和管理 Vault 的项目。
• Consul：与 Vault 集成，提供服务发现和配置。
• Nomad：使用 Vault 进行密钥管理，以安全地存储和访问敏感数据。

vault-client-go HashiCorp Vault Go Client Library generated from OpenAPI spec. 项目地址: https://gitcode.com/gh_mirrors/va/vault-client-go