Tourmind-Booking-Skills安全实践:Token防泄露、文件权限600与401认证失败恢复策略

原创2026-10-10 18:18:481,996 阅读

Tourmind-Booking-Skills安全实践:Token防泄露、文件权限600与401认证失败恢复策略

Tourmind-Booking-Skills 是一套让 AI Agent 端到端完成酒店与机票预订的技能包:实时比价、验价、下单、取消和支付都通过 TourMind API 完成。因为涉及真实的账号认证和资金操作,它的安全设计格外值得新手参考。本文用通俗语言讲清三件事:Token 防泄露机制、skill_token.txt 文件权限 600 的含义,以及遇到 401 认证失败时的恢复策略,帮你安全地把 AI 预订助手用起来。

一、先认识 Tourmind-Booking-Skills 的凭证体系

要理解安全机制,先要理解 Token 是怎么用的。

概念 说明
共用 Token 酒店技能与机票技能共用同一个 TourMind Skill Token,只需申请一次
uk_ 前缀 个人渠道凭证(ToC),用于个人用户
sk_ 前缀 企业渠道凭证(ToB),用于企业用户
存储位置 安装目录下的 skill_token.txt 文件,由 Agent 自动保存,用户无需手动管理
读取顺序 先读当前技能目录的文件,文件为空时再读兄弟技能目录的文件

🔑 几个关键设计:

  • 免 Token 也能用一部分功能:酒店搜索、机场查询、机票实时搜索不需要 Token;只有验价、下单、查单、支付这类"受保护操作"才强制认证。
  • 前缀只是选路,不是授权证明:Token 前缀决定走哪个渠道,但"保存成功"不代表"有权限",服务端响应才是最终权威。
  • 渠道严格绑定:uk_ 只能发往个人渠道字段,sk_ 只能发往企业渠道字段,一次请求中绝不混发两个字段。规则见 skills/tourmind-booking/SKILL.md 的 "API and authentication" 一节。

二、Token 防泄露:从写入到输出全链路管控

泄露凭证是 AI 工具最常见的安全事故。Tourmind-Booking-Skills 在四个环节做了硬约束:

1. 写入环节:落盘不落地(屏幕)

当你在私密对话中把 Token 发给 Agent 后,Agent 会:

  1. 去除首尾空白,仅接受以 uk_ 或 sk_ 开头的完整 Token;
  2. 安全写入 {baseDir}/skill_token.txt,覆盖该技能原有的凭证;
  3. 之后永远不重复输出完整 Token——不出现在回复、日志、截图、Git 提交、Issue 或共享报告中。

2. 读取环节:禁止回显

技能规范明确要求"读取和保存凭证时不得打印其内容":不 cat 文件、不把 Token 拼进可见命令行参数、不开启请求头调试输出。甚至配置完成后也只确认"已配置",不复述任何前缀、后缀或打码片段。规则来源:skills/flight-booking-ai/SKILL.md 的 "Credential lifecycle" 章节。

3. 传输环节:字段与渠道一一对应

渠道 凭证 发送方式
个人(ToC) uk_... 仅在接口契约接受 user_key 时发送
企业(ToB) sk_... 以 token 字段(或 X-Skill-Token 头)发送
无凭证 无 仅走公开接口,不发送任何身份字段

永远不把 Token 放进 URL 或 JSON 请求体其他位置,避免被访问日志和分享链接二次泄露。

4. 更新环节:升级不覆盖凭证

技能自动更新流程有一条铁律:任何更新都绝不允许静默覆盖本地修改或任一技能的 skill_token.txt,防止升级过程把凭证弄丢或被篡改。

三、文件权限 600:chmod 600 skill_token.txt 是什么意思?

🛡️ 在 macOS 或 Linux 上,Agent 保存 Token 后会执行 chmod 600 skill_token.txt。

权限位 含义
6 = 读写(rw) 属主(当前用户)可以读取和修改文件
0 同组用户无任何权限
0 其他用户无任何权限

通俗地说:600 表示 只有当前用户本人能读写 Token 文件,同一台机器上的其他账号、以及运行在其他用户身份下的进程都无法偷读。相比默认的 644(其他用户可读),这一步把"本机多用户共享"场景下的凭证窃取风险直接消除。

对普通用户的实际意义:你不需要自己创建或编辑任何文件,Agent 已经替你处理了;但如果你好奇,可以用 ls -l skill_token.txt 看到 -rw------- 这样的权限串,确认防护生效。安全总览可参考 README.md 的 "Token and security" 章节。

四、401 认证失败恢复策略:清除、停止、换证、重建

当受保护请求返回 HTTP 401、unauthorized 或 invalid_token 时,技能不会"默默换条路再试一次",而是走一套完整的恢复流程。完整定义见 skills/flight-booking-ai/references/authentication.md。

第一步:立即清除被拒凭证并停止

  • 从记录的来源文件(机票技能或酒店技能的 skill_token.txt)中删除该凭证,并清出所有可复用的请求头;
  • 停止本次操作,绝不自动重试;
  • 清除和保存过程中不输出任何凭证内容。

