关于向 GitHub 验证

您可以根据身份验证位置使用不同的凭据，向 GitHub Enterprise Server 验证来安全地访问帐户的资源。

本文内容

关于 GitHub 向验证身份

为确保帐户安全，必须先进行身份验证，然后才能访问 GitHub Enterprise Server 上的某些资源。 向 GitHub Enterprise Server 验证时，您提供或确认您唯一的凭据，以证明您就是声明者。

您可以通过多种方式访问 GitHub Enterprise Server 中的资源：浏览器中、通过 GitHub Desktop 或其他桌面应用程序、使用 API 或通过命令行。 每种访问 GitHub Enterprise Server 的方式都支持不同的身份验证模式。

  • 你的标识提供者 (IdP)
  • 使用双因素身份验证的用户名和密码
  • Personal access token
  • SSH 密钥

在浏览器中进行身份验证

你可以在浏览器中以多种方式向 GitHub Enterprise Server 验证。

  • 仅用户名和密码

    • 在 GitHub Enterprise Server 上创建帐户时，你将创建一个密码。 我们建议您使用密码管理器生成随机且唯一的密码。 有关详细信息，请参阅“创建强密码”。

  • 双因素身份验证 (2FA) （推荐）

    • 如果你启用 2FA，则在成功输入用户名和密码后，我们还将提示你提供基于时间的一次性密码 (TOTP) 应用程序在移动设备 的其余部分。 有关详细信息，请参阅“使用双重身份验证访问 GitHub”。

    • 除了使用 TOTP 应用程序进行身份验证外，你还可以选择使用 WebAuthn 添加采用安全密钥的备用身份验证方法。 有关详细信息，请参阅 “配置双重身份验证”。

  • 外部身份验证

    • 站点管理员可以将 你的 GitHub Enterprise Server 实例 配置为使用外部身份验证，而不是使用用户名和密码。 有关详细信息，请参阅“关于身份和访问管理”。

会话 Cookie

GitHub 使用 Cookie 提供服务和保护 你的 GitHub Enterprise Server 实例。

  • gist.HOSTNAME 域 和 实例的基本域 使用单独的 Cookie。
  • GitHub Enterprise Server 通常会在两周处于非活动状态后将用户会话标记为删除。
  • GitHub Enterprise Server 在注销时不会立即删除会话。GitHub Enterprise Server 会定期自动删除过期的会话。

向 GitHub Desktop 验证身份

您可以使用浏览器向 GitHub Desktop 验证身份。 有关详细信息，请参阅“在 GitHub Desktop 中向 GitHub 进行身份验证”。

使用 API 验证身份

您可以通过不同方式使用 API 进行身份验证。 有关详细信息，请参阅“对 REST API 进行身份验证”。

使用 personal access token 对 API 进行身份验证

如果要将 GitHub REST API 用于个人用途，可以创建 personal access token。 如果可能，GitHub 建议使用 fine-grained personal access token 而不是 personal access token (classic)。 有关创建 personal access token 的详细信息，请参阅“管理个人访问令牌”。

使用应用对 API 进行身份验证

如果要代表组织或其他用户使用 API，GitHub 建议使用 GitHub App。 有关详细信息，请参阅“关于使用 GitHub 应用进行身份验证”。

你还可以使用 OAuth app 创建 OAuth 标记以访问 REST API。 但 GitHub 建议改用 GitHub App。 使用 GitHub Apps 可以更好地控制应用拥有的访问权限和权限。

在 GitHub Actions 工作流中对 API 进行身份验证

如果要在 GitHub Actions 工作流中使用 API，则 GitHub 建议使用内置 GITHUB_TOKEN 进行身份验证，而不是创建令牌。 可以使用 permissions 密钥向 GITHUB_TOKEN 授予权限。

请注意，GITHUB_TOKEN 只能访问包含工作流的存储库中的资源。 如果需要对工作流存储库外部的资源进行更改，则需要使用 personal access token 或 GitHub App。

有关详细信息，请参阅“自动令牌身份验证”。

使用命令行进行身份验证

您可以通过两种方式从命令行访问 GitHub Enterprise Server 上的仓库：HTTPS 和 SSH ，两者采用不同的身份验证。 验证方法取决于克隆仓库时您是选择 HTTPS 还是 SSH 远程 URL。 有关访问方式的详细信息，请参阅“关于远程仓库”。

HTTPS

即使您在防火墙或代理后面，也可以通过 HTTPS 处理 GitHub Enterprise Server 上的所有仓库。

如果使用 GitHub CLI 进行身份验证，可以使用 personal access token 或通过 Web 浏览器进行身份验证。 有关使用 GitHub CLI 进行身份验证的详细信息，请参阅 gh auth login。

如果不使用 GitHub CLI 进行身份验证，则必须使用 personal access token 进行身份验证。 当 Git 提示你输入密码时，请输入你的personal access token。 或者，可以使用 Git 凭据管理器等凭据帮助程序。 Git 的基于密码的身份验证已被删除，取而代之的是更安全的身份验证方法。 有关详细信息，请参阅“管理个人访问令牌”。除非你使用凭据小助手缓存了凭据，否则每次使用 Git 向 GitHub Enterprise Server 验证时，系统都会提示你输入凭据以向 GitHub Enterprise Server 验证。

SSH

您可以通过 SSH 处理 GitHub Enterprise Server 上的所有仓库，尽管防火墙和代理可能拒绝允许 SSH 连接。

如果您使用 GitHub CLI 进行身份验证，CLI 会在您的机器上找到 SSH 公共密钥，并提示您选择一个用于上传。 如果 GitHub CLI 找不到用于上传的 SSH 公钥，则可以生成新的 SSH 公钥/私钥对，并将公钥上传到你在 你的 GitHub Enterprise Server 实例 上的帐户。 然后，可以使用 personal access token 进行身份验证，也可以通过 Web 浏览器进行身份验证。 有关使用 GitHub CLI 进行身份验证的详细信息，请参阅 gh auth login。

如果不使用 GitHub CLI 进行身份验证，则需要在本地计算机上生成 SSH 公钥/私钥对，并将公钥添加到你在 你的 GitHub Enterprise Server 实例 上的帐户。 有关详细信息，请参阅“生成新的 SSH 密钥并将其添加到 ssh-agent”。 除非你已存储密钥，否则每次使用 Git 向 GitHub Enterprise Server 进行身份验证时，系统都会提示你输入 SSH 密钥密码。

GitHub 的令牌格式

以前缀开头的 GitHub 议题令牌表示令牌的类型。

令牌类型前缀详细信息
Personal access token (classic)ghp_“管理个人访问令牌”
Fine-grained personal access tokengithub_pat_“管理个人访问令牌”
OAuth 访问令牌gho_"授权 OAuth 应用"
GitHub App 的用户访问令牌ghu_"代表用户使用 GitHub 应用进行身份验证"
GitHub App 的安装访问令牌ghs_"验证为 GitHub 应用程序安装"
GitHub App 的刷新令牌ghr_"刷新用户访问令牌"