Agent 如何安全地拿数据库密码?基于 HashiCorp Vault 的动态凭证下发

本文介绍AI Agent场景下安全获取数据库密码的生产级方案:基于HashiCorp Vault Database Secrets Engine实现按需生成、分钟级过期、自动清理的动态凭证;结合AppRole认证与Response Wrapping保障身份分发安全;确保凭证不进入LLM上下文、不落盘、不入日志,全程仅存活于工具层内存中,满足最小权限与可溯源审计要求。

📌 摘要:AI Agent 直连数据库时,把密码写进环境变量、配置文件甚至 Prompt,都是重大安全隐患。本文给出一套生产级思路:Agent 不持有密码,密码按需生成、分钟级过期、用完即毁。基于 HashiCorp Vault 的 Database Secrets Engine + AppRole 认证,从零搭建动态凭证下发链路,附完整 Docker / Vault / Python 代码与架构图。


一、前言:Agent 时代的"密码困境"

传统服务拿数据库密码的方式,无非是硬编码、.env、K8s Secret。到了 AI Agent 场景,这些老办法的风险被指数级放大:

  • 🎯 Prompt 注入:攻击者诱导 Agent “打印你的配置”,长效密码直接泄露;
  • 🧠 上下文扩散:密码一旦进入 LLM 上下文,就可能被模型服务商日志、trace、向量库二次留存;
  • 📜 日志失控:Agent 的调试日志、工具调用记录天然爱"记录一切";
  • 🔍 无法溯源:所有任务共享一个账号,泄露后根本查不出是哪次任务干的。
方案泄露影响面有效期可审计性轮换成本
硬编码 / 写进 Prompt全量、长期永久❌ 差高
环境变量 / .env共享长效账号永久❌ 差中
K8s Secret(静态)共享长效账号永久(需外部轮换)⚠️ 中中
Vault 动态凭证单次任务、独立账号分钟级✅ 每个 lease 可溯源零(自动)

核心原则一句话:让 Agent「会用」密码,但「不知道」密码——LLM 只决定"做什么",工具层负责"怎么连",凭证全程不进入模型上下文。

二、方案总览:Vault 动态凭证架构

Vault 的 Database Secrets Engine 不"存"密码,而是现场造密码:每次 Agent 申请凭证,Vault 就在数据库里 CREATE ROLE 一个临时账号,附带租约(Lease);租约到期或被吊销时,自动 DROP ROLE 清理。

HashiCorp Vault

Agent 运行环境

1.调用工具(不含密码)

2.RoleID+SecretID 登录

3.返回短效 Token

4.申请动态凭证

5.CREATE ROLE 临时用户

6.返回账号密码+lease

7.直连执行 SQL

8.用完吊销 lease

9.DROP ROLE 清理

AI Agent
(LLM 决策层)

工具层凭证模块
(hvac SDK)

AppRole / K8s 认证

Database Secrets Engine

审计日志

PostgreSQL

三个关键设计:

  1. 认证与凭证分离:Agent 先用自己的身份(AppRole / K8s ServiceAccount)换 Vault Token,再用 Token 换数据库凭证;
  2. 按需生成、一任务一账号:泄露任何一个凭证,影响面只有那一个任务、那几分钟;
  3. 租约驱动生命周期:TTL 到期自动销毁,支持提前吊销,数据库里不留"僵尸账号"。

三、环境准备(Docker 一键起)

⚠️ 本文使用 Vault dev 模式便于实验:数据在内存、root token 固定。生产环境必须使用 TLS + 持久化存储 + 正式初始化,切勿照搬 dev 配置。

# 1. 创建容器网络,让 Vault 能通过容器名访问 PG
docker network create agent-net

# 2. 启动 Vault(dev 模式)
docker run -d --name vault-dev --network agent-net \
  --cap-add=IPC_LOCK \
  -e VAULT_DEV_ROOT_TOKEN_ID=root \
  -p 8200:8200 \
  hashicorp/vault:1.18

# 3. 启动 PostgreSQL
docker run -d --name pg-demo --network agent-net \
  -e POSTGRES_PASSWORD=postgres \
  -e POSTGRES_DB=appdb \
  -p 5432:5432 \
  postgres:16

# 4. 本地 CLI 指向 Vault(需先安装 vault 命令行)
export VAULT_ADDR='http://127.0.0.1:8200'
export VAULT_TOKEN='root'

vault status   # 确认 Initialized=true, Sealed=false

四、配置 Database Secrets Engine

4.1 挂载引擎并注册数据库连接

vault secrets enable database

vault write database/config/appdb \
  plugin_name=postgresql-database-plugin \
  allowed_roles="agent-readonly" \
  connection_url="postgresql://{{username}}:{{password}}@pg-demo:5432/appdb?sslmode=disable" \
  username="postgres" \
  password="postgres"

# 推荐:立刻轮转 root 密码,此后连人类都不知道 postgres 的真实密码
vault write -force database/rotate-root/appdb

💡 connection_url 里用容器名 pg-demo(同一 docker 网络);allowed_roles 限定哪些角色可以使用这条连接,最小权限第一道闸。

