Proteside Docs

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

EventoQué detectaSeveridadAlerta
SCRIPT_INJECTIONAparece un script ejecutable nuevo fuera de lo que tenía la página.alta, ajustadasí
SCRIPT_MODIFIEDUn script conocido reaparece con contenido distinto.alta, ajustadasí
SCRIPT_BLOCKEDUn script coincidió con una regla de bloqueo y se bloqueó.altasí
GTM_CONTAINER_BLOCKEDUn contenedor de Google Tag Manager o una etiqueta gtag.js que no está en la lista de Contenedores GTM permitidos.altasí

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

EventoQué detectaSeveridadAlerta
KEYLOGGER_DETECTEDUn script empieza a capturar lo que se escribe en un campo sensible.críticasí
EXFILTRATION_ATTEMPTDatos sensibles del cliente se envían a un destino no confiable.ajustadasí
WEBSOCKET_EXFILTRATIONSe abre una conexión WebSocket a un destino no confiable.críticasí
FIELD_ACCESSUn script registró un listener en un campo sensible.informativano

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

EventoQué detectaSeveridadAlerta
FORM_ACTION_HIJACKCambió el atributo action de un formulario, incluso en formularios creados después.críticasí
OVERLAY_DETECTEDUn elemento se posiciona sobre un campo sensible o el área de pago.altasí
IFRAME_REPLACEDCambió la dirección del iframe de un proveedor de pagos conocido.altasí
IFRAME_UNEXPECTEDUn 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.altasí
CARD_FIELD_OUTSIDE_VAULTUn campo de tarjeta editable en la página principal, fuera del iframe del proveedor. Completa Orígenes de iframe esperados para activarlo.altasí

Pago

EventoQué detectaSeveridadAlerta
PIX_TAMPEREDEl código Pix mostrado cambió a otro que no coincide con la referencia, o el destinatario no está entre los confiables.críticasí
BOLETO_TAMPEREDLa línea digitable cambió, o el banco no está entre los confiables.críticasí
CRYPTO_ADDRESS_SWAPLa dirección cripto cambió, o no está entre las confiables.críticasí
UPI_TAMPEREDEl código UPI cambió, o el VPA no está entre los confiables.críticasí
QR_TAMPEREDEl 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íticasí
AMOUNT_TAMPEREDEl monto del código es distinto del informado en expectPayment(), o el mismo destinatario apareció con otro monto.críticasí
CLIPBOARD_HIJACKEl contenido copiado al portapapeles parece un código de pago y no coincide con la referencia.altasí
PAYMENT_VALIDATEDSe leyó y validó un código de pago. Alimenta la Integridad de Pagos.informativano

Detalles en Integridad de pagos y Pix.

Entorno e instalación

EventoQué detectaSeveridadAlerta
SERVICE_WORKER_BLOCKEDUn service worker registrado que no está en Service workers permitidos. Con la lista completa, los service workers fuera de ella generan alerta.altasí
SERVICE_WORKER_REGISTEREDSe registró un service worker permitido.informativano
INSTALLATION_ORDER_WARNINGHay scripts antes del snippet en el <head>. La propia alerta ofrece No avisar más en esta tienda. Consulta Solución de problemas.mediasí

Telemetría

Estos eventos nunca se convierten en alerta:

EventoCuándo se envía
PAGEVIEWEn cada carga y en cada Proteside.pageChanged().
BASELINE_CALIBRATINGCuando el SDK empieza a establecer la referencia de la página.
BASELINE_CLASSIFIEDCon el inventario de scripts de la página (dirección, hash del contenido, tamaño y clasificación).
BASELINE_ESTABLISHEDCuando 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:

AlertaOrigenSeveridad
SCRIPT_INTEGRITY_MISMATCHEl contenido de un script autorizado cambió respecto al hash aprobado.alta
HEADER_CHANGEDUn header de seguridad de la página de pago cambió de valor.media
CSP_VIOLATIONUn reporte de CSP enviado a Proteside señala un host que no está en el inventario. Consulta CSP y headers.baja
SDK_SILENTUn 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

En esta página