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.
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.
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.
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. | 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. | 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 |