# Alarmes

Définissez des règles d'alerte sur le journal d'audit et soyez averti par e-mail lorsque des événements importants se produisent.

Requires: Advanced+

> **Plan requis :** Les alarmes sont disponibles dans les plans Advanced et Pro (ainsi que pendant la période d'essai).

Les alarmes surveillent le [journal d'audit](https://dts-identity.com/fr/docs/monitoring/audit-logs.md) et vous avertissent par e-mail lorsque des événements correspondent à une règle que vous avez définie. Utilisez-les pour garder un œil sur l'activité liée à la sécurité, comme une série d'échecs de connexion, l'attribution d'un rôle d'administrateur ou un connecteur qui passe hors ligne, sans avoir à surveiller vous-même le journal.

Vous trouvez les alarmes sous **Journal d’audit → Alarmes** dans l'Admin Console.

## Créer une alarme

1. Accédez à **Journal d’audit → Alarmes** et sélectionnez **Créer une alarme**.
2. Choisissez un modèle prêt à l'emploi (par exemple *Force brute détectée* ou *Rôle d'administrateur modifié*) ou choisissez **Partir de zéro**.
3. Donnez à l'alarme un nom et une gravité (Info, Avertissement ou Critique). La gravité est votre propre étiquette ; elle apparaît dans la liste et dans l'objet de l'e-mail.
4. Sous **Condition**, sélectionnez les types d'événements auxquels l'alarme réagit. Vous pouvez éventuellement la restreindre à des utilisateurs, applications, répertoires, Workspaces ou zones réseau spécifiques. Une portée Workspace couvre les événements attribués au Workspace ainsi que les événements de ses applications et API actuelles. Les applications sélectionnées avec un Workspace élargissent la portée au lieu de la restreindre : l'alarme réagit alors aux événements du Workspace et de ces applications. Les autres restrictions (utilisateurs, répertoires, zones réseau) continuent de la restreindre.
5. Choisissez comment l'alarme se déclenche (voir [Modes de déclenchement](#firing-modes)).
6. Sous **Destinataires**, ajoutez les administrateurs et toute adresse e-mail supplémentaire à notifier. Avec une portée Workspace, vous pouvez en outre activer **Notifier les responsables du workspace** ; les responsables des Workspaces sélectionnés sont déterminés à chaque déclenchement de l'alarme.
7. Utilisez éventuellement **Tester l'alarme** pour voir combien d'événements correspondants se sont produits récemment, puis enregistrez.

Les nouvelles alarmes n'évaluent que les événements qui se produisent **après** leur création ; l'historique existant ne déclenche jamais de notification.

## Modes de déclenchement [#firing-modes]

Une alarme se déclenche de l'une des deux manières suivantes :

- **On every matching event** (à chaque événement correspondant) : une notification est envoyée dès qu'un événement correspondant apparaît. Un délai de silence (cooldown) maintient ensuite l'alarme silencieuse pendant une période choisie, afin qu'une série du même événement n'inonde pas votre boîte de réception.
- **When a threshold is reached** (lorsqu'un seuil est atteint) : une notification est envoyée lorsqu'au moins *N* événements correspondants se produisent dans une fenêtre de temps (par exemple, au moins 10 échecs de connexion en 5 minutes). Les événements peuvent être comptés globalement, par utilisateur ou par adresse IP. En cas de comptage par utilisateur ou par IP, chaque utilisateur ou adresse est suivi séparément.

**Exemple (force brute) :** sélectionnez les types d'événements d'échec de connexion, choisissez *When a threshold is reached*, définissez *au moins 10 événements en 5 minutes* et comptez *par adresse IP*. Chaque adresse attaquante qui franchit le seuil produit sa propre notification.

## Tester une alarme

Le bouton **Tester l'alarme** exécute la règle actuelle sur l'historique récent et indique combien d'événements elle couvre, avec un échantillon. Il s'agit d'une simulation : aucune notification n'est envoyée. Utilisez-le pour ajuster une règle avant de l'enregistrer, afin qu'elle ne soit ni trop bruyante ni trop silencieuse.

## Historique des déclenchements

Chaque déclenchement d'une alarme est enregistré dans l'onglet **Déclenchements** (ainsi que dans l'onglet **Historique** propre à chaque alarme) : quand elle s'est déclenchée, combien d'événements correspondaient et si l'e-mail de chaque destinataire a été envoyé ou a échoué. Depuis une entrée, vous pouvez accéder directement aux événements correspondants dans le journal d'audit. Les nouvelles entrées sont mises en évidence jusqu'à ce que vous ouvriez l'onglet Déclenchements.

## Limitation du débit

Pour éviter les avalanches de notifications, l'envoi d'e-mails d'alarme est plafonné de deux manières :

- Chaque alarme peut envoyer un nombre limité de notifications par heure.
- Chaque tenant dispose d'une limite horaire globale d'e-mails d'alarme. Le plan d'essai a des limites plus strictes.

Lorsqu'une limite est atteinte, l'alarme enregistre tout de même son déclenchement, mais l'e-mail est retenu et l'entrée est marquée **Notification limitée**. Si cela se produit, augmentez le délai de silence, restreignez la règle ou passez en mode seuil.

## Référence

| Champ | Remarques |
|---|---|
| Gravité | Info, Avertissement ou Critique. Votre propre étiquette ; affichée dans la liste et dans l'objet de l'e-mail. |
| Types d'événements | Un ou plusieurs types d'événements d'audit auxquels l'alarme réagit. Voir [Types d'événements d'audit](https://dts-identity.com/fr/docs/reference/audit-event-types.md). |
| Portée | Restriction facultative à des utilisateurs, applications, répertoires, Workspaces ou zones réseau spécifiques (zones définies par des plages IP). |
| Mode | *On every matching event* ou *When a threshold is reached*. |
| Seuil | Nombre, fenêtre de temps et mode de comptage (global, par utilisateur, par IP). |
| Délai de silence | Durée pendant laquelle l'alarme reste silencieuse après un déclenchement (appliqué par groupe en cas de comptage par utilisateur ou par IP). |
| Destinataires | Administrateurs, adresses e-mail supplémentaires et éventuellement les responsables des Workspaces de la portée. Au moins un est requis. |
| Conservation | L'historique des déclenchements est conservé 90 jours. |

## Dépannage

- **Aucun e-mail reçu.** Ouvrez l'entrée de déclenchement et vérifiez le statut de remise. Un statut *Échec* affiche l'erreur d'envoi ; vérifiez que votre fournisseur d'e-mail est configuré sous [Image de marque → E-mail](https://dts-identity.com/fr/docs/branding.md). Vérifiez également si l'alarme était dans son délai de silence ou marquée *Notification limitée*.
- **L'alarme ne se déclenche jamais.** Les alarmes n'évaluent que les événements qui se produisent après la création ou la dernière modification de la règle. Vérifiez que les types d'événements sélectionnés se produisent réellement et utilisez **Tester l'alarme** pour contrôler le filtre.
- **Trop d'e-mails.** Augmentez le délai de silence, restreignez les types d'événements ou la portée, ou passez en mode seuil afin que seule une rafale déclenche une notification.

## Voir aussi

- [Journaux d'audit](https://dts-identity.com/fr/docs/monitoring/audit-logs.md)
- [Types d'événements d'audit](https://dts-identity.com/fr/docs/reference/audit-event-types.md)
