网易首页 > 网易号 > 正文 申请入驻

每个编码代理配一把独立API密钥,为什么值得较真?

0
分享至

一个代理一把密钥,权限只覆盖它那份活需要的仓库和动作,再设上过期时间。这样一次泄露或一次失控循环,都能被单独追溯、单独吊销,不牵连其他任何东西。在 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.

相关推荐
热点推荐
女主任被火箭提拔,调查一出,三名男官员同时翻车

女主任被火箭提拔,调查一出,三名男官员同时翻车

丞丞故事汇
2025-07-17 15:39:30
《新聊斋》正式定档!宋祖儿演树妖姥姥,林允一人分饰两角

《新聊斋》正式定档!宋祖儿演树妖姥姥,林允一人分饰两角

天玑影视说
2026-11-16 15:10:23
《多喜一家人》口碑爆棚,本是冲着蒋欣来的,却被46岁男配吸引

《多喜一家人》口碑爆棚,本是冲着蒋欣来的,却被46岁男配吸引

天玑影视说
2026-11-17 09:32:41
WTI原油突破87美元/桶,日内涨1.50%

WTI原油突破87美元/桶,日内涨1.50%

每日经济新闻
2026-11-17 21:50:06
网传不少中产已经放弃托举下一代了,阶层要更加固化了!

网传不少中产已经放弃托举下一代了,阶层要更加固化了!

黯泉
2026-11-16 17:37:25
刚洗白,与未成年交往事件,金秀贤又迎“噩耗”,这回麻烦大了

刚洗白,与未成年交往事件,金秀贤又迎“噩耗”,这回麻烦大了

乡野小珥
2026-11-16 05:52:48
森保一将卸任日本队主帅,8年执教日本取得77胜17平19负

森保一将卸任日本队主帅,8年执教日本取得77胜17平19负

懂球帝
2026-11-17 23:43:09
二战时,日军给女性强行注射“606药剂”,注射完,士兵就露出了邪恶的笑容,“606药剂”究竟是啥?

二战时,日军给女性强行注射“606药剂”,注射完,士兵就露出了邪恶的笑容,“606药剂”究竟是啥?

回京历史梦
2026-11-10 17:49:16
国务院关于出境入境管理的规定(全文)

国务院关于出境入境管理的规定(全文)

澎湃新闻
2026-07-31 17:31:07
李宗伟现状:瘦到快脱相,吃饭都很痛苦,已是马来西亚羽总主席

李宗伟现状:瘦到快脱相,吃饭都很痛苦,已是马来西亚羽总主席

青梅侃史啊
2026-09-26 16:37:23
特朗普:不介意黄仁勋重掌英伟达

特朗普:不介意黄仁勋重掌英伟达

界面新闻
2026-11-16 23:00:15
eSIM落地一年后体验好了吗?我们和几位初代用户聊了聊

eSIM落地一年后体验好了吗?我们和几位初代用户聊了聊

雷科技
2026-11-17 13:21:36
DeepSeek开始限制使用,网友涌入官方评论区

DeepSeek开始限制使用,网友涌入官方评论区

政知新媒体
2026-11-16 23:11:43
1979年,翁美玲与男友罗柏前往威尼斯出游,1米58的她穿吊带裙与罗柏牵手漫步,镜头下甜蜜画面却藏着不为人知的结局

1979年,翁美玲与男友罗柏前往威尼斯出游,1米58的她穿吊带裙与罗柏牵手漫步,镜头下甜蜜画面却藏着不为人知的结局

磊子讲史
2026-11-04 15:53:33
90后河南女孩的“裸女图”:没有情色,只有美

90后河南女孩的“裸女图”:没有情色,只有美

一条
2026-11-02 10:59:16
突发!俄军一架安-12BK空中起火坠毁,17人恐全部遇难

突发!俄军一架安-12BK空中起火坠毁,17人恐全部遇难

老马拉车莫少装
2026-11-18 00:01:20
赵本山分红拿大头被骂多年,赵四直播道出真相:只看到他吃肉,没看见他挨打

赵本山分红拿大头被骂多年,赵四直播道出真相:只看到他吃肉,没看见他挨打

财叔
2026-09-30 16:30:20
【2026.11.16】爆姐的饭后爆料:生命不止,爆料不息!

【2026.11.16】爆姐的饭后爆料:生命不止,爆料不息!

娱乐真爆姐
2026-11-17 00:52:03
《GTA6》地图太大了 新海报实拍展示超多元素

《GTA6》地图太大了 新海报实拍展示超多元素

游民星空
2026-11-15 19:19:31
乔布斯剧本要重演?黄仁勋手握1300亿,华尔街先慌了!

乔布斯剧本要重演?黄仁勋手握1300亿,华尔街先慌了!

可乐爱微笑
2026-11-17 06:52:02
2026-11-18 01:47:00
灰度测试中
灰度测试中
生活正在重构,目前还在灰度测试阶段,暂不全量发布。
212文章数 90关注度
往期回顾 全部

科技要闻

硅谷大佬组局,帮黄仁勋杀回来!

头条要闻

中国女子在希腊失踪半年 保险箱发现10万欧元现金

头条要闻

中国女子在希腊失踪半年 保险箱发现10万欧元现金

体育要闻

伪强队?拥4亿豪阵欧国联6连败+世界杯出局

娱乐要闻

陈晓楠对话厉娜和许飞引全网热议

财经要闻

10万人逼宫英伟达,黄仁勋要复职了?

汽车要闻

更豪华更好开 问界新M8细节升级见真章

态度原创

艺术
教育
游戏
房产
公开课

艺术要闻

漫天香氛,秋风醉人~杭州的秋天从不让人失望!13个地方,秒出大片!

教育要闻

济南市历下区燕山小学教育集团将出席2026第四届课博会,解码“做中学”视域下小学科学教育生态构建

小伙表示连玩7天《GTA6》 这下PS5可惨了

房产要闻

6.6亿!海口卖地!

公开课

李玫瑾:为什么性格比能力更重要?

无障碍浏览 进入关怀版