已转移至组织的Github App不显示「Install App」按钮及故障求助

无「Install App」按钮问题说明 #

• 你仅拥有App管理者权限，不具备组织管理员权限时，本来就无法看到组织层面的App安装按钮，该按钮仅对组织所有者/具备App安装权限的管理员开放，属于正常的权限控制逻辑，无需额外排查。

JWT解码失败401报错排查 #

• 校验JWT生成逻辑
  • 确认你使用的是App转移到组织后重新生成的私钥文件签名JWT，App转移完成后原有个人名下生成的私钥会直接失效，必须到组织名下的App设置页「Private keys」区域重新生成新私钥使用
  • 校验JWT核心参数配置：过期时间exp最长不能超过10分钟，签发时间iat需要和GitHub服务器时间差控制在1分钟内，建议先同步本地系统时间
  • 确认签名算法使用RS256，GitHub App不支持HS256等其他签名算法
  • 确认Payload字段iss填写的是转移到组织后的App ID，不是你个人账号下创建App时的旧ID，两个ID不一致会直接触发解码失败
• 校验安装请求参数
  • 调用接口获取安装令牌时，必须填写正确的组织级安装ID，该ID仅组织管理员可在App安装详情页查看，不要使用测试阶段的个人账号安装ID
  • 确认App安装时管理员授予的权限和App本身配置的权限范围一致，App权限变更后需要管理员重新安装更新权限，否则也会触发认证报错

可查询的相关日志 #

• 组织管理员可以在组织设置的「Logs」-「Audit log」区域筛选github_app相关操作日志，可查看App安装、权限变更、认证请求失败的详细原因
• 作为App管理者可以在App设置页的「Advanced」-「Recent deliveries」区域查看所有API请求的请求/响应详情，包括JWT认证失败的具体报错参数

内容的提问来源于stack exchange，提问作者johnfo