As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

PagerDuty a integração permite que o AWS DevOps agente acesse e atualize dados de incidentes, agendas de plantão e informações de serviço de sua PagerDuty conta durante investigações de incidentes e respostas automatizadas. Essa integração usa OAuth 2.0 para autenticação segura.

**Importante**  
** AWS DevOps O agente suporta somente a PagerDuty OAuth versão 2.0 mais recente (com escopo OAuth). O legado PagerDuty OAuth com uri de redirecionamento não é suportado.

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

Antes de se conectar PagerDuty, verifique se você tem:
+ Uma PagerDuty conta com seu ID de OAuth cliente e segredo de cliente
+ O subdomínio PagerDuty da sua conta (por exemplo, se sua PagerDuty URL for`https://your-company.pagerduty.com`, o subdomínio é) `your-company`

## Registrando PagerDuty
<a name="registering-pagerduty"></a>

PagerDuty é registrado no nível da AWS conta e compartilhado entre todos os Agent Spaces dessa conta.

### Etapa 1: configurar o acesso no PagerDuty
<a name="step-1-configure-access-in-pagerduty"></a>

1. Faça login no console AWS de gerenciamento

1. Navegue até o console do AWS DevOps agente

1. Vá para a página **Capability Providers** (acessível na navegação lateral)

1. Encontre **PagerDuty**na seção Provedores **disponíveis** em **Comunicação** e clique em **Registrar**

1. Siga a configuração guiada na PagerDuty página **Configurar acesso em**:

**Verifique sua região de serviço e subdomínio:**
+ **Escopo da conta** — Selecione sua PagerDuty região (**EUA** ou **UE**) e insira seu PagerDuty subdomínio. Por exemplo, se sua PagerDuty URL for`https://your-company.pagerduty.com`, insira`your-company`.

**Crie um novo aplicativo em PagerDuty:**
+ Em uma guia separada do navegador, faça login PagerDuty e navegue até **Integrações > Registro de aplicativos**
+ Crie um novo aplicativo usando **OAuth 2.0 Scoped OAuth**
+ Em **Permissões**, conceda os seguintes escopos mínimos obrigatórios:`incidents.read`,`incidents.write`, e `services.read`
+ Ative a **integração de eventos** para permitir a comunicação bidirecional entre o agente e AWS DevOps PagerDuty

**Configure OAuth as credenciais:**
+ **Escopo da permissão** — Os escopos mínimos necessários são:`incidents.read`,, `incidents.write` `services.read`
+ **Nome do cliente** — Insira um nome descritivo para seu OAuth cliente
+ **ID do cliente** — insira o ID do OAuth cliente do registro do seu PagerDuty aplicativo
+ **Segredo do cliente** — Insira o segredo do OAuth cliente do registro do seu PagerDuty aplicativo

### Etapa 2: revisar e enviar o PagerDuty registro
<a name="step-2-review-and-submit-pagerduty-registration"></a>

1. Revise todos os detalhes da PagerDuty configuração

1. Clique em **Enviar** para concluir o registro

1. Após o registro bem-sucedido, PagerDuty aparece na seção **Registrado atualmente** da página Provedores de capacidades

## Adicionando PagerDuty a um espaço de agente
<a name="adding-pagerduty-to-an-agent-space"></a>

Depois de se registrar PagerDuty no nível da conta, você pode conectá-la aos Agent Spaces individuais:

1. No console do AWS DevOps agente, selecione seu Espaço do agente

1. Vá para a guia **Capacidades**

1. Na seção **Comunicações**, clique em **Adicionar**

1. **PagerDuty**Selecione na lista de provedores disponíveis

1. Clique em **Salvar**

## Gerenciando PagerDuty conexões
<a name="managing-pagerduty-connections"></a>
+ **Atualização de credenciais** — Se suas OAuth credenciais precisarem ser atualizadas, cancele o registro PagerDuty na página Capability Providers e registre-se novamente com as novas credenciais.
+ **Visualizando conexões** — No console do AWS DevOps agente, selecione seu Espaço do agente e vá até a guia Capacidades para visualizar as integrações de comunicação conectadas.
+ **Removendo PagerDuty** — Para se desconectar PagerDuty de um Espaço do Agente, selecione-o na seção Comunicações e clique em **Remover**. Para remover completamente o registro, primeiro remova-o de todos os Agent Spaces e, em seguida, cancele o registro da página Capability Providers.

## Suporte para webhook
<a name="webhook-support"></a>

AWS DevOps O agente só oferece suporte a PagerDuty webhooks V3. As versões anteriores do webhook não são suportadas.

Para obter mais informações sobre assinaturas de webhook PagerDuty V3, consulte Visão geral de [webhooks](https://developer.pagerduty.com/docs/webhooks-overview#webhook-subscriptions) na documentação do desenvolvedor. PagerDuty