Home / Integracje i pluginy / Integracja SMS z Wazuh

+

Wysyłaj alerty SMS/głosowe z Wazuh

Alerty z Wazuh docierają do osoby na dyżurze SMS-em albo telefonem. SMSEagle wysyła je przez własne połączenie komórkowe, więc nie zależą od internetu ani usługi w chmurze.

Bez instalowania wtyczek

Wazuh wysyła alert przez zwykły kanał Custom Webhook, więc wklejasz tylko adres SMSEagle i klucz API.

Działa bez internetu

SMSEagle wysyła alerty przez własną kartę SIM prosto do sieci komórkowej, więc nie zależą od internetu ani dostawcy SMS w chmurze.

Bez opłat za każdą wiadomość

SMSEagle wysyła SMS-y przez zwykłą kartę SIM, więc płacisz tylko za abonament u operatora.

Jak to działa?

1

Zdarzenie

Monitor Wazuh przechodzi w status alertu, zgodnie ze zdefiniowaną przez Ciebie regułą.

2

Komunikacja

Kanał powiadomień Custom Webhook w Wazuh wysyła żądanie JSON POST do endpointu SMSEagle APIv2 w Twojej sieci lokalnej.

3

Alert

SMSEagle dostarcza alert przez własne połączenie komórkowe, bez pośrednictwa zewnętrznego serwisu, jako SMS albo połączenie na telefon odbiorcy.

Konfiguracja w około 10 minut

Proces jest prosty i zajmuje około 10-15 minut. Wygeneruj token APIv2 w SMSEagle, utwórz kanał Custom Webhook w Wazuh – i gotowe.

SMSEagle wysyła alerty z Wazuh do właściwej osoby SMS-em albo telefonem, o każdej porze.

SMS-y i połączenia głosowe z jednego urządzenia

SMSEagle wysyła alerty z Wazuh jako SMS, sam dzwonek albo połączenie, w którym odczytuje alert na głos, wszystko z jednego urządzenia.

Fill-in-the-call-12

Alerty działają przy awarii operatora

Na urządzeniach z dwiema kartami SIM różnych operatorów SMSEagle przełącza się na drugą, gdy sieć pierwszego operatora nie działa.

Alerty działają nawet przy awarii jednego urządzenia

Dwa urządzenia SMSEagle mogą pracować w klastrze HA: gdy jedno ulegnie awarii, drugie przejmuje wysyłkę.

Konfiguracja SMSEagle

  1. Utwórz nowego użytkownika w SMSEagle (menu System > Users, poziom dostępu: „User”).
  2. Utwórz klucz API dla tego użytkownika:
    • przejdź do Settings > Global settings > API i otwórz stronę API v2.
    • kliknij Create API key, wpisz nazwę w polu Key name i wskaż utworzonego wyżej użytkownika w polu Owner.
    • dodaj uprawnienia w sekcji Messages dla: Send SMS.
    • dodaj uprawnienia w sekcji Calls dla: Make a ring call, Make a TTS Advanced call (dla powiadomień głosowych)
    • kliknij Create key. Token dostępu jest pokazywany tylko raz, zaraz po zapisaniu, więc skopiuj go od razu.

Konfiguracja Wazuh

  1. Utworzenie nowego kanału
    a) Wejdź w menu Notifications > Channels i wybierz create New channel
    b) Wybierz Custom Webhook z metodą POST
    c) W polu Webhook URL wklej: https://smseagle-ip/api/v2/messages/sms
    (gdzie smseagle-ip to rzeczywisty adres IP Twojego urządzenia SMSEagle)
    d) W Webhook headers dodaj dwa klucze:
    access-token i jako wartość wklej token dostępu do SMSEagle APIv2
    Content-Type i jako wartość wklej: application/json
wazuh alerting sms configuration 1

2. Utworzenie nowego alertu
a) Wejdź w Alerting -> Monitors
b) Zdefiniuj nową akcję, która ma się uruchomić wtedy, gdy chcesz wysłać alert. Wybierz utworzony wcześniej kanał SMS
c) W polu Message wpisz treść alertu w formacie JSON.

Na przykład:

{ "to": ["+48111222333"],
"text": "Wazuh Alert: {{ctx.monitor.name}} just entered alert status. Please check the issue.
Trigger: {{ctx.trigger.name}}
Severity: {{ctx.trigger.severity}}
PeriodStart: {{ctx.periodStart}}"
}

albo

{ "to": ["admin-group"],
"text": "Wazuh Alert: {{ctx.monitor.name}} just entered alert status. Please check the issue.
Trigger: {{ctx.trigger.name}}
Severity: {{ctx.trigger.severity}}
PeriodStart: {{ctx.periodStart}}"
}

