# Eventos e detecções

> Tipos de evento que o SDK envia, o que cada um detecta, a severidade e quando vira alerta no dashboard.

URL: https://docs.proteside.com/pt-BR/docs/integration/events

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](https://docs.proteside.com/pt-BR/docs/guide/alerts).

## 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](https://docs.proteside.com/pt-BR/docs/integration/payment-integrity).

## 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](https://docs.proteside.com/pt-BR/docs/integration/troubleshooting#ordem-de-instalacao). | 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](https://docs.proteside.com/pt-BR/docs/integration/csp).                          | 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      |

## Próximos passos
* [Alertas](https://docs.proteside.com/pt-BR/docs/guide/alerts)
* [Configuração](https://docs.proteside.com/pt-BR/docs/integration/configuration)
