一个代理一把密钥,权限只覆盖它那份活需要的仓库和动作,再设上过期时间。这样一次泄露或一次失控循环,都能被单独追溯、单独吊销,不牵连其他任何东西。在 GitHub 上,这意味着细粒度个人访问令牌,或者 GitHub App 的安装令牌;在 Latchkey 上,则是一把按访问预设创建、带过期时间的代理专属密钥。
![]()
一把密钥对应一个代理,就把"这个令牌到底干了什么"变成了只有一个答案的问题,也让吊销变成局部事件。
默认做法是:一个令牌粘进所有工具——笔记本上的命令行、编辑器里的代理、CI 里的机器人。它一直能用,直到出事;出事之后没人说得清是哪一个跑的任务,而吊销令牌会一次性打断所有工具。一代理一密钥把这两个问题一起解决。
在铸造密钥之前,先替这个代理回答四个问题:它能读什么,它能启动什么,它能花多少,它该在什么时候停止工作。剩下的就是每个答案在 GitHub 和 Latchkey 上分别落到哪里。
GitHub 方案一:细粒度个人访问令牌
细粒度令牌被限制在单个用户或组织拥有的资源内,还能进一步限定到具体仓库,携带的是具体权限而非宽泛的作用域。组织所有者可以要求令牌经审批后才生效。要触发一个工作流,端点需要该仓库的 Actions 权限为写。
GitHub 允许把令牌模板以链接形式分享,字段预先填好。expires_in 接受 1 到 366 天,或 none;除非组织或企业策略禁止,否则允许无限期。每个代理角色铸一条链接,存进你的运行手册。
有两个坑。其一,令牌以其所有者的身份行事,受其权限封顶,所以它启动的运行会被记成你的。其二,细粒度令牌无法调用 Checks API,这也是 gh run watch 在自己的帮助里写明不支持它们的原因。
GitHub 方案二:GitHub App 安装令牌
App 给代理一个属于自己的身份,其安装令牌一小时后过期。铸造时你可以把它收窄到指定仓库、收窄到 App 权限的一个子集;它永远不能超出安装时被授予的范围。
在工作流内部,由 actions/create-github-app-token 负责铸造。每个权限对应一个独立的 permission- 输入,其 README 建议显式列出,因为默认情况下令牌会继承安装的全部权限。除非设置 skip-token-revoke,任务完成时令牌即被吊销。
怎么选,看代理活多久、它的运行该记在谁名下。
Latchkey:一代理一密钥,从预设出发
Latchkey 的密钥在"设置—API 密钥与代理"里由所有者和管理员铸造。按密钥将驻留的位置命名,选一个过期时间(默认是"永不",其余选项为 30、60、90 天和 1 年),再选它的访问级别。只读是默认值。每一次写都是创建时固定的单独选项:已有密钥无法升级,有新需求就得铸新密钥。
密钥按工作区隔离,完整内容只展示一次,存储时哈希处理,随时可吊销;被吊销的密钥一分钟内失去访问权,并保留在列表里供审计。
预设要和代理对上:读取失败信息的分诊代理需要只读;验证自己改动的代理需要 CLI runner;修完之后重跑 GitHub Actions 工作流的代理需要 Dispatch,仅此而已。让代理远离完全访问:Latchkey 的文档指出,一把持有 jobs:approve 的密钥若同时握在能推送的代理手里,它就能批准自己改动的运行,中间没有第二个人做决定。
把密钥通过环境变量交给代理,而不是文件。CLI 读取 LATCHKEY_TOKEN,一个只读的状态探针可以检查密钥及其作用域,而不创建任何东西。
归因是这一切的理由,所以要检查它。"设置"里有"代理活动"标签页,显示每个代理的密钥跑了什么。在终端里,latchkey list 打印的 KEY 列会写明启动每个任务的密钥,API 密钥表则显示每把密钥最后一次使用的时间,对 30 天未使用的密钥做出标记。
密钥本身没有消费预算。要约束代理的花费,得通过它的工作来限定,比如用按代理命名的批处理预算。当代理开始收到 401,说明密钥已被吊销或到了过期时间:铸一把新的,而不是放宽旧的。
FAQ 里还有两个常被问到的点。长期自动化用 GitHub App 更合适:安装令牌一小时过期,携带的是 App 身份而非个人身份,还能按令牌收窄;细粒度 PAT 创建更简单,适合单人的代理,但它启动的运行会归到那个人头上。安装令牌的有效期就是一小时,令牌响应里包含过期时间,Octokit 各 SDK 会在到期时自动重新生成。细粒度 PAT 能否触发工作流?可以,只要它在该仓库上有 Actions 写权限,这正是工作流触发端点所要求的;工作流本身还需声明 on: workflow_dispatch。
特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.