> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PagerDuty

> Conecta PagerDuty a Iru Compliance con una REST API key de solo lectura para recopilar evidencia de incidentes, servicios, políticas de escalamiento y guardias.

### Acerca de PagerDuty

Iru lee datos de **incidentes**, **servicios**, **políticas de escalamiento**, **horarios**, **equipos** y **auditoría** a través de la REST API de PagerDuty. La autenticación usa el formato de encabezado de PagerDuty (no un Bearer simple):

```http theme={null}
Authorization: Token token=YOUR_API_KEY
```

Es preferible usar una REST API key de **General Access** con alcance de **solo lectura** para que Iru no pueda modificar incidentes ni servicios.

### Cómo funciona

Las REST Claves de API de PagerDuty se envían con el formato de encabezado personalizado de PagerDuty **`Authorization: Token token=<API_KEY>`** (esto **no** es un token **`Bearer`** genérico).

| Detalle | Valor |
| - | - |
| **Categoría** | Herramientas de desarrollo |
| **Autenticación** | REST API key (`Authorization: Token token=…`) |

Las claves de **General Access** las crean los administradores y pueden cubrir toda la cuenta. Los tokens de **Usuario** heredan la visibilidad de ese usuario. Evítalos a menos que quieras restringir el alcance intencionalmente.

Referencias oficiales: [API access keys](https://support.pagerduty.com/main/docs/api-access-keys), [REST API reference](https://developer.pagerduty.com/api-reference/) y [Rate limiting](https://developer.pagerduty.com/docs/rest-api-v2/rate-limiting/).

### Requisitos previos

* Rol **Administrador** o **Propietario de la cuenta** (o equivalente) para crear Claves de API de **General Access**.

### Conectar PagerDuty a Iru

<Tabs>
  <Tab title="PagerDuty">
    <Note>
      Completa esta pestaña antes de conectar la fuente en Compliance.
    </Note>

    <Steps>
      <Step title="Inicia sesión en PagerDuty">
        Abre [PagerDuty](https://www.pagerduty.com) e inicia sesión con un **Administrador** o **Propietario de la cuenta** (o equivalente) que pueda crear **API Access Keys**.
      </Step>

      <Step title="Abre Integrations">
        Desde la navegación del producto, abre **Integraciones** (a veces en **Automation** o **Developer**, según tu edición de PagerDuty).
      </Step>

      <Step title="Abre Developer Tools">
        Selecciona **Developer Tools** (o **API Access**) y luego ubica **API Access Keys**.
      </Step>

      <Step title="Crea una nueva API key">
        Elige **Create new API key** (el texto puede ser **New key**). Es preferible una clave de **General Access** cuando la política de la organización lo permita, para que las lecturas de Iru no dependan de la visibilidad de un solo usuario.
      </Step>

      <Step title="Asigna un nombre a la clave y configúrala como Read-only">
        Introduce un nombre como **Iru Compliance**. Establece el tipo de clave en **Read-only** (o la opción de lectura con menor privilegio que ofrezca PagerDuty para la recopilación de evidencia mediante REST).
      </Step>

      <Step title="Crea y copia la clave">
        Finaliza la creación y copia el valor de la clave **una sola vez** cuando PagerDuty lo muestre. No se vuelve a mostrar después de cerrar el cuadro de diálogo.
      </Step>
    </Steps>

    <Note>
      Continúa en la pestaña [**Iru Compliance**](#iru-compliance).
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Primero completa la pestaña [**PagerDuty**](#pagerduty).
    </Note>

    <Steps>
      <Step title="Abre Sources">
        En Iru Compliance, en la barra de navegación izquierda, expande **Cumplimiento** y selecciona **Fuentes**.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="Navegación izquierda: Compliance expandido, Sources seleccionado" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Activa PagerDuty">
        Busca **PagerDuty** (usa **Categoría** o **Buscar por nombre o descripción**). En esa tarjeta, activa el **toggle**. Es posible que se abra una pestaña o ventana del navegador para el asistente del conector.
      </Step>

      <Step title="Pega la API key">
        Pega la **API key sin procesar** en el campo que proporciona el asistente. El producto da el formato `Authorization: Token token=YOUR_API_KEY` por ti. **No** agregues el prefijo `Token token=` tú mismo.
      </Step>

      <Step title="Finaliza la conexión">
        Selecciona **Enviar clave de API**. Cuando la conexión se realiza correctamente, el asistente muestra **Conexión configurada**.
      </Step>

      <Step title="Confirma que la fuente está activa">
        Cierra la pestaña del navegador **Iru está solicitando acceso a servicios externos**, luego vuelve a **Cumplimiento** → **Fuentes** y confirma que la tarjeta **PagerDuty** está **Activo**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Solución de problemas

<AccordionGroup>
  <Accordion title="No se abre nada al activar la fuente">
    Revisa la configuración del **bloqueador de ventanas emergentes** para el sitio de Iru e inténtalo de nuevo.
  </Accordion>

  <Accordion title="401 Unauthorized">
    Usa la clave completa, sin espacios; verifica que la clave no esté deshabilitada.
  </Accordion>

  <Accordion title="403 Forbidden">
    Cambia de un token de **Usuario** a una clave de **General Access** con el alcance suficiente.
  </Accordion>

  <Accordion title="Faltan servicios u horarios">
    Los tokens con alcance de usuario solo ven los equipos de ese usuario. Usa **General Access**.
  </Accordion>
</AccordionGroup>

### Consideraciones

<CardGroup cols={2}>
  <Card title="Las Claves de API no caducan automáticamente: rótalas periódicamente." icon="circle-info">
    Las Claves de API no caducan automáticamente: rótalas de forma periódica.
  </Card>

  <Card title="Las cargas retroactivas grandes respetan los límites de PagerDuty;…" icon="shield">
    Las cargas retroactivas grandes se mantienen dentro de los **límites de frecuencia** de PagerDuty; la sincronización puede distribuirse en el tiempo.
  </Card>
</CardGroup>

### Artículos relacionados

<CardGroup cols={2}>
  <Card title="Administración de fuentes" icon="plug" href="/es/compliance/sources-management">
    Explora y administra todas las fuentes de Compliance.
  </Card>

  <Card title="Primeros pasos con Compliance" icon="rocket" href="/es/compliance/getting-started-with-compliance">
    Marcos, acciones y **Artefactos**.
  </Card>

  <Card title="Descripción general de Iru" icon="layer-group" href="/es/iru/platform-overview/iru-overview">
    Cómo encajan Endpoint, Compliance e Identity.
  </Card>

  <Card title="Administración de Artifacts" icon="folder-open" href="/es/compliance/artifacts-management">
    Carga, revisa y organiza la evidencia de fuentes y acciones.
  </Card>
</CardGroup>