Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

PagerDuty La integración permite al AWS DevOps agente acceder a los datos de los incidentes, los horarios de guardia y la información de servicio de su PagerDuty cuenta y actualizarlos durante la investigación de los incidentes y la respuesta automática. Esta integración utiliza la OAuth versión 2.0 para una autenticación segura.

**importante**  
** AWS DevOps El agente solo es compatible con la versión PagerDuty OAuth 2.0 más reciente (con alcance OAuth). No se admite la versión antigua PagerDuty OAuth con URI de redireccionamiento.

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

Antes de realizar PagerDuty la conexión, asegúrese de tener:
+ Una PagerDuty cuenta con su ID de OAuth cliente y su secreto
+ El subdominio de tu PagerDuty cuenta (por ejemplo, si tu PagerDuty URL es`https://your-company.pagerduty.com`, el subdominio es) `your-company`

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

PagerDuty se registra a nivel de AWS cuenta y se comparte entre todos los espacios de agentes de esa cuenta.

### Paso 1: Configurar el acceso en PagerDuty
<a name="step-1-configure-access-in-pagerduty"></a>

1. Inicie sesión en la consola AWS de administración

1. Navegue hasta la consola del AWS DevOps agente

1. Vaya a la página de **proveedores de capacidades** (a la que se puede acceder desde el panel de navegación lateral)

1. Busque **PagerDuty**en la sección Proveedores **disponibles** en **Comunicación** y haga clic en **Registrarse**

1. Siga la configuración guiada de la PagerDuty página **Configurar el acceso en**:

**Compruebe la región y el subdominio de su servicio:**
+ **Ámbito de la cuenta**: selecciona tu PagerDuty región (**EE. UU.** o **UE**) e introduce tu PagerDuty subdominio. Por ejemplo, si tu PagerDuty URL es`https://your-company.pagerduty.com`, `your-company` introdúcela.

**Crea una nueva aplicación en PagerDuty:**
+ En otra pestaña del navegador, inicia sesión PagerDuty y ve a **Integraciones > Registro de aplicaciones**
+ Crea una nueva aplicación con **OAuth 2.0 Scope OAuth**
+ En **Permisos**, concede los siguientes ámbitos mínimos obligatorios:`incidents.read`, y `incidents.write` `services.read`
+ Habilite **la integración de eventos** para permitir la comunicación bidireccional entre AWS DevOps el agente y PagerDuty

**Configure OAuth las credenciales:**
+ **Alcance del permiso**: los ámbitos mínimos requeridos son:`incidents.read`,, `incidents.write` `services.read`
+ **Nombre del cliente**: introduzca un nombre descriptivo para su OAuth cliente
+ **ID de cliente**: introduzca el ID de OAuth cliente que aparece en el registro de PagerDuty la aplicación
+ **Secreto de cliente**: introduce el secreto de OAuth cliente que aparece en el registro de PagerDuty la aplicación

### Paso 2: Revisa y envía PagerDuty el registro
<a name="step-2-review-and-submit-pagerduty-registration"></a>

1. Revise todos los detalles PagerDuty de configuración

1. Haga clic en **Enviar** para completar el registro

1. Si el registro se ha realizado correctamente, PagerDuty aparece en la sección **actualmente registrados** de la página de proveedores de capacidades

## Añadir PagerDuty a un espacio de agente
<a name="adding-pagerduty-to-an-agent-space"></a>

Tras registrarse PagerDuty a nivel de cuenta, puede conectarla a espacios de agente individuales:

1. En la consola de AWS DevOps agentes, selecciona tu espacio de agente

1. Ve a la pestaña **Capacidades**

1. En la sección **Comunicaciones**, haga clic en **Agregar**

1. Seleccione **PagerDuty**de la lista de proveedores disponibles

1. Haga clic en **Guardar**

## Administrar PagerDuty las conexiones
<a name="managing-pagerduty-connections"></a>
+ **Actualización de credenciales**: si es necesario actualizar sus OAuth credenciales, cancele el registro en la página PagerDuty de proveedores de capacidades y vuelva a registrarse con las nuevas credenciales.
+ **Visualización de las conexiones**: en la consola del AWS DevOps agente, seleccione su espacio de agente y vaya a la pestaña Capacidades para ver las integraciones de comunicación conectadas.
+ **Eliminar PagerDuty**: para desconectarse PagerDuty de un espacio de agentes, selecciónelo en la sección de comunicaciones y haga clic en **Eliminar**. Para eliminar por completo el registro, elimínelo primero de todos los espacios de agentes y, a continuación, anule el registro en la página de proveedores de capacidades.

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

AWS DevOps El agente solo admite webhooks PagerDuty V3. No se admiten las versiones anteriores de webhook.

Para obtener más información sobre las suscripciones a los webhooks de la versión PagerDuty 3, consulta la [descripción general de los webhooks](https://developer.pagerduty.com/docs/webhooks-overview#webhook-subscriptions) en la documentación para desarrolladores. PagerDuty