Jako odbiorcę możesz podać numer telefonu (na przykład +48111222333) albo grupę zdefiniowaną w książce adresowej SMSEagle (na przykład admin-group).

To wszystko! 😊Alerty SMS są gotowe!

wazuh alerting sms configuration 2

Ustawienia połączeń ring (opcjonalnie)

Poniżej opisujemy, jak skonfigurować połączenia typu ring (wybudzające) w Wazuh. To prosty sposób, żeby zwrócić czyjąś uwagę w sytuacji awaryjnej.

  1. Utworzenie nowego kanału
    a) Wejdź w menu Notifications > Channels i wybierz create New channel
    b) Wybierz Custom Webhook z metodą POST
    c) W polu Webhook URL wklej: https://smseagle-ip/api/v2/calls/ring
    (gdzie smseagle-ip to rzeczywisty adres IP Twojego urządzenia SMSEagle)
    d) W Webhook headers dodaj dwa klucze:
    access-token i jako wartość wklej token dostępu utworzonego wcześniej użytkownika
    Content-Type i jako wartość wklej: application/json

2. Utworzenie nowego alertu
a) Wejdź w Alerting -> Monitors
b) Zdefiniuj nową akcję, która ma się uruchomić wtedy, gdy chcesz wysłać alert. Wybierz utworzony wcześniej kanał
c) W polu Message wpisz treść alertu w formacie JSON.

Dla połączenia ring (wybudzającego):

{ "to": ["+48111222333"],
  "duration": 20
}

albo jeśli chcesz zadzwonić do grupy zdefiniowanej w książce adresowej SMSEagle:

{ "groups": [12],
  "duration": 20
}

Wstaw właściwe id grupy z interfejsu webowego SMSEagle: Phonebook > Groups. Duration oznacza, jak długo SMSEagle będzie dzwonić.

Ustawienia połączeń głosowych z syntezą mowy (opcjonalnie)

Poniżej opisujemy, jak skonfigurować połączenia głosowe z konwersją tekstu na mowę (text-to-speech) realizowaną offline w Wazuh.

  1. Utworzenie nowego kanału
    a) Wejdź w menu Notifications > Channels i wybierz create New channel
    b) Wybierz Custom Webhook z metodą POST
    c) W polu Webhook URL wklej: https://smseagle-ip/api/v2/calls/tts_advanced
    (gdzie smseagle-ip to rzeczywisty adres IP Twojego urządzenia SMSEagle)
    d) W Webhook headers dodaj dwa klucze:
    access-token i jako wartość wklej token dostępu utworzonego wcześniej użytkownika
    Content-Type i jako wartość wklej: application/json

2. Utworzenie nowego alertu
a) Wejdź w Alerting -> Monitors
b) Zdefiniuj nową akcję, która ma się uruchomić wtedy, gdy chcesz wysłać alert. Wybierz utworzony wcześniej kanał
c) W polu Message wpisz treść alertu w formacie JSON.

Dla połączenia głosowego (text-to-speech):

{ "to": ["+48111222333"],
  "voice_id": 2,
"text": "Wazuh Alert: {{ctx.monitor.name}} just entered alert status. Please check the issue. Trigger: {{ctx.trigger.name}} Severity: {{ctx.trigger.severity}} PeriodStart: {{ctx.periodStart}}" }

albo jeśli chcesz zadzwonić do grupy zdefiniowanej w książce adresowej SMSEagle:

{ "groups": [12],
  "voice_id": 2,
"text": "Wazuh Alert: {{ctx.monitor.name}} just entered alert status. Please check the issue. Trigger: {{ctx.trigger.name}} Severity: {{ctx.trigger.severity}} PeriodStart: {{ctx.periodStart}}"
}

Wstaw właściwe id grupy z interfejsu webowego SMSEagle: Phonebook > Groups. Voice_id to identyfikator modelu językowego (angielski = 1)

Poznaj urządzenie demo SMSEagle

SMSEagle to rozwiązanie sprzętowo-programowe, które gwarantuje szybkie dostarczenie wiadomości do wskazanych odbiorców – niezależnie od tego, czy chodzi o powiadomienia, alerty czy ważne aktualizacje.

Po rejestracji do wersji demo otrzymujesz zdalny dostęp do naszego fizycznego urządzenia NXS-9750.

  • 14-dniowy darmowy okres próbny
  • Dostęp do ponad 20 funkcjonalności

Czym jest sprzętowa
bramka SMS?

Dowiedz się więcej o
funkcjach SMSEagle