我的 API 密钥和凭据存在哪里?
Vault 是 Helio 存放你的 token、密码和密钥的地方,以及如何控制谁——包括 AI 队友——可以访问它们。
什么是 Vault?
Vault 是你在工作区中存放凭据——token、密码、密钥——的地方。密文加密存储、默认隐藏,你可以在自己设定(且可撤销)的信任策略下,把使用某个凭据的访问权限授予队友和 AI 队友,而无需交出所有权。
为什么 Vault 很重要
问题:凭据暴露在外
AI 队友需要真实的凭据——API key、token、密码——才能真正干活,但一旦开始分发就没有自然的止损点。把一个密文预先共享给所有可能需要它的人("以防万一"),你就搞不清楚谁真的有访问权,也没法只撤销某一个人的访问而不动到其他人,密文本身还一直暴露在外。
方案:有归属、加密、可授权
Vault 里的每个凭据都只有一个所有者。密文默认加密并隐藏——显示密文需要明确确认,明文只在你离开详情视图之前才可见。使用凭据的权限可以和拥有凭据本身分开授予:既可以在信任策略下直接共享——**trusted(信任)**用于反复使用,one-time(一次性)用于单次释放,还能加设到期时间——也可以发布为可申请(requestable),让 AI 队友发现并申请它真正需要的那个凭据,全程看不到真实名称或密文。
Vault 如何运作
打开设置,在工作区设置下进入 Vault。
三个标签页
| 标签 | 显示内容 |
|---|---|
| My credentials(我的凭据) | 你拥有的凭据 |
| Shared with me(共享给我) | 队友或 AI agent 共享给你的凭据 |
| Shared by me(我共享的) | 你授予他人的外发访问权限 |
添加凭据
点击 Add credential(添加凭据),命名后选择类型:
- Token — 单个密文字符串(API key、access token)
- Password — 用户名或邮箱配密码
- Keypair — 私钥,附可选的公钥
- Multi-field — 多个具名密文字段一起存储
密文在保存时加密,默认不会出现在列表或详情中。你也可以在创建时一并共享,或保持私有。
操作凭据
打开某个凭据,在其详情视图中管理:
- Reveal secret(显示密文) — 密文默认锁定(
••••••••),需确认后才显示;离开详情视图前一直可见 - Copy(复制) — 将密文复制到剪贴板
- Edit(编辑) — 仅更新元数据(名称、描述、标签)
- Rotate(轮换) — 替换密文,同时保留凭据身份及其共享关系
- Share(共享) — 向队友或 AI agent 授予访问权限
- Delete(删除) — 删除凭据并撤销所有已共享访问(不可撤销)
显示密文会把明文呈现在屏幕上,直到你离开详情视图。请勿在共享屏幕或录屏中显示凭据。
真实场景
以下每一条都是 Vault 实际支持的工作流,不是假设:
- 把部署密钥共享给编码队友 — 授予信任访问,比如把 GitHub deploy token 直接交给队友使用,等项目结束或队友角色变化时,从凭据详情视图撤销。
- 让 AI 队友自己申请所需凭据 — 与其把凭据预先共享给所有可能需要的人,不如把它发布为可申请,队友发现预览后,只在工作真正需要时才申请访问。
- 只释放一次密文,而不是一直有效 — 当凭据只应该被使用一次时,选择 one-time access,用完即被消耗,而不是一直保持可用。
- 在 Inbox 里批准一条申请 — 队友申请可申请凭据时,请求会以审批卡片的形式出现在该队友的频道里,并同步进入你的 Inbox,你在那里批准或拒绝。
好处
| 好处 | 说明 |
|---|---|
| 归属明确 | 每个凭据只有一个所有者;共享只授予访问权限,绝不转移所有权 |
| 默认加密 | 密文默认加密并隐藏,除非你主动显示 |
| 随时可撤销 | 在 Shared by me 或凭据自己的详情视图里随时撤销访问 |
| 策略约束的共享 | 选择 trusted(反复使用)或 one-time(单次释放)访问,可加设到期时间 |
| 可发现但不暴露 | 可申请凭据让 AI 队友能找到并申请凭据,而看不到真实名称或密文 |
凭据管理建议
| 建议 | 说明 |
|---|---|
| 给凭据起具体的名字 | 在共享或发布之前,用队友能认出用途的名称 |
| 共享时写清楚真实理由 | 理由会进入审计记录,帮助之后的审查者理解这条授权为什么存在 |
| 不再需要时及时撤销 | 项目结束、队友角色变化、或凭据轮换时都应该撤销 |
| 不确定谁会用就发布为可申请 | 与其提前猜测谁需要直接访问,不如发布一份安全预览 |
| 不要在共享屏幕上显示密文 | 明文会一直可见直到你离开详情视图,只在没人能看到你屏幕时再显示 |
常见问题
共享凭据会交出所有权吗? 不会。共享只在你设置的策略下授予使用权限,不会转移所有权,真人接收方也不能编辑、轮换、二次共享或删除这个凭据。
Trusted 和 one-time 访问有什么区别? Trusted access 允许反复使用;one-time access 释放一次密文之后就被消耗。直接共享时由你自己选择策略;凭据可申请时,策略由队友的申请指定。
AI 队友在我批准申请之前,能看到凭据的真实名称吗? 不能。可申请凭据只发布预览名称和描述;真实名称、元数据和密文在你批准请求之前都保持私有。
怎么停止某人的访问权限? 打开 Shared by me,或凭据详情视图的共享区域,点击 Revoke access。
删除凭据会发生什么? 删除凭据会移除它并撤销所有已共享的访问权限,这个操作不可撤销。