用途:在 Codex 应用内浏览器中完成网站登录,凭据通过 Bitwarden Agent Access CLI(aac)按域名授权交接,避免用户直接粘贴密码、TOTP、API Key、Cookie 或会话值。
主要能力与原则:仅将 Agent Access 用作经批准、限定域名的凭据交接;不要求用户粘贴任何凭据或 rendezvous code;不运行会打印 AAC_USERNAME、AAC_PASSWORD、AAC_TOTP、环境变量、shell 历史、Cookie 或认证文件的命令;将 aac run --env-all 视为敏感操作,因为子进程及其代码路径可获取凭据;优先使用不向 Codex 暴露凭据的 credential-blind helper,若凭据必须经 Codex 控制的内存代码,需事先说明;请求真实凭据前确认目标域名,只批准用户预期的域名;在创建账号、最终提交、支付、授权或敏感表单提交前,除非用户当场确认,否则停止。
使用方式:先验证本地前置条件而不读取密钥,运行 command -v aac 与 aac connections list;不要检查 Bitwarden 保险库数据或环境变量。确保用户已打开并解锁 aac listen 且可批准请求;若无缓存连接,让用户在本地配对,不要要求把 rendezvous code 粘贴到聊天中。用浏览器打开目标登录页,仅检查可见表单结构,定位用户名/邮箱、密码和提交按钮的稳定定位符。通过 aac run --domain <domain> --env-all -- <helper> 请求凭据,<domain> 为向用户展示并获批的可注册或站点特定域名。填写并提交登录表单时不记录凭据值,提交后通过 URL、标题、问候语、退出链接或下一步流程验证成功,仅报告非敏感状态。
推荐模式:在 Codex 应用内浏览器中,保持浏览器控制执行处于活动状态,同时 aac run 等待用户批准:验证登录定位符唯一;在 127.0.0.1 随机端口启动临时服务器;启动 aac run --domain <domain> --env-all -- node -e '<small helper>';helper 读取 AAC_USERNAME 与 AAC_PASSWORD 并发送到临时本地服务器后退出;活动浏览器执行在内存中接收值、填写、点击登录、关闭服务器并仅返回净化状态。实现前阅读 references/in-app-browser-bridge.md。
失败模式:无缓存连接需用户将远程客户端与 aac listen 配对;请求被拒可能因用户拒绝、域名错误或无匹配保险库条目;登录页无变化需检查可见验证错误与 helper 是否退出,但不打印凭据值;后台桥接收到凭据但未填写页面时,保持浏览器控制调用存活,不要依赖工具调用返回后的异步回调执行浏览器操作。
净化:文档或保存工作流时用占位符替换真实值,如域名 example-app.test、URL https://example-app.test/login、邮箱 user@example.test、账户标签 Example Account、rendezvous code [rendezvous-code]、指纹/会话/合约/条目 ID [id];不要提交本地应用 URL、账户名、邮箱、租赁/申请数据、密钥或含用户特定细节的记录片段。