# GitHub与 Teams 集成

设置与 Teams 的GitHub集成，以改进协作并简化工作流。

## 关于 Teams 的 GitHub 集成

Microsoft Teams的 GitHub 集成使你和团队可以直接在 Teams 频道中查看 GitHub 项目。 你可以对问题进行筛选、协作处理拉取请求，并跟踪更改，而无需离开 Teams。

使用适用于 Teams 的 GitHub 集成，你可以：

* 在 Teams 频道中获取 **GitHub 通知** 。
* 使用 **命令** 来对 GitHub 采取行动。
* 查看共享的资源链接的**预览**。

向 GitHub 应用授予对 Teams 工作区的访问权限时，你将向其授予某些权限。 提供的权限是应用正常运行所必需的，并提供所需的功能。 请参阅“[Teams 中 GitHub 的权限](/zh/enterprise-server@3.22/integrations/reference/teams-permissions)”。

## 先决条件

若要使用 Teams 的 GitHub 集成，需要：

* GitHub 帐户。
* 你有权安装应用的 Teams 工作区。

## 在 GitHub Enterprise Server 上为 Teams 安装 GitHub 集成

若要将 GitHub Enterprise Server 与 Microsoft Teams 集成，首先需要在实例上配置聊天集成并在 Microsoft Azure 中注册应用。

### 注册应用并预配 Teams 机器人

1. 在实例中管理控制台GitHub Enterprise Server，打开 **“聊天集成**”页，然后选择“**启用GitHub聊天集成**”复选框。
2. 在“选择聊天客户端”下，选择**Microsoft Teams**，然后按照链接在Microsoft Azure中注册应用。
3. 在Azure中，配置应用注册的详细信息：
   * 输入应用程序注册 **名称**。
   * 将支持的帐户类型设置为**多个 Entra ID 租户**并**允许所有租户**。
4. 单击“注册”。
5. 记录显示的应用程序（客户端）ID 和租户 ID。
6. 在 **“证书和机密**”下，创建新的客户端密码。
7. 记录显示的客户端机密值。
8. 返回 GitHub Enterprise Server 实例上的 管理控制台 和“聊天集成”\*\*\*\* 页。
9. 单击 **部署到Azure**，然后按照提示在 Microsoft Azure 上预配 Teams 机器人。
10. 在 Azure 中，为要部署的 Azure 机器人选择“订阅”\*\*\*\* 和“资源组”\*\*\*\*。
11. 在 Teams 机器人配置中输入之前记录的应用程序（客户端）ID 和租户 ID。
12. 根据您的GitHub Enterprise Server网络配置：
    * 如果实例在公共 Internet 上\_可访问\_，请选中**将“\_msteams”追加到路径中**复选框。
    * 如果您的实例在公共 Internet 上 *不可访问*，并且需要代理：
      * 确保未选中**将“\_msteams”追加到路径中**复选框。
      * 在 **GHES 实例主机名** 字段中，输入将流量转发到实例的 URL。
13. 单击“ **审阅 + 创建** ”选项卡，然后单击“ **创建** ”以保存设置并开始预配应用。
14. 等待在 Azure 中预配 Teams 机器人。

### 在 Teams 中配置 GitHub Enterprise Server 和安装应用

1. 返回 GitHub Enterprise Server 实例上的 管理控制台 和“聊天集成”\*\*\*\* 页。
2. 使用前面记录的应用程序详细信息输入 **Microsoft 客户端 ID**、**Microsoft 客户端密码** 和 **Microsoft 租户 ID**。
3. （可选）如果 GitHub Enterprise Server 实例无法在公共 Internet 上 *访问* 并且需要代理，请输入将在 **公共终结点 URL** 字段中将流量转发到实例的 URL。
4. 单击“ **保存客户端设置**”。
5. 单击“ **生成清单** ”下载集成清单以供以后使用。
6. 单击“ **保存设置”** ，将更改应用到实例。
7. 登录到 Teams 客户端，并打开 Teams 管理中心。
8. 转到 **Teams 应用** > **管理应用**，然后单击**上传**以上传在上一步中下载的集成清单。 有关详细信息，请参阅 [将应用上传到 Teams](https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/apps-upload#upload-your-app)。
9. 在 Teams 中安装应用，然后运行 `@GHE signin` 以连接 GitHub 帐户。

## 延伸阅读

* [GitHub在 Teams 中使用](/zh/enterprise-server@3.22/integrations/how-tos/teams/use-github-in-teams) - 了解如何使用 Teams 的 GitHub 集成功能。
* [在 Teams 中自定义 GitHub 通知](/zh/enterprise-server@3.22/integrations/how-tos/teams/customize-notifications) - 了解如何在 Teams 中自定义 GitHub 通知。