企业官网建设流程全解析

凭证治理总览 ================================================== 用户 / 上游系统 │ 1. 身份认证（OIDC/OAuth） ▼ ┌─────────────────────┐ │ 凭证颁发服务 STS │ │ 签发短期、受限凭证 │ └──────────┬──────────┘ │ 2. 短期凭证（分钟级、范围受限） ▼ ┌─────────────────────┐ │ Agent 运行时 │ │ ┌───────────────┐ │ │ │ 凭证代理 Proxy │ │ <- 模型永远拿不到明文 │ └───────┬───────┘ │ └──────────┼──────────┘ │ 3. 代理注入到真实调用 ▼ 外部系统（DB / SaaS / 内部 API） │ ▼ 4. 审计与回溯

# 反例：凭证进入 promptbad_prompt=f"用这个 key 调接口：api_key={SECRET}"# 严禁# 正例：Agent 只声明意图，凭证由代理注入definvoke_tool(tool_name,args,ctx):cred=sts.issue(# 向凭证服务申请短期、限范围凭证tool=tool_name,tenant=ctx.tenant,ttl_seconds=300,scope=f"{tool_name}:read",# 最小权限reason=ctx.task_id,)headers={"Authorization":f"Bearer{cred.token}"}returnhttp_call(TOOLS[tool_name].endpoint,args,headers=headers)

classScopedCredential:def__init__(self,token,scope,expires_at,task_id):self.token,self.scope=token,scopeself.expires_at,self.task_id=expires_at,task_iddefvalid(self,required_scope,task_id):return(time.time()<self.expires_atandtask_id==self.task_idandscope_allows(self.scope,required_scope))defscope_allows(granted,required):"""支持前缀通配的最小权限判定"""g,r=granted.split(":"),required.split(":")returnlen(g)==len(r)andall(a==bora=="*"fora,binzip(g,r))

RISK={"read_only":"auto","side_effect":"auto+notify","high_risk":"require_approval"}defissue_for(tool,ctx):level=TOOLS[tool].riskpolicy=RISK[level]ifpolicy=="require_approval":ifnotapprovals.granted(ctx.task_id,tool):raisePermissionError(f"{tool}需人工审批")returnsts.issue(tool=tool,tenant=ctx.tenant,ttl_seconds=300iflevel!="high_risk"else600,scope=TOOLS[tool].required_scope,reason=ctx.task_id)

防线叠加（缺一不可） 1. 凭证不进上下文 -> 注入者无法直接套出密钥 2. 最小权限 scope -> 即使被诱导调用，影响范围受限 3. 高风险需审批 -> 关键动作有人工闸门 4. 短期 TTL -> 泄露窗口极小 5. 全链路审计 -> 事后可追溯、可告警

defaudit_log(tool,args,ctx,result):log.info({"ts":time.time(),"tenant":ctx.tenant,"task_id":ctx.task_id,"tool":tool,"args_digest":hashlib.sha256(json.dumps(args,sort_keys=True).encode()).hexdigest()[:16],"status":"ok"ifresult.okelse"fail",# 注意：不记录明文参数与凭证})