# Alarmes

Defina regras de alerta sobre o registo de auditoria e seja notificado por e-mail quando ocorrerem eventos importantes.

Requires: Advanced+

> **Plano necessário:** Os alarmes estão disponíveis nos planos Advanced e Pro (e durante o período experimental).

Os alarmes vigiam o [registo de auditoria](https://dts-identity.com/pt/docs/monitoring/audit-logs.md) e notificam-no por e-mail quando os eventos correspondem a uma regra que definiu. Utilize-os para acompanhar a atividade relevante para a segurança, como uma série de inícios de sessão falhados, a atribuição de uma função de administrador ou um connector que fica offline, sem ter de vigiar o registo pessoalmente.

Os alarmes encontram-se na Admin Console em **Registo de auditoria → Alarmes**.

## Criar um alarme

1. Aceda a **Registo de auditoria → Alarmes** e selecione **Criar alarme**.
2. Escolha um modelo predefinido (por exemplo *Força bruta detetada* ou *Função de administrador alterada*) ou selecione **Começar do zero**.
3. Atribua ao alarme um nome e uma gravidade (Info, Aviso ou Crítico). A gravidade é uma etiqueta sua; aparece na lista e no assunto do e-mail.
4. Em **Condição**, selecione os tipos de evento aos quais o alarme reage. Opcionalmente, restrinja-o a utilizadores, aplicações, diretórios, workspaces ou zonas de rede específicos. Um âmbito de workspace abrange os eventos atribuídos ao workspace, bem como os eventos das suas aplicações e APIs atuais. As aplicações selecionadas em conjunto com um workspace alargam o âmbito em vez de o restringir: o alarme reage então aos eventos do workspace e dessas aplicações. As restantes restrições (utilizadores, diretórios, zonas de rede) continuam a restringi-lo.
5. Escolha a forma como o alarme é acionado (consulte [Modos de acionamento](#firing-modes)).
6. Em **Destinatários**, adicione os administradores e quaisquer endereços de e-mail adicionais que devam ser notificados. Com um âmbito de workspace, pode ainda ativar **Notificar os responsáveis do workspace**; os responsáveis dos workspaces selecionados são determinados sempre que o alarme é acionado.
7. Opcionalmente, utilize **Testar alarme** para ver quantos eventos correspondentes ocorreram recentemente e, em seguida, guarde.

Os novos alarmes avaliam apenas os eventos que ocorrem **depois** da sua criação; o histórico existente nunca aciona uma notificação.

## Modos de acionamento [#firing-modes]

Um alarme é acionado de uma de duas formas:

- **Em cada evento correspondente**: é enviada uma notificação assim que surge um evento correspondente. Um período de espera (cooldown) mantém depois o alarme em silêncio durante um período escolhido, para que uma sequência do mesmo evento não inunde a sua caixa de correio.
- **Quando é atingido um limiar**: é enviada uma notificação quando ocorrem pelo menos *N* eventos correspondentes dentro de uma janela temporal (por exemplo, pelo menos 10 inícios de sessão falhados em 5 minutos). Os eventos podem ser contados no total, por utilizador ou por endereço IP. Na contagem por utilizador ou por IP, cada utilizador ou endereço é acompanhado separadamente.

**Exemplo (força bruta):** selecione os tipos de evento de inícios de sessão falhados, escolha *Quando é atingido um limiar*, defina *pelo menos 10 eventos em 5 minutos* e conte *por endereço IP*. Cada endereço atacante que ultrapasse o limiar gera a sua própria notificação.

## Testar um alarme

O botão **Testar alarme** executa a regra atual sobre o histórico recente e mostra quantos eventos abrange, com uma amostra. Trata-se de uma execução de teste: não são enviadas notificações. Utilize-o para afinar uma regra antes de guardar, de modo a que não seja nem demasiado ruidosa nem demasiado silenciosa.

## Histórico de acionamentos

Sempre que um alarme é acionado, isso fica registado no separador **Acionado** (e no separador **Histórico** de cada alarme): quando foi acionado, quantos eventos corresponderam e se o e-mail de cada destinatário foi enviado ou falhou. A partir de uma entrada, pode saltar diretamente para os eventos correspondentes no registo de auditoria. As novas entradas ficam destacadas até abrir o separador Acionado.

## Limitação de envio

Para evitar avalanches de notificações, o envio de e-mails de alarme é limitado de duas formas:

- Cada alarme pode enviar um número limitado de notificações por hora.
- Cada tenant tem um limite horário global de e-mails de alarme. O plano experimental tem limites mais apertados.

Quando um limite é atingido, o alarme continua a registar que foi acionado, mas o e-mail é retido e a entrada é marcada como **Limitada por taxa**. Se isto acontecer, aumente o período de espera, restrinja a regra ou mude para o modo de limiar.

## Referência

| Campo | Notas |
|---|---|
| Gravidade | Info, Aviso ou Crítico. Uma etiqueta sua; apresentada na lista e no assunto do e-mail. |
| Tipos de evento | Um ou mais tipos de evento de auditoria aos quais o alarme reage. Consulte [Tipos de eventos de auditoria](https://dts-identity.com/pt/docs/reference/audit-event-types.md). |
| Âmbito | Restrição opcional a utilizadores, aplicações, diretórios, workspaces ou zonas de rede específicos (zonas definidas por intervalos de IP). |
| Modo | *Em cada evento correspondente* ou *Quando é atingido um limiar*. |
| Limiar | Número, janela temporal e forma de contagem (total, por utilizador, por IP). |
| Período de espera | Durante quanto tempo o alarme permanece em silêncio após ser acionado (aplicado por grupo na contagem por utilizador ou IP). |
| Destinatários | Administradores, endereços de e-mail adicionais e, opcionalmente, os responsáveis dos workspaces no âmbito. É necessário pelo menos um. |
| Retenção | O histórico de acionamentos é conservado durante 90 dias. |

## Resolução de problemas

- **Não foi recebido nenhum e-mail.** Abra a entrada de acionamento e verifique o estado de entrega. Um estado *Falhada* mostra o erro de correio; confirme que o seu fornecedor de e-mail está configurado em [Branding → E-mail](https://dts-identity.com/pt/docs/branding.md). Verifique também se o alarme estava no período de espera ou marcado como *Limitada por taxa*.
- **O alarme nunca é acionado.** Os alarmes avaliam apenas os eventos que ocorrem após a criação ou a última edição da regra. Confirme que os tipos de evento selecionados ocorrem efetivamente e utilize **Testar alarme** para verificar o filtro.
- **Demasiados e-mails.** Aumente o período de espera, restrinja os tipos de evento ou o âmbito, ou mude para o modo de limiar, para que apenas uma série de eventos acione uma notificação.

## Consulte também

- [Registos de auditoria](https://dts-identity.com/pt/docs/monitoring/audit-logs.md)
- [Tipos de eventos de auditoria](https://dts-identity.com/pt/docs/reference/audit-event-types.md)
