Notificações

O que são notification configs?

Notification configs são configurações de alerta baseadas em regras que permitem definir o que aciona uma notificação, quais domínios ela se aplica e para onde a notificação é enviada. Elas são gerenciadas no nível da equipe em Team Settings > Notifications.

Cada config consiste em três partes:

1. Trigger - o tipo de evento que dispara a notificação (ex.: um script malicioso detectado)
2. Escopo de domínio - a quais domínios a regra se aplica (todos os domínios ou domínios específicos)
3. Destinos - para onde a notificação é enviada (email, webhook, Slack, Jira, Linear ou S3)

Você pode criar múltiplas notification configs por equipe, cada uma com diferentes triggers, escopos e destinos.

Criando uma notification config

1. Abra o painel e navegue até Team Settings
2. Selecione a aba Notifications
3. Clique em Create Notification Config
4. Insira um Rule Name (ex.: “Monitor PCI compliance” ou “Slack alerts for threats”)
5. Selecione um trigger da Trigger Library
6. Configure o escopo de domínio - escolha todos os domínios (incluindo futuros) ou selecione domínios específicos
7. Adicione um ou mais destinos em “Send To”
8. Configure as opções de cada destino no painel de Configuration
9. Clique em Save ou Save & Test para criar a config

Trigger library

Esta página documenta todos os 12 tipos de trigger de notificação. A própria trigger library mostra 11 deles quando você monta uma notification config, porque o Fingerprint Export é configurado em Settings > Device Intelligence. Dois desses 11 só aparecem para equipes com o recurso Resources inventory, então uma equipe sem ele vê 9. Alguns triggers entregam notificações imediatamente, enquanto outros agregam eventos em um resumo.

A entrega é uma propriedade da regra, não do trigger. Existem quatro programações: Immediate, Hourly, Daily e Weekly. Cada trigger começa em uma programação padrão e, quando aceita mais de uma, aparece um seletor de programação ao lado dele no painel When. A coluna Entrega mostra primeiro o padrão e depois as programações que aquele trigger aceita.

Trigger	Descrição	Entrega
PCI Report	Entrega o relatório PCI DSS dos domínios no escopo que têm caminhos de checkout configurados. Uma regra semanal roda às segundas e cobre a semana anterior; uma regra diária cobre o dia anterior. Domínios sem caminhos de checkout são ignorados.	Semanal por padrão. Diária ou semanal.
PCI Vendor Review Reminder	Enviado às quintas-feiras quando fornecedores de scripts vistos nas suas páginas de pagamento nos últimos sete dias ainda não têm uma decisão de revisão PCI DSS. O lembrete traz a quantidade de fornecedores pendentes e os primeiros nomes. Nada é enviado quando não há fornecedores pendentes.	Semanal (quinta-feira). Somente destinos de email.
Script Threat Detected	Dispara quando o motor de regras gera um alerta de ameaça sobre um script, cobrindo regras como ofuscação, redirecionadores injetados, keyloggers, mineradores de criptomoeda, overlays falsos de checkout e código que lê campos de pagamento. Qualquer regra de alerta que não seja uma das regras de vulnerabilidade, lista gerenciada, tag manager ou conexões de saída abaixo chega por este trigger.	Imediata.
Script Blocked by CSP	Um resumo dos relatórios de violação de Content Security Policy coletados para os domínios no escopo, com a contagem de violações por domínio e as URLs bloqueadas e diretivas violadas mais frequentes. Uma regra semanal roda às segundas e cobre a semana anterior; uma regra diária cobre o dia anterior. Nada é enviado quando o período não tem violações.	Semanal por padrão. Diária ou semanal.
Outbound Connections Pending Review	Um resumo que conta os hostnames de saída distintos observados nos domínios no escopo que sua equipe ainda não aprovou no Resources inventory. Uma regra semanal roda às segundas sobre os últimos sete dias; uma regra diária cobre o dia anterior. Nada é enviado quando não há nada pendente. Requer o recurso Resources inventory.	Semanal por padrão. Diária ou semanal. Somente destinos de email e webhook.
Malicious Outbound Connection	Dispara quando uma conexão de saída a partir de uma das suas páginas monitoradas alcança um hostname presente na lista de ameaças gerenciada pelo cside. Requer o recurso Resources inventory.	Imediata.
High-risk Vulnerability	A via urgente da detecção de vulnerabilidades: dispara quando uma descoberta é classificada como malware ou sua severidade é alta ou crítica.	Imediata.
Vulnerable Script Detected	Dispara quando um script corresponde a uma vulnerabilidade conhecida das bases OSV ou RetireJS e a descoberta não é de alto risco, ou seja, não é malware nem de severidade alta ou crítica. Por padrão, descobertas cuja fraqueza afeta apenas código de servidor ou de build e cuja severidade é inferior a alta permanecem no dashboard em vez de gerar alerta; você pode desativar esse filtro na regra.	Semanal por padrão. Imediata, diária ou semanal. Diária e semanal são agrupadas em um resumo.
Managed Flagged	Dispara quando um script é servido a partir de uma URL, domínio, hostname ou endereço IP presente na lista de ameaças gerenciada pelo cside.	Imediata.
Malicious Tag Manager	Dispara quando um script carrega um ID de contêiner do Google Tag Manager presente na lista de ameaças gerenciada pelo cside.	Imediata.
Security Headers Changed	Dispara quando os cabeçalhos de segurança observados nas páginas de checkout configuradas de um domínio diferem entre duas janelas de observação consecutivas de 12 horas, incluindo o desaparecimento de um cabeçalho. Somente domínios com caminhos de checkout são verificados, e cada domínio e janela é reportado uma vez.	Imediata.
Fingerprint Export	Grava os fingerprints do Device Intelligence e os resultados de avaliação de risco da sua equipe no seu bucket S3, em lote diário, em JSONL ou Parquet. Aceita apenas um destino Fingerprint S3 e é configurado em Settings > Device Intelligence, não pela trigger library.	Diária.

