SuperAPI AI 工具集

vault-api

编程与开发

查看项目

更新于 10-15 23:46

技能介绍

用途:该技能用于通过 HashiCorp Vault 的 RESTful JSON API 操作 Vault,默认端口 8200。已认证端点需在请求头携带 X-Vault-Token;健康检查、初始化等未认证端点无需令牌。基础地址示例:集群内 http://vault.vault:8200,外部经网关 https://vault.kubexa.tech。

主要能力:系统类端点包括 /v1/sys/health、/v1/sys/seal-status、/v1/sys/init、/v1/sys/unseal、/v1/sys/leader;认证支持 Kubernetes(POST /v1/auth/kubernetes/login,用 ServiceAccount JWT 登录)、Token、AppRole、Userpass、LDAP、JWT/OIDC、Cert 等;KV v2 支持读、写、删除最新版本、读元数据、删除全部版本、恢复删除;KV v1 支持基本读写删;策略端点可列出、读取、创建、删除 ACL 策略;令牌端点可创建、创建孤儿令牌、查询自身、续期、吊销;还可列出/启用/禁用认证方法与密钥引擎,以及 Raft 集群加入、查看配置、生成快照。

使用方式:以 curl 调用端点,例如写入密钥:curl -s http://vault.vault:8200/v1/secret/data/myapp -H "X-Vault-Token: $VAULT_TOKEN" -d '{"data":{"password":"s3cret!"}}';Kubernetes 登录示例:SA_JWT=$(kubectl create token my-sa -n my-ns),再 POST 到 /v1/auth/kubernetes/login,请求体含 role 与 jwt。

适用场景:集群内应用通过 K8s 身份获取令牌、机器对机器认证、密钥读写与版本管理、策略下发、令牌生命周期管理、Raft 集群运维与快照。

限制与注意:KV v2 路径必须包含 data/ 前缀,否则返回 404;健康端点对已封存或备用节点返回非 200(如 503 表示已封存),应结合响应体中的 initialized、sealed 字段判断;令牌应放在 X-Vault-Token 头而非 URL 查询参数;Kubernetes 认证需配置正确的 audience;列出元数据需要 list 能力而非 read;Raft 加入前必须先解封;快照恢复要求集群节点数一致。资料未提供收费、价格或平台支持信息。