# Alarme

Definieren Sie Alarmregeln über das Audit-Log und werden Sie per E-Mail benachrichtigt, wenn wichtige Ereignisse auftreten.

Requires: Advanced+

> **Plan erforderlich:** Alarme sind in den Plänen Advanced und Pro (sowie während der Testphase) verfügbar.

Alarme überwachen das [Audit-Log](https://dts-identity.com/de/docs/monitoring/audit-logs.md) und benachrichtigen Sie per E-Mail, wenn Ereignisse auf eine von Ihnen definierte Regel passen. Nutzen Sie sie, um sicherheitsrelevante Aktivitäten im Blick zu behalten, etwa eine Häufung fehlgeschlagener Logins, die Vergabe einer Admin-Rolle oder einen Connector, der offline geht, ohne das Log selbst beobachten zu müssen.

Sie finden Alarme in der Admin-Konsole unter **Audit-Trail → Alarme**.

## Einen Alarm erstellen

1. Öffnen Sie **Audit-Trail → Alarme** und wählen Sie **Alarm erstellen**.
2. Wählen Sie eine fertige Vorlage (zum Beispiel *Brute-Force erkannt* oder *Admin-Rolle geändert*) oder **Von vorn beginnen**.
3. Geben Sie dem Alarm einen Namen und einen Schweregrad (Info, Warnung oder Kritisch). Der Schweregrad ist Ihre eigene Kennzeichnung; er erscheint in der Liste und im E-Mail-Betreff.
4. Wählen Sie unter **Bedingung** die Ereignistypen aus, auf die der Alarm reagiert. Optional können Sie ihn auf bestimmte Benutzer, Anwendungen, Verzeichnisse, Workspaces oder Netzwerkzonen beschränken. Ein Workspace-Geltungsbereich trifft auf Ereignisse zu, die dem Workspace zugeordnet sind, sowie auf Ereignisse seiner aktuellen Anwendungen und APIs. Zusammen mit einem Workspace gewählte Anwendungen erweitern den Geltungsbereich, statt ihn einzuschränken: Der Alarm reagiert dann auf Ereignisse des Workspace und dieser Anwendungen. Die übrigen Einschränkungen (Benutzer, Verzeichnisse, Netzwerkzonen) grenzen weiter ein.
5. Legen Sie fest, wie der Alarm auslöst (siehe [Auslösemodi](#firing-modes)).
6. Fügen Sie unter **Empfänger** die Admins und zusätzliche E-Mail-Adressen hinzu, die benachrichtigt werden sollen. Mit einem Workspace-Geltungsbereich können Sie zusätzlich **Workspace-Verantwortliche benachrichtigen** aktivieren; die Verantwortlichen der ausgewählten Workspaces werden bei jedem Auslösen des Alarms neu aufgelöst.
7. Nutzen Sie optional **Alarm testen**, um zu sehen, wie viele passende Ereignisse kürzlich aufgetreten sind, und speichern Sie dann.

Neue Alarme werten nur Ereignisse aus, die **nach** ihrer Erstellung auftreten; vorhandene Historie löst nie eine Benachrichtigung aus.

## Auslösemodi [#firing-modes]

Ein Alarm löst auf eine von zwei Arten aus:

- **Bei jedem passenden Ereignis**: Eine Benachrichtigung wird gesendet, sobald ein passendes Ereignis auftritt. Ein Cooldown hält den Alarm anschließend für einen gewählten Zeitraum still, damit ein Strom desselben Ereignisses Ihr Postfach nicht überflutet.
- **Wenn ein Schwellenwert erreicht wird**: Eine Benachrichtigung wird gesendet, wenn mindestens *N* passende Ereignisse innerhalb eines Zeitfensters auftreten (zum Beispiel mindestens 10 fehlgeschlagene Logins innerhalb von 5 Minuten). Ereignisse können insgesamt, pro Benutzer oder pro IP-Adresse gezählt werden. Bei Zählung pro Benutzer oder pro IP wird jeder Benutzer bzw. jede Adresse separat verfolgt.

**Beispiel (Brute-Force):** Wählen Sie die Ereignistypen für fehlgeschlagene Logins, wählen Sie *Wenn ein Schwellenwert erreicht wird*, setzen Sie *mindestens 10 Ereignisse innerhalb von 5 Minuten* und zählen Sie *pro IP-Adresse*. Jede angreifende Adresse, die den Schwellenwert überschreitet, erzeugt ihre eigene Benachrichtigung.

## Einen Alarm testen

Die Schaltfläche **Alarm testen** führt die aktuelle Regel gegen die jüngste Historie aus und zeigt, wie viele Ereignisse sie erfasst, samt einer Stichprobe. Es handelt sich um einen Testlauf: Es werden keine Benachrichtigungen gesendet. Nutzen Sie ihn, um eine Regel vor dem Speichern so abzustimmen, dass sie weder zu laut noch zu leise ist.

## Auslöseverlauf

Jedes Mal, wenn ein Alarm auslöst, wird dies auf der Registerkarte **Ausgelöst** festgehalten (sowie auf der eigenen Registerkarte **Verlauf** jedes Alarms): wann er ausgelöst hat, wie viele Ereignisse übereinstimmten und ob die E-Mail an jeden Empfänger gesendet wurde oder fehlschlug. Von einem Eintrag aus können Sie direkt zu den passenden Ereignissen im Audit-Log springen. Neue Einträge sind hervorgehoben, bis Sie die Registerkarte Ausgelöst öffnen.

## Drosselung

Um Benachrichtigungsfluten zu verhindern, wird der Alarm-E-Mail-Versand auf zwei Arten begrenzt:

- Jeder Alarm kann pro Stunde eine begrenzte Anzahl an Benachrichtigungen senden.
- Jeder Mandant hat ein stündliches Gesamtlimit für Alarm-E-Mails. Der Testplan hat engere Limits.

Wenn ein Limit erreicht wird, hält der Alarm dennoch fest, dass er ausgelöst hat, aber die E-Mail wird zurückgehalten und der Eintrag als **Gedrosselt** markiert. Wenn Sie dies sehen, erhöhen Sie den Cooldown, schränken Sie die Regel ein oder wechseln Sie in den Schwellenwertmodus.

## Referenz

| Feld | Hinweise |
|---|---|
| Schweregrad | Info, Warnung oder Kritisch. Ihre eigene Kennzeichnung; erscheint in der Liste und im E-Mail-Betreff. |
| Ereignistypen | Ein oder mehrere Audit-Ereignistypen, auf die der Alarm reagiert. Siehe [Audit-Ereignistypen](https://dts-identity.com/de/docs/reference/audit-event-types.md). |
| Geltungsbereich | Optionale Beschränkung auf bestimmte Benutzer, Anwendungen, Verzeichnisse, Workspaces oder Netzwerkzonen (Zonen mit IP-Bereichen). |
| Modus | *Bei jedem passenden Ereignis* oder *Wenn ein Schwellenwert erreicht wird*. |
| Schwellenwert | Anzahl, Zeitfenster und Zählweise (insgesamt, pro Benutzer, pro IP). |
| Cooldown | Wie lange der Alarm nach dem Auslösen still bleibt (bei Zählung pro Benutzer oder IP pro Gruppe angewendet). |
| Empfänger | Admins, zusätzliche E-Mail-Adressen und optional die Verantwortlichen der im Geltungsbereich gewählten Workspaces. Mindestens einer ist erforderlich. |
| Aufbewahrung | Der Auslöseverlauf wird 90 Tage aufbewahrt. |

## Fehlerbehebung

- **Keine E-Mail erhalten.** Öffnen Sie den Auslöse-Eintrag und prüfen Sie den Zustellstatus. Ein Status *Fehlgeschlagen* zeigt den E-Mail-Fehler; prüfen Sie, ob Ihr E-Mail-Anbieter unter [Branding → Mail](https://dts-identity.com/de/docs/branding.md) konfiguriert ist. Prüfen Sie außerdem, ob der Alarm im Cooldown war oder als *Gedrosselt* markiert wurde.
- **Der Alarm löst nie aus.** Alarme werten nur Ereignisse aus, die nach dem Erstellen oder der letzten Änderung der Regel auftreten. Bestätigen Sie, dass die gewählten Ereignistypen tatsächlich auftreten, und prüfen Sie den Filter mit **Alarm testen**.
- **Zu viele E-Mails.** Erhöhen Sie den Cooldown, schränken Sie die Ereignistypen oder den Geltungsbereich ein, oder wechseln Sie in den Schwellenwertmodus, damit nur eine Häufung eine Benachrichtigung auslöst.

## Siehe auch

- [Audit-Logs](https://dts-identity.com/de/docs/monitoring/audit-logs.md)
- [Audit-Ereignistypen](https://dts-identity.com/de/docs/reference/audit-event-types.md)
