本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

PagerDuty 整合可讓 AWS DevOps 代理程式在事件調查和自動回應期間，從您的 PagerDuty 帳戶存取和更新事件資料、通話中排程和服務資訊。此整合使用 OAuth 2.0 進行安全身分驗證。

**重要**  
** AWS DevOps 代理程式僅支援較新的 PagerDuty OAuth 2.0 （範圍 OAuth)。不支援具有重新導向 uri 的舊版 PagerDuty OAuth。

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

在連接 PagerDuty 之前，請確定您已：
+ 具有您的 OAuth 用戶端 ID 和用戶端秘密的 PagerDuty 帳戶
+ 您的 PagerDuty 帳戶子網域 （例如，如果您的 PagerDuty URL 為 `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 範圍 OAuth **建立新的應用程式
+ 在**許可**下，授予下列最低必要範圍：`incidents.write`、 `incidents.read`和 `services.read`
+ 啟用**事件整合**以允許 AWS DevOps Agent 和 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。不支援較舊的 Webhook 版本。

如需 PagerDuty V3 Webhook 訂閱的詳細資訊，請參閱 PagerDuty 開發人員文件中的 [Webhooks 概觀](https://developer.pagerduty.com/docs/webhooks-overview#webhook-subscriptions)。