기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

PagerDuty 통합을 통해 AWS DevOps Agent는 인시던트 조사 및 자동 대응 중에 PagerDuty 계정에서 인시던트 데이터, 대기 일정 및 서비스 정보에 액세스하고 업데이트할 수 있습니다. 이 통합은 보안 인증을 위해 OAuth 2.0을 사용합니다.

**중요**  
** AWS DevOps Agent는 최신 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 Management Console에 로그인

1.  AWS DevOps 에이전트 콘솔로 이동

1. **기능 공급자** 페이지로 이동(측면 탐색에서 액세스 가능)

1. **통신** 아래의 **사용 가능한** 공급자 섹션에서 **PagerDuty**를 찾고 **등록**을 클릭합니다.

1. **PagerDuty의 액세스 구성** 페이지에서 안내 설정을 따릅니다.

**서비스 리전 및 하위 도메인을 확인합니다.**
+ **계정 범위** - PagerDuty 리전(**미국** 또는 **EU**)을 선택하고 PagerDuty 하위 도메인을 입력합니다. 예를 들어 PagerDuty URL이 인 경우 `https://your-company.pagerduty.com`를 입력합니다`your-company`.

**PagerDuty에서 새 앱을 생성합니다.**
+ 별도의 브라우저 탭에서 PagerDuty에 로그인하고 **통합 > 앱 등록으로 이동합니다.**
+ **OAuth 2.0 범위 OAuth**를 사용하여 새 앱 생성
+ **권한**에서 , `incidents.read` `incidents.write`및 최소 필수 범위를 부여합니다. `services.read` 
+ **Events Integration**을 활성화하여 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 Agent는 PagerDuty V3 웹후크만 지원합니다. 이전 웹후크 버전은 지원되지 않습니다.

PagerDuty V3 웹후크 구독에 대한 자세한 내용은 PagerDuty 개발자 설명서의 [Webhooks 개요를](https://developer.pagerduty.com/docs/webhooks-overview#webhook-subscriptions) 참조하세요.