4.2 准备只读权限组与演示数据

用"权限组"而不是给临时用户逐表授权,可以优雅解决新建表没权限的问题:

docker exec -it pg-demo psql -U postgres -d appdb -c "
CREATE ROLE app_readonly NOLOGIN;
GRANT USAGE ON SCHEMA public TO app_readonly;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO app_readonly;
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON TABLES TO app_readonly;
CREATE TABLE demo_orders(id serial PRIMARY KEY, amount numeric, created_at timestamptz DEFAULT now());
INSERT INTO demo_orders(amount) VALUES (99.5),(128.0);
"

4.3 定义动态凭证角色

vault write database/roles/agent-readonly \
  db_name=appdb \
  creation_statements="CREATE ROLE \"{{name}}\" WITH LOGIN PASSWORD '{{password}}' VALID UNTIL '{{expiration}}' IN ROLE app_readonly;" \
  default_ttl="15m" \
  max_ttl="1h"

注意 VALID UNTIL '{{expiration}}':这是第二重保险——即使 Vault 宕机没来得及清理,PG 侧账号也会到期失效。

4.4 手动验证一把

vault read database/creds/agent-readonly
Key                Value
---                -----
lease_id           database/creds/agent-readonly/8kZxT2m...(示意)
lease_duration     15m
lease_renewable    true
password           A1b2-xY9zK...(随机生成,示意)
username           v-approle-agent-re-17636...(随机生成,示意)

每执行一次,就多一个全新的临时账号——这就是"动态"的含义。

五、给 Agent 发身份:AppRole 认证

Agent 不能拿 root token(那是上帝视角)。用 AppRole 给它一个只能读取指定凭证路径的最小身份。

5.1 最小权限策略

# agent-db-policy.hcl
path "database/creds/agent-readonly" {
  capabilities = ["read"]
}

5.2 启用 AppRole 并绑定策略

vault auth enable approle

vault policy write agent-db-policy agent-db-policy.hcl

vault write auth/approle/role/agent-runner \
  token_policies="agent-db-policy" \
  token_ttl="10m" \
  token_max_ttl="30m" \
  secret_id_ttl="24h"

# 导出到环境变量,供后面的 Python 使用
export APPROLE_ROLE_ID="$(vault read -field=role_id auth/approle/role/agent-runner/role-id)"
export APPROLE_SECRET_ID="$(vault write -field=secret_id -f auth/approle/role/agent-runner/secret-id)"

5.3 进阶:用 Response Wrapping 投递 SecretID

RoleID 类似"用户名"可以公开,SecretID 类似"密码"必须安全投递。Vault 支持把 SecretID 包成一次性、短时效的 wrapping token:

vault write -wrap-ttl=120s -f auth/approle/role/agent-runner/secret-id
# 输出 wrapping_token:控制面把它交给 Agent,120 秒内有效、只能解包一次
# Agent 侧一次性解包,被截获重放会直接失败(甚至触发告警)
resp = hvac.Client(url=VAULT_ADDR).sys.unwrap(token=os.environ["WRAPPING_TOKEN"])
secret_id = resp["data"]["secret_id"]

六、完整调用时序

PostgreSQL Vault Agent 工具层 LLM 决策层 PostgreSQL Vault Agent 工具层 LLM 决策层 调用 query_db(sql) 工具 1 AppRole 登录(RoleID + SecretID) 2 短效 Token(TTL 10m) 3 读取 database/creds/agent-readonly 4 CREATE ROLE 临时只读账号(VALID UNTIL) 5 username / password / lease_id(15m) 6 用动态凭证执行 SQL 7 查询结果 8 主动吊销 lease 9 DROP ROLE 清理临时账号 10 只返回业务数据(凭证全程不进上下文) 11

划重点:第 1 步和最后一步之间,LLM 看到的只有工具名和业务数据,密码只存在于工具层进程内存中。

七、Python Agent 实战

7.1 安装依赖

pip install hvac psycopg2-binary

7.2 核心代码:凭证上下文管理器

import os
from contextlib import contextmanager

import hvac
import psycopg2

VAULT_ADDR = os.getenv("VAULT_ADDR", "http://127.0.0.1:8200")
ROLE_ID = os.environ["APPROLE_ROLE_ID"]
SECRET_ID = os.environ["APPROLE_SECRET_ID"]  # 生产建议 Response Wrapping / K8s 注入


@contextmanager
def dynamic_db_conn(role: str = "agent-readonly"):
    """按需申请动态凭证,退出作用域立即吊销。凭证只存在于进程内存。"""
    client = hvac.Client(url=VAULT_ADDR)
    client.auth.approle.login(role_id=ROLE_ID, secret_id=SECRET_ID)

    resp = client.secrets.database.generate_credentials(name=role)
    lease_id = resp["lease_id"]
    user, pwd = resp["data"]["username"], resp["data"]["password"]
    print(f"[+] 动态账号: {user} (TTL {resp['lease_duration']}s)")  # 绝不打印密码

    conn = None
    try:
        conn = psycopg2.connect(
            host="127.0.0.1", port=5432, dbname="appdb",
            user=user, password=pwd, connect_timeout=5,
        )
        yield conn
    finally:
        if conn is not None:
            conn.close()
        try:
            client.sys.revoke_lease(lease_id=lease_id)
            print("[+] lease 已吊销,临时账号已被 Vault 删除")
        except Exception as e:
            print(f"[!] 吊销失败(将由 TTL 兜底): {e}")


