Proteside Docs

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

EventoO que detectaSeveridadeAlerta
SCRIPT_INJECTIONUm script executável novo aparece fora do que a página tinha.alta, ajustadasim
SCRIPT_MODIFIEDUm script conhecido reaparece com conteúdo diferente.alta, ajustadasim
SCRIPT_BLOCKEDUm script casou com uma regra de bloqueio e foi barrado.altasim
GTM_CONTAINER_BLOCKEDUm container do Google Tag Manager ou uma tag gtag.js fora da lista de Containers GTM permitidos.altasim

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

EventoO que detectaSeveridadeAlerta
KEYLOGGER_DETECTEDUm script passa a capturar o que é digitado em um campo sensível.críticasim
EXFILTRATION_ATTEMPTDados sensíveis do cliente são enviados a um destino não confiável.ajustadasim
WEBSOCKET_EXFILTRATIONUma conexão WebSocket é aberta para um destino não confiável.críticasim
FIELD_ACCESSUm script registrou um listener em um campo sensível.informativanã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

EventoO que detectaSeveridadeAlerta
FORM_ACTION_HIJACKO atributo action de um formulário mudou, inclusive em formulários criados depois.críticasim
OVERLAY_DETECTEDUm elemento é posicionado sobre um campo sensível ou a área de pagamento.altasim
IFRAME_REPLACEDO endereço do iframe de um provedor de pagamento conhecido mudou.altasim
IFRAME_UNEXPECTEDUm 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.altasim
CARD_FIELD_OUTSIDE_VAULTUm campo digitável de cartão na página principal, fora do iframe do provedor. Preencha Origens de iframe esperadas para ativar.altasim

Pagamento

EventoO que detectaSeveridadeAlerta
PIX_TAMPEREDO 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íticasim
BOLETO_TAMPEREDA linha digitável mudou, ou o banco não está entre os confiáveis.críticasim
CRYPTO_ADDRESS_SWAPO endereço cripto mudou, ou não está entre os confiáveis.críticasim
UPI_TAMPEREDO código UPI mudou, ou o VPA não está entre os confiáveis.críticasim
QR_TAMPEREDO 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íticasim
AMOUNT_TAMPEREDO valor do código é diferente do informado em expectPayment(), ou o mesmo recebedor apareceu com outro valor.críticasim
CLIPBOARD_HIJACKO conteúdo copiado para a área de transferência parece um código de pagamento e não bate com a referência.altasim
PAYMENT_VALIDATEDUm código de pagamento foi lido e validado. Alimenta a Integridade de Pagamento.informativanão

Detalhes em Integridade de pagamento e Pix.

Ambiente e instalação

EventoO que detectaSeveridadeAlerta
SERVICE_WORKER_BLOCKEDUm service worker registrado fora dos Service workers permitidos. Com a lista preenchida, service workers fora dela geram alerta.altasim
SERVICE_WORKER_REGISTEREDUm service worker permitido foi registrado.informativanão
INSTALLATION_ORDER_WARNINGHá scripts antes do snippet no <head>. O próprio alerta oferece Não avisar mais nesta loja. Veja Solução de problemas.médiasim

Telemetria

Estes eventos nunca viram alerta:

EventoQuando é enviado
PAGEVIEWA cada carregamento e a cada Proteside.pageChanged().
BASELINE_CALIBRATINGQuando o SDK começa a estabelecer a referência da página.
BASELINE_CLASSIFIEDCom o inventário de scripts da página (endereço, hash do conteúdo, tamanho e classificação).
BASELINE_ESTABLISHEDQuando 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:

AlertaOrigemSeveridade
SCRIPT_INTEGRITY_MISMATCHO conteúdo de um script autorizado mudou em relação ao hash aprovado.alta
HEADER_CHANGEDUm header de segurança da página de pagamento mudou de valor.média
CSP_VIOLATIONUm relatório de CSP enviado ao Proteside aponta um host fora do inventário. Veja CSP e headers.baixa
SDK_SILENTUm 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

Próximos passos

Nesta página