GitHub Connect 允许 你的 GitHub Enterprise Server 实例 在 GitHub Enterprise Cloud 上以有限的方式连接到你的企业。
启用 GitHub Connect后,可以选择要启用的功能。 例如,可以:
- 在环境之间自动同步许可证使用情况
- 统一搜索结果和用户贡献数据
- 启用依赖 GitHub.com 的功能,例如用于处理在 Dependabot alerts 中跟踪的安全漏洞的 GitHub Advisory Database
关于连接
若要启用 GitHub Connect,请配置 你的 GitHub Enterprise Server 实例 与 GitHub.com 或 GHE.com 上的企业帐户之间的连接。 连接通过端口 443 或 80 使用 HTTPS,并受 TLS 保护。
- GitHub Connect 不将 你的 GitHub Enterprise Server 实例 向公共互联网开放。
- 企业的私有数据都不会向 GitHub Enterprise Cloud 用户公开。
- GitHub Connect 仅传输启用的功能所需的有限数据。 除非启用许可证同步,否则不会传输任何个人数据。 有关详细信息,请参阅“数据传输”。
- 启用 GitHub Connect 将不允许 GitHub Enterprise Cloud 用户更改 GitHub Enterprise Server。
GitHub Connect 功能
配置 你的 GitHub Enterprise Server 实例 与 GitHub Enterprise Cloud 之间的连接后,您可以启用 GitHub Connect 的各项功能。
如果您要连接到企业网络,请使用GHE.com:
- 服务器统计信息不可用。
- GitHub.com 操作不可用。
| 特性 | 说明 | 详细信息 |
|---|---|---|
| 自动用户许可证同步 | 通过自动将用户许可证从 GitHub Enterprise 同步到 你的 GitHub Enterprise Server 实例 来管理 GitHub Enterprise Cloud 部署中的许可证使用情况。 | 启用企业用户许可证的自动同步 |
| Dependabot |允许用户查找和修复代码依赖项中的漏洞。 | 为企业启用 Dependabot | | GitHub.com 操作 | 允许用户在公共工作流文件中使用来自 GitHub.com 的操作。 | 使用 GitHub Connect 启用对 GitHub.com操作的自动访问 | |Server Statistics |分析来自 GitHub Enterprise Server 的聚合数据,并帮助我们改进GitHub产品。 | 为企业启用服务器统计功能 | | 统一搜索 | 从 GitHub Enterprise Cloud 搜索时,允许用户在搜索结果中包含 你的 GitHub Enterprise Server 实例 上的存储库。 | 启用企业统一搜索功能 | | 统一贡献 | 允许用户将经过匿名处理的工作贡献计数包含在 你的 GitHub Enterprise Server 实例 上贡献图的 GitHub Enterprise Cloud 中。 | 为企业启用统一贡献 |
数据传输
启用 GitHub Connect 后,GitHub Enterprise Cloud 上的一条记录会存储有关该连接的信息。 如果启用单个功能 GitHub Connect,则会传输其他数据。
注意
代码库、issue 或拉取请求都绝不会由 GitHub Enterprise Server 从 GitHub Enterprise Cloud 传输到 GitHub Connect。
在启用 GitHub Connect 时传输的数据
启用 GitHub Connect 或特定的 GitHub Connect 功能时,GitHub Enterprise Cloud 上的一条记录会存储有关该连接的以下信息。
- 您的许可证中的 GitHub Enterprise Server 公钥部分
- 你的 GitHub Enterprise Server 许可证的哈希值
- 您的 GitHub Enterprise Server 许可证上的客户名称
- 你的 GitHub Enterprise Server 实例 的版本
- 你的 GitHub Enterprise Server 实例 的主机名
- GitHub Enterprise Cloud 上连接到 你的 GitHub Enterprise Server 实例 的企业帐户
- 由 你的 GitHub Enterprise Server 实例 用于向 GitHub Enterprise Cloud 发送请求的身份验证令牌
- 如果在 你的 GitHub Enterprise Server 实例 上启用了并配置了传输层安全性(TLS)
- 在 GitHub Connect 上启用的 你的 GitHub Enterprise Server 实例 功能,以及启用的日期和时间
- 企业休眠阈值
- 企业休眠用户数
- 已消耗的许可证数量,不包括已暂停的用户
GitHub Connect从启用你的 GitHub Enterprise Server 实例的日期和大致时间开始,每周同步GitHub Enterprise Cloud和GitHub Connect之间的上述连接数据。
由 GitHub Connect 的各项功能传输的数据
如果启用单个功能 GitHub Connect,则会传输其他数据。
| 特性 | 数据 | 数据流采用哪种方式? | 在哪里使用了数据? |
|---|---|---|---|
| 自动用户许可证同步 | 每个GitHub Enterprise Server用户的用户 ID 和电子邮件地址,以及该用户是否占用 GitHub Advanced Security、GitHub Code Security 或 GitHub Secret Protection 的许可证。 | 从GitHub Enterprise Server到GitHub Enterprise Cloud | GitHub Enterprise Cloud |
| Dependabot alerts | 漏洞警报 | 从GitHub.com到GitHub Enterprise Server | GitHub Enterprise Server |
| Dependabot updates | 依赖项和每个依赖项的存储库的元数据 如果依赖项存储在专用存储库 GitHub.com中,则仅当配置并授权访问该存储库时 Dependabot ,才会传输数据。 | 从GitHub.com到GitHub Enterprise Server | GitHub Enterprise Server |
| GitHub.com 操作 | 操作名称,操作(YAML 文件来自 GitHub Marketplace) | 从GitHub.com到GitHub Enterprise Server 从GitHub Enterprise Server到GitHub.com | GitHub Enterprise Server |
| Server Statistics | 有关您对 GitHub Enterprise Server 使用情况的汇总指标。 有关指标的完整列表,请参阅“关于服务器统计信息”。 | 从GitHub Enterprise Server到GitHub Enterprise Cloud | GitHub Enterprise Cloud |
| 统一搜索 | 搜索词、搜索结果 | 从GitHub Enterprise Cloud到GitHub Enterprise Server 从GitHub Enterprise Server到GitHub Enterprise Cloud | GitHub Enterprise Server |
| 统一贡献 | 贡献统计 | 从GitHub Enterprise Server到GitHub Enterprise Cloud | GitHub Enterprise Cloud |
启用 GitHub Connect
若要启用 GitHub Connect,请参阅适用于你的 GitHub Enterprise Cloud 环境的文章。