第二步:明确"不许做什么"(负面清单)

这一部分是整个策略最有价值的地方:

诱惑场景 正确行为
"同一个 Token 再试一次" 零次受保护调用,被拒 Token 永不复用
"我接受风险,就用一次" 风险接受不构成授权,仍不重试
"换组日期/换个参数再试" 改变参数不等于修复认证,仍停止
"去别的安装、备份、环境变量、历史记录里找个 Token" 禁止跨位置翻找任何替代凭证
"悄悄降级成匿名搜索" 不允许静默降级;公开机场查询仍可用,但它不能证明授权,也不能恢复失败的受保护操作
"换成另一个技能的 Token 顶一下" 同一次恢复中禁止回退到兄弟技能文件

第三步:通过官方路径获取替换 Token

  • 个人用户:前往 Journione 登录页(auth.journione.ai)验证邮箱后获取新的 uk_ Token;
  • 企业用户:登录 TourMind 账号后,在 Skill Token 页面(tourmind.com/user/skill-token)创建新的 sk_ Token;没有企业账号则先注册;
  • 渠道未知时:同时展示两条路径,不替用户做选择。

收到替换 Token 后同样"安全保存、不回显"。特别注意:保存不等于授权——Agent 不会仅因为收到了新 Token 就自动补发之前失败的请求,只有当你明确请求或批准下一个受保护操作时才使用它。也不允许"自创一个验证接口"来测 Token,更严禁用 create_booking 或 create_payment 这类会产生订单/支付的操作来试探凭证。

第四步:安全恢复业务流

Token 更换会使此前的报价、验价会话、乘客信息确认和支付上下文全部失效,因此:

  1. 若之前是搜索类操作:重新搜索、展示新结果、等待你重新选择;
  2. 若之前是下单/支付且结果不明:先对账(查询已知订单状态),保留"是否已下单"的不确定性,绝不自动重放创建请求;
  3. 后续任何下单或支付都必须重新走完整审查 + 显式确认流程;
  4. 已有订单绑定创建它的渠道,需用前缀匹配的凭证访问,绝不拿另一个渠道的 Token 去探测。

📢 面向用户的回复也有规范:使用固定的"认证恢复"模板(response_templates.md 的 Authentication recovery 一节),只说明哪个操作未完成、如何获取新 Token、下一步做什么,不展示原始认证错误,也不泄露任何 Token 片段。

别混淆:401 的三种"相似"情况

响应 含义 处理方式
HTTP 401 / invalid_token Token 失效 走上述完整恢复流程
HTTP 403 + HOTEL_BUSINESS_PERMISSION_REQUIRED Token 有效,但账号未开通酒店企业权限 不删除 Token、不重试,联系账号管理员开通
verify_offer 业务码 20105 搜索后 Token 发生了变化 保留当前 Token,重新搜索一次展示新报价,请用户重新选择(见 parameter_guide.md 的 token-change recovery)

五、这些规则如何被验证:行为回归测试

规则写在文档里不算数,Tourmind-Booking-Skills 用离线行为回归测试来"考试",全程使用合成凭证、不触碰真实接口:

  • tests/flight-booking-ai/auth_recovery.md:A–G 七组序列,覆盖"拒绝后清除凭证""重试诱惑免疫""换证后只执行用户授权的一次调用""永不重放下单/支付""只读凭证测试""20105 报价刷新""共享 Token 发现边界"等场景。例如 Sequence A 中,即使用户连续施压"再试一次""我接受风险""换个日期""去备份里找个 Token",验收标准都是零受保护调用。
  • tests/flight-booking-ai/payment_safety.md:验证支付创建前的"可支付订单白名单"和最终二次查询门禁,确保认证恢复后也不会产生重复支付。
  • tests/test_repository.py:保证仓库结构、技能命名与版本同步等基础约束。

六、给新手的安全使用清单

把以下习惯当成默认操作,基本就能安全使用这套技能:

  • [x] Token 只在私密对话中发给可信的 Agent,不发公开渠道;
  • [x] 不在 Prompt、日志、截图、URL、Git 提交或 Issue 中粘贴完整 Token;
  • [x] 让 Agent 自动管理 skill_token.txt,无需手工编辑文件;
  • [x] 看到 401 时不催促"快点重试",配合 Agent 走"清除 → 官方换证 → 重新选择/确认"流程;
  • [x] 下单、支付、取消前,认真核对 Agent 展示的完整审查表并显式确认;
  • [x] 更新技能后确认 Token 文件仍在(更新流程保证不会覆盖它)。

总结

Tourmind-Booking-Skills 的安全模型可以浓缩为一句话:写入不落屏、传输绑渠道、存储 600 隔离、失效即清除、恢复不自动。对新手而言,你真正需要记住的只有两点——把 Token 只发给自己信任的 Agent;遇到认证失败时给流程一点耐心,让"清除—换证—重新确认"完整走完。安全不是多出来的步骤,而是这套预订能力本身的一部分。

登录后查看全文
Tourmind-Booking-Skills