API 密钥和范围
Guardrail Ledger 只有一种密钥，即接入令牌。它没有可配置的范围。
| 密钥 | 用途 | 谁可以管理 |
|---|---|---|
| 接入令牌 | 从管道将 SARIF 发送到 /api/v1/ingest/sarif。它不能读取发现或更改设置。 | 工作区所有者和管理员 |
令牌的处理
- 在 Pipeline 页面生成令牌。它只显示一次，系统只保留其哈希值。
- 将其存为机密变量。切勿将其放入仓库文件或截图中。
- 每个管道使用一个令牌，这样撤销其中一个时不会影响其他的。
- 撤销令牌会使用它的接入立即停止。通过 API 撤销时，请使用
DELETE /api/v1/tokens/<id>，以所有者或管理员身份登录，并使用 JSON 内容类型和空的 JSON 请求体。
每次生成和撤销都会写入审计日志，并记录操作人。