# Alarmy

Definiowanie reguł alertów na podstawie dziennika audytu i powiadomienia e-mail o ważnych zdarzeniach.

Requires: Advanced+

> **Wymagany plan:** Alarmy są dostępne w planach Advanced i Pro (oraz w okresie próbnym).

Alarmy monitorują [dziennik audytu](https://dts-identity.com/pl/docs/monitoring/audit-logs.md) i wysyłają powiadomienie e-mail, gdy zdarzenia pasują do zdefiniowanej reguły. Pozwalają śledzić aktywność istotną dla bezpieczeństwa, taką jak seria nieudanych logowań, nadanie roli administracyjnej lub przejście konektora w tryb offline, bez konieczności samodzielnego obserwowania dziennika.

Alarmy znajdują się w konsoli administracyjnej w sekcji **Dziennik audytu → Alarmy**.

## Tworzenie alarmu

1. Przejdź do **Dziennik audytu → Alarmy** i wybierz **Utwórz alarm**.
2. Wybierz gotowy szablon (na przykład *Wykryto atak brute force* lub *Zmieniono rolę administracyjną*) albo **Zacznij od zera**.
3. Nadaj alarmowi nazwę i poziom krytyczności (Info, Ostrzeżenie lub Krytyczny). Poziom krytyczności to własne oznaczenie; pojawia się na liście i w temacie wiadomości e-mail.
4. W sekcji **Warunek** wybierz typy zdarzeń, na które alarm reaguje. Opcjonalnie ogranicz go do określonych użytkowników, aplikacji, katalogów, Workspace'ów lub stref sieciowych. Zakres Workspace'u obejmuje zdarzenia przypisane do Workspace'u, a także zdarzenia jego bieżących aplikacji i API. Aplikacje wybrane razem z Workspace'em poszerzają zakres zamiast go zawężać: alarm reaguje wtedy na zdarzenia Workspace'u oraz tych aplikacji. Pozostałe ograniczenia (użytkownicy, katalogi, strefy sieciowe) nadal go zawężają.
5. Określ, w jaki sposób alarm się wyzwala (zobacz [Tryby wyzwalania](#firing-modes)).
6. W sekcji **Odbiorcy** dodaj administratorów i dodatkowe adresy e-mail, które mają otrzymywać powiadomienia. Przy zakresie Workspace'u można dodatkowo włączyć opcję **Powiadom osoby odpowiedzialne za obszar roboczy**; osoby odpowiedzialne za wybrane Workspace'y są ustalane przy każdym wyzwoleniu alarmu.
7. Opcjonalnie użyj przycisku **Testuj alarm**, aby sprawdzić, ile pasujących zdarzeń wystąpiło ostatnio, a następnie zapisz.

Nowe alarmy oceniają tylko zdarzenia, które wystąpiły **po** ich utworzeniu; istniejąca historia nigdy nie wywołuje powiadomienia.

## Tryby wyzwalania [#firing-modes]

Alarm wyzwala się na jeden z dwóch sposobów:

- **Przy każdym pasującym zdarzeniu**: powiadomienie jest wysyłane, gdy tylko pojawi się pasujące zdarzenie. Następnie okres wyciszenia (cooldown) utrzymuje alarm w spoczynku przez wybrany czas, aby strumień tego samego zdarzenia nie zalał skrzynki odbiorczej.
- **Po osiągnięciu progu**: powiadomienie jest wysyłane, gdy w danym oknie czasowym wystąpi co najmniej *N* pasujących zdarzeń (na przykład co najmniej 10 nieudanych logowań w ciągu 5 minut). Zdarzenia mogą być liczone łącznie, dla każdego użytkownika lub dla każdego adresu IP. Przy liczeniu dla użytkownika lub adresu IP każdy użytkownik lub adres jest śledzony oddzielnie.

**Przykład (brute force):** wybierz typy zdarzeń nieudanego logowania, wybierz *Po osiągnięciu progu*, ustaw *co najmniej 10 zdarzeń w ciągu 5 minut* i licz *dla każdego adresu IP*. Każdy atakujący adres, który przekroczy próg, generuje własne powiadomienie.

## Testowanie alarmu

Przycisk **Testuj alarm** uruchamia bieżącą regułę na najnowszej historii i pokazuje, ile zdarzeń do niej pasuje, wraz z próbką. Jest to przebieg testowy: żadne powiadomienia nie są wysyłane. Służy do dostrojenia reguły przed zapisaniem, tak aby nie była ani zbyt głośna, ani zbyt cicha.

## Historia wyzwoleń

Każde wyzwolenie alarmu jest rejestrowane na karcie **Wyzwolenia** (oraz na karcie **Historia** danego alarmu): kiedy nastąpiło, ile zdarzeń pasowało i czy wiadomość e-mail do każdego odbiorcy została wysłana, czy wystąpił błąd. Z poziomu wpisu można przejść bezpośrednio do pasujących zdarzeń w dzienniku audytu. Nowe wpisy są wyróżnione do momentu otwarcia karty Wyzwolenia.

## Ograniczanie liczby powiadomień

Aby zapobiec lawinie powiadomień, wysyłka wiadomości e-mail z alarmów jest ograniczona na dwa sposoby:

- Każdy alarm może wysłać ograniczoną liczbę powiadomień na godzinę.
- Każdy tenant ma ogólny godzinowy limit wiadomości e-mail z alarmów. W planie próbnym limity są niższe.

Po osiągnięciu limitu alarm nadal rejestruje wyzwolenie, ale wiadomość e-mail jest wstrzymywana, a wpis zostaje oznaczony jako **Ograniczone limitem**. W takim przypadku należy wydłużyć okres wyciszenia, zawęzić regułę lub przełączyć się na tryb progowy.

## Informacje referencyjne

| Pole | Uwagi |
|---|---|
| Poziom krytyczności | Info, Ostrzeżenie lub Krytyczny. Własne oznaczenie; wyświetlane na liście i w temacie wiadomości e-mail. |
| Typy zdarzeń | Jeden lub więcej typów zdarzeń audytu, na które alarm reaguje. Zobacz [Typy zdarzeń audytu](https://dts-identity.com/pl/docs/reference/audit-event-types.md). |
| Zakres | Opcjonalne ograniczenie do określonych użytkowników, aplikacji, katalogów, Workspace'ów lub stref sieciowych (strefy zdefiniowane zakresami IP). |
| Tryb | *Przy każdym pasującym zdarzeniu* lub *Po osiągnięciu progu*. |
| Próg | Liczba, okno czasowe i sposób liczenia (łącznie, dla użytkownika, dla adresu IP). |
| Okres wyciszenia | Jak długo alarm pozostaje w spoczynku po wyzwoleniu (stosowany dla każdej grupy przy liczeniu dla użytkownika lub adresu IP). |
| Odbiorcy | Administratorzy, dodatkowe adresy e-mail i opcjonalnie osoby odpowiedzialne za Workspace'y objęte zakresem. Wymagany jest co najmniej jeden odbiorca. |
| Przechowywanie | Historia wyzwoleń jest przechowywana przez 90 dni. |

## Rozwiązywanie problemów

- **Nie otrzymano wiadomości e-mail.** Otwórz wpis wyzwolenia i sprawdź status doręczenia. Status *Niepowodzenie* pokazuje błąd poczty; sprawdź, czy dostawca poczty e-mail jest skonfigurowany w sekcji [Branding → E-mail](https://dts-identity.com/pl/docs/branding.md). Sprawdź również, czy alarm był w okresie wyciszenia lub został oznaczony jako *Ograniczone limitem*.
- **Alarm nigdy się nie wyzwala.** Alarmy oceniają tylko zdarzenia, które wystąpiły po utworzeniu lub ostatniej edycji reguły. Upewnij się, że wybrane typy zdarzeń faktycznie występują, i sprawdź filtr za pomocą przycisku **Testuj alarm**.
- **Zbyt wiele wiadomości e-mail.** Wydłuż okres wyciszenia, zawęź typy zdarzeń lub zakres albo przełącz się na tryb progowy, aby powiadomienie wywoływała tylko seria zdarzeń.

## Zobacz też

- [Dzienniki audytu](https://dts-identity.com/pl/docs/monitoring/audit-logs.md)
- [Typy zdarzeń audytu](https://dts-identity.com/pl/docs/reference/audit-event-types.md)