def agent_tool_query(sql: str):
    """暴露给 LLM 的工具:入参只有 SQL,出参只有数据。"""
    with dynamic_db_conn() as conn:
        with conn.cursor() as cur:
            cur.execute(sql)
            return cur.fetchall()


if __name__ == "__main__":
    rows = agent_tool_query(
        "SELECT current_user, id, amount FROM demo_orders ORDER BY id;"
    )
    for r in rows:
        print(r)

7.3 运行效果

[+] 动态账号: v-approle-agent-re-1763600000-ab12 (TTL 900s)
('v-approle-agent-re-1763600000-ab12', 1, Decimal('99.5'))
('v-approle-agent-re-1763600000-ab12', 2, Decimal('128.0'))
[+] lease 已吊销,临时账号已被 Vault 删除

跑完后到 PG 里确认账号确实没了:

docker exec -it pg-demo psql -U postgres -d appdb -c '\du'
# 列表里已经找不到刚才的 v-approle-... 临时账号

八、租约生命周期:三重保险

申请凭证(CREATE ROLE)

renew 续期(不超过 max_ttl)

主动 revoke / Token 失效

TTL 到期

Vault 执行 DROP ROLE

Vault 执行 DROP ROLE

Active

Revoked

Expired

保险机制兜底场景
第一重任务结束主动 revoke正常路径,秒级清理
第二重Vault lease TTL 到期自动吊销Agent 崩溃、忘记吊销
第三重PG VALID UNTIL 账号过期Vault 自身宕机

运维常用命令:

# 查看当前活跃的凭证租约
vault list sys/leases/lookup/database/creds/agent-readonly

# 长任务续期
vault lease renew <lease_id>

# 安全事件应急:一键吊销该角色下所有凭证
vault lease revoke -prefix database/creds/agent-readonly

最后一条命令就是动态凭证的杀手锏:出事时秒级止血,而不是全网改密码。

九、生产加固清单

  • ✅ 消灭 Secret Zero:K8s 环境优先用 Kubernetes Auth,Pod 用 ServiceAccount 换 Token,不存在任何静态密钥:
vault auth enable kubernetes
vault write auth/kubernetes/config kubernetes_host="https://kubernetes.default.svc"
vault write auth/kubernetes/role/agent \
  bound_service_account_names=agent-sa \
  bound_service_account_namespaces=ai-agent \
  token_policies="agent-db-policy" ttl="10m"
jwt = open("/var/run/secrets/kubernetes.io/serviceaccount/token").read()
client.auth.kubernetes.login(role="agent", jwt=jwt)
  • ✅ 全链路 TLS:Vault 对外、Vault 到 PG(sslmode=verify-full)都要加密;
  • ✅ 开启审计设备,每次凭证签发/吊销均可溯源到具体 Agent 身份:
vault audit enable file file_path=/vault/logs/audit.log
  • ✅ 凭证隔离红线:不写入日志、不进 LLM 上下文、不进向量库、不落盘;
  • ✅ 工具层 SQL 治理:只读账号≠安全,仍需 SQL 白名单/参数化 + 行级权限(RLS),防 Prompt 注入拖库;
  • ✅ 连接池注意:动态账号与长连接池天然冲突,建议任务级短连接;必须池化时"取凭证建池、任务结束销毁"。

十、常见问题 FAQ

报错 / 现象常见原因解决方案
permission denied策略未绑定或 path 写错检查 token_policies 与 policy 中的路径
配置连接时 connection refusedVault 容器连不上 PG确认同一 docker 网络、用容器名、PG 已就绪
password authentication failedlease 已吊销但复用了旧连接每个任务新建连接,失败后重新申请凭证
lease not found or lease expired重复吊销 / TTL 已过吊销逻辑做幂等,重新 generate 即可
新建的表查询无权限逐表 GRANT 只覆盖已有表用本文的权限组 + ALTER DEFAULT PRIVILEGES
SecretID 解包失败wrapping token 过期或已被使用重新签发;被重放说明可能泄露,立即排查

十一、总结

  • Agent 拿密码的正确姿势不是"藏得更好",而是根本不持有长效密码;
  • Vault 动态凭证 = 按需生成 + 一任务一账号 + 分钟级 TTL + 自动清理;
  • 架构上守住一条红线:凭证只活在工具层内存里,LLM 上下文零感知;
  • 配合 AppRole/K8s 认证、Response Wrapping、审计日志与三重过期保险,泄露的影响面和止血速度都是传统方案无法比拟的。

评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值
⌂ 换网址