权威,而非凭据:经策略校验、可归因、可撤销、可证明的 AI 智能体授权。
"经网关中介的智能体从不持有上游凭据。每个操作在执行前都经过策略批准,权限范围严格限定于所委托的内容,可通过一次调用撤销,并记录为防篡改的证据。"
AI 智能体正带着环境中的长期有效 API 密钥、超出任何任务所需的访问权限,以及对"哪个智能体在谁的授权下做了这件事?"无从回答的困境进入生产环境。
一次提示注入、一次密钥泄露或一次失控循环,就能让助手变成安全事故。安全审查会阻止上线。审计人员则无从检查。
现有工具并非为此而建:身份提供商注册了智能体,却从来看不到它们的操作;密钥管理器把凭据直接交给工作负载;API 网关只路由流量,不做任何决策。Caracal 正是缺失的那层控制平面。它在每个操作之前决定智能体可以做什么,证明它实际做了什么,并在出问题时立即将其关停。
对于经网关中介的调用,智能体从不接收上游凭据。它们携带的是授权令(mandate):短期有效、经签名的权限授予,且随着工作被委托只能不断收缩。Caracal 的网关在调用时注入真实凭据,因此上游凭据永远不会进入智能体进程。
flowchart LR
A[Agent] -- requests authority --> STS[Policy decision<br/>default deny]
STS -- short-lived mandate --> A
A -- presents mandate --> GW[Caracal Gateway]
GW -- real credential injected --> API[Tool / API / MCP server]
STS -. every decision .-> AUDIT[(Tamper-evident audit)]
GW -. every call .-> AUDIT
| 能力 | 为您的团队带来的成果 |
|---|---|
| 无长期驻留密钥 | 对于经网关中介的调用,上游凭据保留在边缘,仅在请求时注入。 |
| 仅收窄的委托 | 代理将工作交给子代理,权限绝不超过自身所持有的权限。最小权限是被强制执行的,而非仅被请求的。 |
| 行动前先决策 | 默认拒绝策略在请求到达资源_之前_评估每个请求,而非事后在日志中标记。 |
| 一键终止开关 | 撤销一个代理,它启动的所有内容立即失去访问权限。无需等待令牌过期。 |
| 高风险操作需人工审批 | 审批关卡会在高风险操作执行前将其扣留,交由已认证的审批人处理。 |
| 证据,而非仅日志 | 每个决策的仅追加、防篡改记录,可导出用于 SOC 2、EU AI Act、NIST AI RMF 和 OWASP Agentic 审查。 |
| 替代方案 | 缺失之处 |
|---|---|
| 身份提供商 | 注册代理;但永远看不到它们的操作。没有逐调用决策,没有委托限制,没有证据。 |
| 密钥管理器 | 将凭据交给工作负载。被攻陷的代理就是一个泄露的密钥。 |
| API 网关 | 路由和限流;不携带权限模型,也没有委托语义。 |
| 自行构建 | 代理 + 保险库 + 策略引擎只能给你管道,而非收窄的委托、撤销传播或防篡改审计链。然后你得永远维护它。 |
Caracal 是标准原生的:OAuth 2.0 令牌交换(RFC 8693)、OPA 策略和 MCP 集成。它适配你现有的技术栈,而非取代它。
逐请求授权通常意味着延迟代价。Caracal 的延迟比大多数网关花在普通代理上的还要小——在单台 4-vCPU 虚拟机上以默认配置运行打包栈,端到端实测:
| 指标 | 结果 |
|---|---|
| 受治理请求延迟 — 铸造 + 策略 + 执行 | p50 17 ms · p95 23 ms |
| 策略评估(满负载下 128,000 次评估) | 约 1 ms,零错误 |
| 峰值吞吐量 | 139 req/s |
| 持续(8 分钟浸泡测试) | 133 req/s · 每天 1150 万次受治理调用 |
| 87,000 请求套件中的硬错误 | 0 |
| 100% CPU 下的防篡改审计链 | 无损 — 零丢弃事件 |
这些请求中的每一个都经过了单独授权、带有重放保护的加密铸造,并记录了审计日志。数据基于 v1.0.0 测量;完整方法见 Performance and Scalability。结果取决于硬件和工作负载形态,因此在确定限制之前,请先建立你自己的基线。
提供 TypeScript、Python 和 Go SDK。为 MCP 服务器、Express、FastAPI/ASGI 和 Go net/http 提供开箱即用的验证。可在任何运行 Docker 的环境中运行:你的基础设施,你的数据。
在 docs.caracal.run 阅读完整文档。
查看 GitHub Releases 获取最新可用标签。
固定版本:在 Unix 上使用
--version vX.Y.Z,在 PowerShell 中使用-Version vX.Y.Z。
curl -fsSL https://raw.githubusercontent.com/Garudex-Labs/caracal/main/install.sh | \
sh -s -- --version v1.0.0
curl -fsSL https://raw.githubusercontent.com/Garudex-Labs/caracal/main/install.sh | \
sh -s -- --version v1.0.0
$installer = "$env:TEMP\install.ps1"
iwr -useb https://raw.githubusercontent.com/Garudex-Labs/caracal/main/install.ps1 -OutFile $installer
powershell -ExecutionPolicy Bypass -File $installer -Version v1.0.0