Home / Integracje i pluginy / op5 Monitor SMS Integration

Wysyłka SMS i MMS z op5 dzięki SMSEagle – instrukcja intregracji​

Poniżej znajdziesz opis jak skonfigurować op5 z urządzeniem SMSEagle dla obsługi SMS. Proces integracji jest prosty i powinien zająć 10 minut.
 
SMSEagle to sprzętowa bramka SMS. Działa bez dostępu do internetu. Dzięki temu nie jest wymagane żadne połączenie z zewnętrznymi usługodawcami. Wszystkie alerty i powiadomienia generowane są lokalnie i wysyłane bezpośrednio przez siec komórkową. Urządzenia SMSEagle są wykorzystywane przede wszystkim, gdy istnieje konieczność zachowania wysokiego poziomu bezpieczeństwa, oraz w środowiskach izolowanych.

Konfiguracja SMSEagle​

  1. Utwórz nowego użytkownika w SMSEagle (menu Użytkownicy > + Dodaj użytkownika) z poziomem dostępu: “Użytkownik”.
  2. Przyznaj dostęp do API utworzonemu użytkownikowi:
    • kliknij Dostęp do API obok nowego użytkownika,
    • włącz APIv1,
    • kliknij “Wygeneruj nowy token”

Spowoduje to wygenerowanie nowego tokenu dostępu do API dla Twojego SMSEagle. W dalszej części ten token będzie oznaczony jako SMSEAGLEAPITOKEN. Zastąp SMSEAGLEAPITOKEN w poniższym skrypcie swoją wartością.

W tym samym menu dodaj uprawnienia dla metod APIv1, których chcesz używać:

  • send_sms => sms
  • ring_call => ring
  • tts_call => tts
  • tts_adv_call => tts_adv

Konfiguracja op5

  1. Pobierz najnowszą wersję skryptu notify_eagle_sms.pl z naszego repozytorium: https://github.com/smseagle/smseagle-nagios
    Umieść wtyczkę w katalogu wtyczek op5.

  2. Utwórz komendy powiadomień SMS (zwykle w pliku commands.cfg).

  3. Zastąp SMSEAGLEURL adresem URL Twojego urządzenia SMSEagle (np. http://192.168.50.150).

  4. Zastąp SMSEAGLEAPITOKEN tokenem API Twojego SMSEagle (np. NZg2yNmWYb5Q7I3Y3Ifnk5E).
    (Opcjonalnie dla połączeń, domyślnie: 10) Dodaj parametr -duration z czasem trwania połączenia w sekundach, np. -duration 15.
    (Wymagane dla TTS Advanced) Zastąp SMSEAGLEVOICE identyfikatorem modelu głosu (menu SMSEagle: Calls > TTS Voice models).

Zdefiniuj poniższe komendy:

define command {
        command_name notify-by-sms 
        command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -dstaddr $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $SERVICESTATE$ $SERVICEDESC$ Host($HOSTNAME$) Info($SERVICEOUTPUT$) Date($SHORTDATETIME$)" 
} 

define command { 
        command_name host-notify-by-sms 
        command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -dstaddr $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $HOSTSTATE$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)" 
}

define command { 
        command_name notify-by-ring-call 
        command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -c ring -dstaddr $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $SERVICESTATE$ $SERVICEDESC$ Host($HOSTNAME$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)" 
}

define command { 
        command_name host-notify-by-ring-call 
        command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -c ring -dstaddr $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $HOSTSTATE$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)" 
}

define command { 
        command_name notify-by-tts-call 
        command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -c tts -dstaddr $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $SERVICESTATE$ $SERVICEDESC$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)" 
}

define command { 
        command_name host-notify-by-tts-call 
        command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -c tts -dstaddr $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $HOSTSTATE$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)" 
}

define command { 
        command_name notify-by-tts-adv-call
        command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -c tts_adv -dstaddr $CONTACTPAGER$ -voiceid SMSEAGLEVOICE -t "$NOTIFICATIONTYPE$ $SERVICESTATE$ $SERVICEDESC$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)" 
}

define command { 
        command_name host-notify-by-tts-adv-call
        command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -c tts_adv -dstaddr $CONTACTPAGER$ -voiceid SMSEAGLEVOICE -t "$NOTIFICATIONTYPE$ $HOSTSTATE$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)" 
}
 

4. W kontaktach op5 (zwykle w pliku contacts.cfg) dodaj kontakt. Pole pager powinno zawierać numer telefonu dla alertów SMS w pełnym formacie międzynarodowym, bez znaku + na początku, np. 48xxxxxxxxx (jeśli operator wymaga znaku +, wpisz zamiast niego 00).

define contact { 
contact_name engineer 
alias Support Engineer 
service_notification_period 24x7 
host_notification_period 24x7 
service_notification_options w,u,c,r 
host_notification_options d,u,r 
service_notification_commands notify-by-email,notify-by-sms 
host_notification_commands host-notify-by-email,host-notify-by-sms 
email engineer@somedomain.com 
pager 48xxxxxxxx 
}

Czym jest sprzętowa
bramka SMS?

Dowiedz się więcej o
funkcjach SMSEagle

Poznaj urządzenie demo SMSEagle

SMSEagle to rozwiązanie sprzętowe i programowe, które gwarantuje szybkie dostarczanie wiadomości do wyznaczonych odbiorców, niezależnie od tego, czy chodzi o powiadomienia, alerty czy ważne aktualizacje.

Po zarejestrowaniu się w wersji demonstracyjnej otrzymasz zdalny dostęp do naszego fizycznego urządzenia NXS-9750.

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