原始来源日期:2026-10-02。

原文编译

GitHub完成GitHub App installation access token的新格式迁移。新令牌设计为无状态验证,字符串长度约520字符,并以能够携带App标识与JWT结构的ghs_前缀形式出现。旧令牌会按原有生命周期自然过期,调用权限模型没有因此扩大。

官方说明仓库选择、授予权限和约一小时有效期保持不变。变化主要落在令牌表示与验证基础设施,而不是应用授权语义。临时兼容覆盖请求头只用于过渡,并计划在2026年11月30日弃用,集成方不能把它当作长期开关。

最常见的破坏点在令牌外层系统:数据库列长度、密钥保险库字段、代理请求头上限、日志截断、DLP规则和只识别旧长度的秘密扫描正则。把令牌解析成固定结构也会造成未来不兼容;GitHub建议客户端把它视作不透明字符串。

更长令牌还会暴露测试盲区。若单元测试只使用短假令牌,生产中的HTTP库或中间件可能在写头部时失败;若日志脱敏仍按旧正则匹配,新格式可能被完整记录。迁移验证应覆盖生成、存储、转发、轮换与销毁全链路。

量仔观察

本站建议先搜索代码库和基础设施中的长度常量、ghs_正则与VARCHAR定义,再用测试App签发真实格式令牌走一遍CI/CD。检查日志和错误追踪是否只显示掩码,往往比API调用成功更重要。

权限不变不代表没有安全工作。令牌格式升级正好暴露系统是否把秘密当作不透明、短寿命凭据处理。完成兼容后应删除临时覆盖头,避免在11月底后出现隐性依赖。