本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 正在连接 PagerDuty
<a name="connecting-to-ticketing-and-chat-connecting-pagerduty"></a>

PagerDuty 集成使 AWS DevOps 代理能够在事件调查和自动响应期间访问和更新您的 PagerDuty 帐户中的事件数据、待命时间表和服务信息。此集成使用 OAuth 2.0 进行安全身份验证。

**重要**  
** AWS DevOps 代理仅支持较新的 PagerDuty OAuth 2.0（Scoped OAuth）。不支持 PagerDuty OAuth 带有重定向 uri 的旧版。

## PagerDuty 要求
<a name="pagerduty-requirements"></a>

在连接之前 PagerDuty，请确保您具有：
+ 包含您的 OAuth 客户 ID 和客户密钥的 PagerDuty 账户
+ 您的 PagerDuty 账户子域名（例如，如果您的 PagerDuty 网址是`https://your-company.pagerduty.com`，则子域名是）`your-company`

## 正在注册 PagerDuty
<a name="registering-pagerduty"></a>

PagerDuty 在 AWS 账户级别注册，并在该账户中的所有代理空间之间共享。

### 步骤 1：在中配置访问权限 PagerDuty
<a name="step-1-configure-access-in-pagerduty"></a>

1. 登录到 AWS 管理控制台

1. 导航到 AWS DevOps 代理控制台

1. 转到**能力提供者**页面（可从侧面导航栏访问）

1. **PagerDuty**在 “**沟通**” 下的 “**可用**提供商” 部分中查找，然后单击 “**注册**”

1. 按照 “**配置访问权限 PagerDuty” 页面上的指导设置进行**操作：

**检查您的服务区域和子域名：**
+ **账户范围**-选择您所在 PagerDuty 的地区（**美国**或**欧盟**），然后输入您的 PagerDuty 子域名。例如，如果您的 PagerDuty URL 是`https://your-company.pagerduty.com`，请输入`your-company`。

**在以下位置创建新应用程序 PagerDuty：**
+ 在单独的浏览器选项卡中，登录 PagerDuty 并导航至**集成 > 应用程序注册**
+ 使用 **OAuth 2.0 Sco** ped 创建新应用程序 OAuth
+ 在 “**权限”** 下，授予以下最低必需范围：`incidents.read``incidents.write`、和 `services.read`
+ 启用**事件集成**以允许 AWS DevOps 代理和之间的双向通信 PagerDuty

**配置 OAuth 凭证：**
+ **权限范围**-所需的最低权限范围为：`incidents.read`、`incidents.write`、`services.read`
+ **客户名称**-为您的 OAuth 客户输入描述性名称
+ **客户端 ID** — 输入您的 PagerDuty 应用程序注册中的 OAuth 客户端 ID
+ **客户密钥**-输入您的 PagerDuty 应用程序注册中的 OAuth 客户端密钥

### 第 2 步：查看并提交 PagerDuty 注册
<a name="step-2-review-and-submit-pagerduty-registration"></a>

1. 查看所有 PagerDuty 配置细节

1. 单击 “**提交**” 完成注册

1. 成功注册后， PagerDuty 将显示在 “功能提供者” 页面的 “**当前已注册**” 部分

## PagerDuty 添加到代理空间
<a name="adding-pagerduty-to-an-agent-space"></a>

在账户 PagerDuty 级别注册后，您可以将其连接到各个代理空间：

1. 在 AWS DevOps 代理控制台中，选择您的代理空间

1. 前往 “**功能**” 选项卡

1. 在 “**通信**” 部分，单击 “**添加**”

1. **PagerDuty**从可用提供商列表中选择

1. 单击 “**保存**”

## 管理 PagerDuty 连接
<a name="managing-pagerduty-connections"></a>
+ **更新凭证**-如果需要更新您的 OAuth 证书，请 PagerDuty 从 “能力提供者” 页面取消注册，然后使用新的凭据重新注册。
+ **查看连接**-在 AWS DevOps 代理控制台中，选择您的代理空间，然后转到功能选项卡以查看连接的通信集成。
+ **删除 PagerDuty**-要断开与代理空间 PagerDuty 的连接，请在 “通信” 部分将其选中，然后单击 “**删除**”。要完全删除注册，请先将其从所有代理空间中删除，然后从 “能力提供者” 页面取消注册。

## Webhook 支持
<a name="webhook-support"></a>

AWS DevOps 代理仅支持 PagerDuty V3 网络挂钩。不支持早期的 webhook 版本。

有关 PagerDuty V3 webhook 订阅的更多信息，请参阅 PagerDuty 开发者文档中的 [Webhooks 概述](https://developer.pagerduty.com/docs/webhooks-overview#webhook-subscriptions)。