适用范围与准备
适用于要创建 GitHub 的细粒度个人访问令牌。两步验证丢了以后怎样恢复是另一篇。经典令牌的创建点击这次没有显示,不写。
先区分原因
个人访问令牌可以代替密码用于 GitHub API 或命令行。要像密码一样对待。它代表你访问资源。组织或长期集成应该用 GitHub App,那一页没有打开。令牌拥有所有者的能力,再被范围或权限限制,不能给出所有者本来没有的权限。页面举例,令牌可以被授予 admin:org,但所有者如果不是组织所有者,令牌也不会变成组织管理权限。类型有推荐的细粒度,以及经典。细粒度做不到经典的每一项。两者都绑在用户上,用户失去资源访问后令牌失效。组织所有者可以限制经典令牌,政策页没有打开。细粒度的好处是只针对一个用户或一个组织、指定仓库、指定权限,而不是经典的范围,组织所有者还可以要求批准。做不到的包括:向你不是成员的公共仓库贡献,作为外部协作者或仓库协作者贡献,同时覆盖多个组织,Packages,Checks API,以及用户账户拥有的 Projects。经典更不安全。只有经典能写你不拥有、而且你也不属于其组织的公共仓库。外部协作者对所协作的组织仓库只能用经典令牌。有些 REST 端点只有经典能用,名单没有打开。经典令牌能访问你能进入的组织里的全部仓库,以及全部个人仓库。一年没用的个人访问令牌会被自动移除。应该设置到期时间。命令行优先用 GitHub CLI 或 Git Credential Manager,Actions 里用 GITHUB_TOKEN,那几份指南没有打开,这里只点名。如果一定要创建,可以由别的 CLI 保存,或存成 Actions 机密、Codespaces 机密,那几页没有打开。细粒度最多 50 个。更多令牌或自动化应该改用 GitHub App。创建前如有需要先验证邮箱。然后从头像进设置、开发者设置、个人访问令牌、细粒度令牌、生成新令牌。填写名称和到期时间。允许无限期,但组织或企业的最长寿命政策可能拦住。描述可选。资源所有者里,已经禁止细粒度令牌的组织不会出现。组织要求批准时要写理由。仓库访问选最小范围。令牌总是包含所有公共仓库的只读。选仅选定仓库时再挑仓库。权限选最小的。仓库、组织和账户权限取决于所有者和仓库访问。然后生成。组织要求批准而你不是所有者时,令牌处于待批准,在批准前只能读取公共资源。所有者自己的请求会自动批准。不要把令牌或示例查询地址抄进笔记。
按顺序操作
- 先考虑能不能用 GitHub CLI、凭据管理器或 Actions 的 GITHUB_TOKEN,而不新建令牌。
- 仍要细粒度令牌时,从头像进入设置、开发者设置、个人访问令牌、细粒度令牌。
- 生成时只选一个资源所有者,仓库和权限都选最小。
- 组织要求批准时写下理由。你不是所有者的话,批准前只能读公共资源。
- 生成后只在当时保存。不要为了超过 50 个而继续新建,改用 GitHub App。
对照
| 类型 | 边界 |
|---|---|
| 细粒度 | 一个用户或一个组织 |
| 数量 | 最多 50 个 |
| 公共仓库 | 总是有只读 |
| 待批准 | 批准前只能读公共资源 |
| 一年未用 | 会被自动移除 |
怎样确认有效
生成后列表里出现这条令牌,资源所有者只有你选的那一个。超过权限的操作不会因为令牌而成功。
无效时恢复与下一步
没有改网络。经典令牌的创建点击没有显示。令牌正文和示例地址都不要记进文章或聊天。丢失两步验证时看另一篇。