# Eventos y detecciones

> Tipos de evento que envía el SDK, qué detecta cada uno, su severidad y cuándo se convierte en alerta en el dashboard.

URL: https://docs.proteside.com/es/docs/integration/events

El SDK envía al dashboard dos tipos de evento: **detecciones** (algo sospechoso ocurrió en la página) y **telemetría**
(pageviews, inventario, validaciones de pago). Las detecciones se convierten en alertas; la telemetría alimenta el
inventario de **Scripts**, la **Salud del SDK** y la **Integridad de Pagos**.

## Cómo un evento se convierte en alerta
* **La severidad la define el dashboard**, no el SDK. La severidad que informa el SDK queda registrada en la alerta
  como "Severidad informada por el SDK". Las tablas de abajo muestran la severidad base en el dashboard.
* **Los eventos repetidos no crean alertas nuevas.** Mientras haya una alerta abierta para el mismo problema (por
  ejemplo, el mismo script o el mismo destino de exfiltración), las nuevas ocurrencias se suman a la alerta existente.
  Si la alerta ya se resolvió, una nueva ocurrencia abre una alerta nueva.
* **La notificación sale solo cuando se crea la alerta.** Las ocurrencias repetidas no vuelven a notificar.
* **Los scripts escritos en el HTML de la página** aparecen en **Scripts** con el aviso de que siguen cargándose desde
  el HTML. Para bloquearlos, elimina la etiqueta en el origen (HTML o tema).

