Eventos e detecções
Tipos de evento que o SDK envia, o que cada um detecta, a severidade e quando vira alerta no dashboard.
O SDK envia ao dashboard dois tipos de evento: detecções (algo suspeito aconteceu na página) e telemetria (pageviews, inventário, validações de pagamento). As detecções viram alertas; a telemetria alimenta o inventário de Scripts, a Saúde do SDK e a Integridade de Pagamento.
Como um evento vira alerta
- A severidade é definida pelo dashboard, não pelo SDK. A severidade informada pelo SDK fica registrada no alerta como "Severidade informada pelo SDK". As tabelas abaixo mostram a severidade base no dashboard.
- Eventos repetidos não criam alertas novos. Enquanto houver um alerta aberto para o mesmo problema (por exemplo, o mesmo script ou o mesmo destino de exfiltração), novas ocorrências somam no alerta existente. Se o alerta já foi resolvido, uma nova ocorrência abre um alerta novo.
- A notificação sai só quando o alerta é criado. Ocorrências repetidas não notificam de novo.
- Scripts escritos no HTML da página aparecem em Scripts com o aviso de que continuam carregando pelo HTML. Para barrá-los, remova a tag na origem (HTML ou tema).
Veja como tratar os alertas em Alertas.
Referência da página
Logo após o carregamento, o SDK estabelece a referência da página. Scripts presentes nesse momento entram no inventário e precisam da sua revisão em Scripts.
Scripts
| Evento | O que detecta | Severidade | Alerta |
|---|---|---|---|
SCRIPT_INJECTION | Um script executável novo aparece fora do que a página tinha. | alta, ajustada | sim |
SCRIPT_MODIFIED | Um script conhecido reaparece com conteúdo diferente. | alta, ajustada | sim |
SCRIPT_BLOCKED | Um script casou com uma regra de bloqueio e foi barrado. | alta | sim |
GTM_CONTAINER_BLOCKED | Um container do Google Tag Manager ou uma tag gtag.js fora da lista de Containers GTM permitidos. | alta | sim |
Severidade ajustada: em SCRIPT_INJECTION e SCRIPT_MODIFIED, o dashboard sobe para crítica quando o
fornecedor está marcado como ameaça no catálogo, baixa para baixa quando é um fornecedor catalogado e usa
média para scripts próprios e scripts inline. Nos demais casos, fica alta.
Dados do cliente
| Evento | O que detecta | Severidade | Alerta |
|---|---|---|---|
KEYLOGGER_DETECTED | Um script passa a capturar o que é digitado em um campo sensível. | crítica | sim |
EXFILTRATION_ATTEMPT | Dados sensíveis do cliente são enviados a um destino não confiável. | ajustada | sim |
WEBSOCKET_EXFILTRATION | Uma conexão WebSocket é aberta para um destino não confiável. | crítica | sim |
FIELD_ACCESS | Um script registrou um listener em um campo sensível. | informativa | não |
O SDK envia só os nomes dos padrões encontrados, nunca o conteúdo enviado.
Severidade ajustada: a exfiltração fica crítica quando o destino é um fornecedor marcado como ameaça ou quando envolve dados de cartão ou documento; fica baixa quando o destino é um processador de pagamento ou um fornecedor catalogado; nos demais casos, fica alta.
Formulário, iframes e sobreposições
| Evento | O que detecta | Severidade | Alerta |
|---|---|---|---|
FORM_ACTION_HIJACK | O atributo action de um formulário mudou, inclusive em formulários criados depois. | crítica | sim |
OVERLAY_DETECTED | Um elemento é posicionado sobre um campo sensível ou a área de pagamento. | alta | sim |
IFRAME_REPLACED | O endereço do iframe de um provedor de pagamento conhecido mudou. | alta | sim |
IFRAME_UNEXPECTED | Um iframe de pagamento fora das Origens de iframe esperadas, ou um iframe sobreposto a um iframe esperado. Com a lista preenchida, iframes fora dela geram alerta. | alta | sim |
CARD_FIELD_OUTSIDE_VAULT | Um campo digitável de cartão na página principal, fora do iframe do provedor. Preencha Origens de iframe esperadas para ativar. | alta | sim |
Pagamento
| Evento | O que detecta | Severidade | Alerta |
|---|---|---|---|
PIX_TAMPERED | O código Pix exibido mudou para outro que não bate com a referência, ou o recebedor não está entre os confiáveis. | crítica | sim |
BOLETO_TAMPERED | A linha digitável mudou, ou o banco não está entre os confiáveis. | crítica | sim |
CRYPTO_ADDRESS_SWAP | O endereço cripto mudou, ou não está entre os confiáveis. | crítica | sim |
UPI_TAMPERED | O código UPI mudou, ou o VPA não está entre os confiáveis. | crítica | sim |
QR_TAMPERED | O código de outro método por QR (PayNow, PromptPay, DuitNow, QR Ph, HK FPS, Transferencias 3.0, CoDi ou carteira QR) mudou, ou a imagem de um QR code passou a vir de outro domínio. | crítica | sim |
AMOUNT_TAMPERED | O valor do código é diferente do informado em expectPayment(), ou o mesmo recebedor apareceu com outro valor. | crítica | sim |
CLIPBOARD_HIJACK | O conteúdo copiado para a área de transferência parece um código de pagamento e não bate com a referência. | alta | sim |
PAYMENT_VALIDATED | Um código de pagamento foi lido e validado. Alimenta a Integridade de Pagamento. | informativa | não |
Detalhes em Integridade de pagamento e Pix.
Ambiente e instalação
| Evento | O que detecta | Severidade | Alerta |
|---|---|---|---|
SERVICE_WORKER_BLOCKED | Um service worker registrado fora dos Service workers permitidos. Com a lista preenchida, service workers fora dela geram alerta. | alta | sim |
SERVICE_WORKER_REGISTERED | Um service worker permitido foi registrado. | informativa | não |
INSTALLATION_ORDER_WARNING | Há scripts antes do snippet no <head>. O próprio alerta oferece Não avisar mais nesta loja. Veja Solução de problemas. | média | sim |
Telemetria
Estes eventos nunca viram alerta:
| Evento | Quando é enviado |
|---|---|
PAGEVIEW | A cada carregamento e a cada Proteside.pageChanged(). |
BASELINE_CALIBRATING | Quando o SDK começa a estabelecer a referência da página. |
BASELINE_CLASSIFIED | Com o inventário de scripts da página (endereço, hash do conteúdo, tamanho e classificação). |
BASELINE_ESTABLISHED | Quando a referência da página está estabelecida. |
Gerados pelo dashboard
Alguns alertas não vêm de um evento do SDK, mas de verificações no servidor:
| Alerta | Origem | Severidade |
|---|---|---|
SCRIPT_INTEGRITY_MISMATCH | O conteúdo de um script autorizado mudou em relação ao hash aprovado. | alta |
HEADER_CHANGED | Um header de segurança da página de pagamento mudou de valor. | média |
CSP_VIOLATION | Um relatório de CSP enviado ao Proteside aponta um host fora do inventário. Veja CSP e headers. | baixa |
SDK_SILENT | Um domínio com histórico parou de receber sessões reais. O alerta aparece em até um dia e é resolvido sozinho quando o tráfego volta. | média |