Triggers imediatos vs. resumo

Triggers imediatos enviam uma notificação assim que o evento é processado. Use-os para eventos críticos de segurança, como detecções de ameaças, conexões de saída maliciosas e vulnerabilidades de alto risco.

Triggers de resumo agregam eventos e os entregam em uma programação. Isso evita fadiga de alertas para eventos de alta frequência, como bloqueios CSP ou descobertas de vulnerabilidades rotineiras (severidade baixa e média). Vulnerabilidades de severidade alta ou crítica e malware sempre são entregues imediatamente via High-risk Vulnerability, independentemente de como você configurou o trigger rotineiro Vulnerable Script Detected.

Resumos só são enviados quando há algo a reportar. Um resumo diário cobre o dia anterior e um resumo semanal é enviado na segunda-feira referente à semana anterior, exceto PCI Vendor Review Reminder, que é enviado na quinta-feira.

Escopo de domínio

Cada notification config pode ser limitada a domínios específicos ou aplicada a todos os domínios da sua equipe:

• Todos os domínios (incluindo domínios futuros) - a regra se aplica a todos os domínios da sua equipe, incluindo quaisquer domínios adicionados posteriormente
• Domínios específicos - selecione um ou mais domínios de uma lista. A regra só dispara para eventos nesses domínios

Destinos

Os destinos definem para onde as notificações são enviadas. Você pode adicionar múltiplos destinos a uma única config - por exemplo, enviar alertas de ameaças simultaneamente para Slack e Jira.

Destino	Descrição	Guia de configuração
Email	Enviar notificações para membros da equipe ou endereços de email externos	Veja abaixo
Webhooks	Requisições HTTP POST com formatação JSON, Slack ou Discord	Guia de Webhooks
S3	Armazenar notificações em buckets AWS S3	Guia S3
Jira	Criar automaticamente issues do Jira a partir de alertas	Guia Jira
Linear	Criar automaticamente issues do Linear a partir de alertas	Guia Linear

Notificações por email

Email é um tipo de destino integrado. Ao configurar um destino de email, você pode:

• Notificar todos os membros da equipe (incluindo futuros membros) - todos os usuários da sua equipe recebem a notificação
• Selecionar membros individuais da equipe - escolher usuários específicos da sua equipe
• Adicionar endereços de email externos - encaminhar notificações para endereços fora da sua equipe (ex.: um sistema de tickets ou SIEM)

Você pode combinar essas opções - por exemplo, notificar todos os membros da equipe e também encaminhar para o seu SIEM.

Integrações

Alguns destinos (Jira, Linear) exigem que uma integração de equipe esteja conectada antes de poderem ser usados como destinos:

1. Vá para Team Settings > Integrations
2. Clique em Connect ao lado do serviço (Jira ou Linear)
3. Siga o fluxo de autorização OAuth
4. Uma vez conectado, o destino fica disponível nas suas notification configs

Testando notificações

Você pode testar suas notification configs de duas maneiras:

• Save & Test - ao criar ou editar uma config, clique em Save & Test para salvar a config e enviar uma notificação de teste para todos os destinos
• Testar config existente - na lista de notification configs, dispare um teste para qualquer config salva

As notificações de teste são claramente marcadas para que sua equipe saiba que nenhuma ação é necessária.

Gerenciando notification configs

Todas as notification configs da sua equipe estão listadas em Team Settings > Notifications. A partir daí você pode:

• Criar novas configs com o botão Create Notification Config
• Editar configs existentes para alterar triggers, domínios ou destinos
• Excluir configs que não são mais necessárias
• Ativar ou desativar configs sem excluí-las

Todas as alterações são registradas nos logs de auditoria da sua equipe.