Consulta cómo gestionar las alertas en [Alertas](https://docs.proteside.com/es/docs/guide/alerts).

## Referencia de la página
Justo después de la carga, el SDK establece la referencia de la página. Los scripts presentes en ese momento entran en
el inventario y necesitan tu revisión en **Scripts**.

## Scripts
| Evento                  | Qué detecta                                                                                                              | Severidad      | Alerta |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------ | -------------- | ------ |
| `SCRIPT_INJECTION`      | Aparece un script ejecutable nuevo fuera de lo que tenía la página.                                                      | alta, ajustada | sí     |
| `SCRIPT_MODIFIED`       | Un script conocido reaparece con contenido distinto.                                                                     | alta, ajustada | sí     |
| `SCRIPT_BLOCKED`        | Un script coincidió con una regla de bloqueo y se bloqueó.                                                               | alta           | sí     |
| `GTM_CONTAINER_BLOCKED` | Un contenedor de Google Tag Manager o una etiqueta `gtag.js` que no está en la lista de **Contenedores GTM permitidos**. | alta           | sí     |

**Severidad ajustada:** en `SCRIPT_INJECTION` y `SCRIPT_MODIFIED`, el dashboard la sube a **crítica** cuando el
proveedor está marcado como amenaza en el catálogo, la baja a **baja** cuando es un proveedor catalogado y usa **media**
para scripts propios y scripts inline. En los demás casos, queda en **alta**.

## Datos del cliente
| Evento                   | Qué detecta                                                          | Severidad   | Alerta |
| ------------------------ | -------------------------------------------------------------------- | ----------- | ------ |
| `KEYLOGGER_DETECTED`     | Un script empieza a capturar lo que se escribe en un campo sensible. | crítica     | sí     |
| `EXFILTRATION_ATTEMPT`   | Datos sensibles del cliente se envían a un destino no confiable.     | ajustada    | sí     |
| `WEBSOCKET_EXFILTRATION` | Se abre una conexión `WebSocket` a un destino no confiable.          | crítica     | sí     |
| `FIELD_ACCESS`           | Un script registró un listener en un campo sensible.                 | informativa | no     |

El SDK envía solo los nombres de los patrones encontrados, nunca el contenido enviado.

**Severidad ajustada:** la exfiltración queda en **crítica** cuando el destino es un proveedor marcado como amenaza o
cuando involucra datos de tarjeta o de documento; queda en **baja** cuando el destino es un procesador de pagos o un
proveedor catalogado; en los demás casos, queda en **alta**.

## Formularios, iframes y superposiciones
| Evento                     | Qué detecta                                                                                                                                                                       | Severidad | Alerta |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ------ |
| `FORM_ACTION_HIJACK`       | Cambió el atributo `action` de un formulario, incluso en formularios creados después.                                                                                             | crítica   | sí     |
| `OVERLAY_DETECTED`         | Un elemento se posiciona sobre un campo sensible o el área de pago.                                                                                                               | alta      | sí     |
| `IFRAME_REPLACED`          | Cambió la dirección del iframe de un proveedor de pagos conocido.                                                                                                                 | alta      | sí     |
| `IFRAME_UNEXPECTED`        | Un iframe de pago que no está en **Orígenes de iframe esperados**, o un iframe superpuesto a un iframe esperado. Con la lista completa, los iframes fuera de ella generan alerta. | alta      | sí     |
| `CARD_FIELD_OUTSIDE_VAULT` | Un campo de tarjeta editable en la página principal, fuera del iframe del proveedor. Completa **Orígenes de iframe esperados** para activarlo.                                    | alta      | sí     |

## Pago
| Evento                | Qué detecta                                                                                                                                                                            | Severidad   | Alerta |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------ |
| `PIX_TAMPERED`        | El código Pix mostrado cambió a otro que no coincide con la referencia, o el destinatario no está entre los confiables.                                                                | crítica     | sí     |
| `BOLETO_TAMPERED`     | La línea digitable cambió, o el banco no está entre los confiables.                                                                                                                    | crítica     | sí     |
| `CRYPTO_ADDRESS_SWAP` | La dirección cripto cambió, o no está entre las confiables.                                                                                                                            | crítica     | sí     |
| `UPI_TAMPERED`        | El código UPI cambió, o el VPA no está entre los confiables.                                                                                                                           | crítica     | sí     |
| `QR_TAMPERED`         | El código de otro método por QR (PayNow, PromptPay, DuitNow, QR Ph, HK FPS, Transferencias 3.0, CoDi o billetera QR) cambió, o la imagen de un código QR pasó a venir de otro dominio. | crítica     | sí     |
| `AMOUNT_TAMPERED`     | El monto del código es distinto del informado en `expectPayment()`, o el mismo destinatario apareció con otro monto.                                                                   | crítica     | sí     |
| `CLIPBOARD_HIJACK`    | El contenido copiado al portapapeles parece un código de pago y no coincide con la referencia.                                                                                         | alta        | sí     |
| `PAYMENT_VALIDATED`   | Se leyó y validó un código de pago. Alimenta la **Integridad de Pagos**.                                                                                                               | informativa | no     |

Detalles en [Integridad de pagos y Pix](https://docs.proteside.com/es/docs/integration/payment-integrity).

## Entorno e instalación
| Evento                       | Qué detecta                                                                                                                                                                          | Severidad   | Alerta |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------- | ------ |
| `SERVICE_WORKER_BLOCKED`     | Un service worker registrado que no está en **Service workers permitidos**. Con la lista completa, los service workers fuera de ella generan alerta.                                 | alta        | sí     |
| `SERVICE_WORKER_REGISTERED`  | Se registró un service worker permitido.                                                                                                                                             | informativa | no     |
| `INSTALLATION_ORDER_WARNING` | Hay scripts antes del snippet en el `<head>`. La propia alerta ofrece **No avisar más en esta tienda**. Consulta [Solución de problemas](https://docs.proteside.com/es/docs/integration/troubleshooting#ordem-de-instalacao). | media       | sí     |

## Telemetría
Estos eventos nunca se convierten en alerta:

| Evento                 | Cuándo se envía                                                                                    |
| ---------------------- | -------------------------------------------------------------------------------------------------- |
| `PAGEVIEW`             | En cada carga y en cada `Proteside.pageChanged()`.                                                 |
| `BASELINE_CALIBRATING` | Cuando el SDK empieza a establecer la referencia de la página.                                     |
| `BASELINE_CLASSIFIED`  | Con el inventario de scripts de la página (dirección, hash del contenido, tamaño y clasificación). |
| `BASELINE_ESTABLISHED` | Cuando la referencia de la página está establecida.                                                |

## Generados por el dashboard
Algunas alertas no vienen de un evento del SDK, sino de verificaciones en el servidor:

| Alerta                      | Origen                                                                                                                                         | Severidad |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
| `SCRIPT_INTEGRITY_MISMATCH` | El contenido de un script autorizado cambió respecto al hash aprobado.                                                                         | alta      |
| `HEADER_CHANGED`            | Un header de seguridad de la página de pago cambió de valor.                                                                                   | media     |
| `CSP_VIOLATION`             | Un reporte de CSP enviado a Proteside señala un host que no está en el inventario. Consulta [CSP y headers](https://docs.proteside.com/es/docs/integration/csp).                        | baja      |
| `SDK_SILENT`                | Un dominio con historial dejó de recibir sesiones reales. La alerta aparece en un plazo de un día y se resuelve sola cuando vuelve el tráfico. | media     |

## Próximos pasos
* [Alertas](https://docs.proteside.com/es/docs/guide/alerts)
* [Configuración](https://docs.proteside.com/es/docs/integration/configuration)
