# Allarmi

Definire regole di allarme sull'audit log e ricevere notifiche via email quando si verificano eventi importanti.

Requires: Advanced+

> **Piano richiesto:** gli allarmi sono disponibili nei piani Advanced e Pro (e durante il periodo di prova).

Gli allarmi monitorano l'[audit log](https://dts-identity.com/it/docs/monitoring/audit-logs.md) e La avvisano via email quando degli eventi corrispondono a una regola da Lei definita. Li utilizzi per tenere sotto controllo le attività rilevanti per la sicurezza, come un picco di accessi falliti, l'assegnazione di un ruolo amministrativo o un connector che va offline, senza dover osservare il log personalmente.

Gli allarmi si trovano in **Audit Trail → Allarmi** nella console di amministrazione.

## Creare un allarme

1. Vada in **Audit Trail → Allarmi** e selezioni **Crea allarme**.
2. Scelga un modello predefinito (ad esempio *Brute force rilevato* o *Ruolo amministrativo modificato*) oppure **Inizia da zero**.
3. Assegni all'allarme un nome e una gravità (Info, Avviso o Critico). La gravità è un'etichetta a Sua scelta; compare nell'elenco e nell'oggetto dell'email.
4. In **Condizione**, selezioni i tipi di evento a cui l'allarme reagisce. Facoltativamente, lo limiti a utenti, applicazioni, directory, Workspace o zone di rete specifici. Un ambito Workspace corrisponde agli eventi attribuiti al Workspace e agli eventi delle sue applicazioni e API attuali. Le applicazioni selezionate insieme a un Workspace ampliano l'ambito invece di restringerlo: l'allarme reagisce allora agli eventi del Workspace e di tali applicazioni. Le altre restrizioni (utenti, directory, zone di rete) continuano a restringerlo.
5. Scelga come si attiva l'allarme (vedere [Modalità di attivazione](#firing-modes)).
6. In **Destinatari**, aggiunga gli amministratori ed eventuali indirizzi email aggiuntivi da notificare. Con un ambito Workspace può inoltre abilitare **Notifica i responsabili del workspace**; i responsabili dei Workspace selezionati vengono determinati ogni volta che l'allarme si attiva.
7. Facoltativamente, utilizzi **Testa allarme** per vedere quanti eventi corrispondenti si sono verificati di recente, quindi salvi.

I nuovi allarmi valutano solo gli eventi che si verificano **dopo** la loro creazione; la cronologia esistente non attiva mai una notifica.

## Modalità di attivazione [#firing-modes]

Un allarme si attiva in uno dei due modi seguenti:

- **A ogni evento corrispondente**: una notifica viene inviata non appena compare un evento corrispondente. Un periodo di cooldown mantiene poi l'allarme silenzioso per un intervallo scelto, così che un flusso dello stesso evento non intasi la Sua casella di posta.
- **Al raggiungimento di una soglia**: una notifica viene inviata quando si verificano almeno *N* eventi corrispondenti in una finestra temporale (ad esempio, almeno 10 accessi falliti in 5 minuti). Gli eventi possono essere conteggiati complessivamente, per utente o per indirizzo IP. Con il conteggio per utente o per IP, ogni utente o indirizzo viene tracciato separatamente.

**Esempio (brute force):** selezioni i tipi di evento degli accessi falliti, scelga *Al raggiungimento di una soglia*, imposti *almeno 10 eventi in 5 minuti* e conteggi *per indirizzo IP*. Ogni indirizzo attaccante che supera la soglia produce una propria notifica.

## Testare un allarme

Il pulsante **Testa allarme** esegue la regola corrente sulla cronologia recente e mostra quanti eventi corrispondono, con un campione. Si tratta di una simulazione: non viene inviata alcuna notifica. Lo utilizzi per calibrare una regola prima di salvarla, in modo che non sia né troppo rumorosa né troppo silenziosa.

## Cronologia delle attivazioni

Ogni volta che un allarme si attiva, l'evento viene registrato nella scheda **Attivato** (e nella scheda **Cronologia** di ciascun allarme): quando si è attivato, quanti eventi corrispondevano e se l'email a ciascun destinatario è stata inviata o non è riuscita. Da una voce è possibile passare direttamente agli eventi corrispondenti nell'audit log. Le nuove voci restano evidenziate finché non apre la scheda Attivato.

## Limitazione della frequenza

Per evitare ondate di notifiche, le email di allarme sono limitate in due modi:

- Ogni allarme può inviare un numero limitato di notifiche all'ora.
- Ogni tenant ha un limite orario complessivo per le email di allarme. Il piano di prova ha limiti più restrittivi.

Quando viene raggiunto un limite, l'allarme registra comunque di essersi attivato, ma l'email viene trattenuta e la voce viene contrassegnata come **Limitata**. In tal caso, aumenti il cooldown, restringa la regola o passi alla modalità a soglia.

## Riferimento

| Campo | Note |
|---|---|
| Gravità | Info, Avviso o Critico. Un'etichetta a Sua scelta; mostrata nell'elenco e nell'oggetto dell'email. |
| Tipi di evento | Uno o più tipi di evento di audit a cui l'allarme reagisce. Vedere [Tipi di evento di audit](https://dts-identity.com/it/docs/reference/audit-event-types.md). |
| Ambito | Restrizione facoltativa a utenti, applicazioni, directory, Workspace o zone di rete specifici (zone definite da intervalli IP). |
| Modalità | *A ogni evento corrispondente* o *Al raggiungimento di una soglia*. |
| Soglia | Numero, finestra temporale e modalità di conteggio (complessivo, per utente, per IP). |
| Cooldown | Per quanto tempo l'allarme resta silenzioso dopo l'attivazione (applicato per gruppo con il conteggio per utente o per IP). |
| Destinatari | Amministratori, indirizzi email aggiuntivi e, facoltativamente, i responsabili dei Workspace dell'ambito. È richiesto almeno un destinatario. |
| Conservazione | La cronologia delle attivazioni viene conservata per 90 giorni. |

## Risoluzione dei problemi

- **Nessuna email ricevuta.** Apra la voce di attivazione e verifichi lo stato di consegna. Uno stato *Non riuscita* mostra l'errore di posta; verifichi che il provider email sia configurato in [Branding → Email](https://dts-identity.com/it/docs/branding.md). Controlli inoltre se l'allarme era in cooldown o contrassegnato come *Limitata*.
- **L'allarme non si attiva mai.** Gli allarmi valutano solo gli eventi che si verificano dopo la creazione o l'ultima modifica della regola. Verifichi che i tipi di evento selezionati si verifichino effettivamente e utilizzi **Testa allarme** per controllare il filtro.
- **Troppe email.** Aumenti il cooldown, restringa i tipi di evento o l'ambito, oppure passi alla modalità a soglia, così che solo un picco attivi una notifica.

## Vedere anche

- [Audit log](https://dts-identity.com/it/docs/monitoring/audit-logs.md)
- [Tipi di evento di audit](https://dts-identity.com/it/docs/reference/audit-event-types.md)
