Moduł powiadomień

Konfigurowanie modułu powiadomień

Opis

Moduł powiadomień zaimplementowany w systemie umożliwia przekazywanie powiadomień następującymi drogami:

• za pomocą notyfikacji w oknie przeglądarki,

• za pomocą powiadomień email,

• za pomocą powiadomień sms.

W celu konfiguracji modułu powiadomień należy wybrać Administracja -> Brama -> Powiadomienia.

Konfigurowanie powiadomień w oknie przeglądarki

Po przejściu do zakładki Przeglądarka w oknie konfiguracji modułu powiadomień, wybieramy przycisk Akcja, a następnie opcję Edytuj:

W nowym oknie mamy możliwość konfiguracji następujących opcji:

Alarmy dźwiękowe:

włączamy globalnie możliwość emitowania alarmów dźwiękowych przez przeglądarkę w momentach pojawienia się nowych alarmów,

Alarmy na zakładce:

włączamy pojawianie się aktualnej ilości alarmów w oknie zakładki, obok tytułu zakładki systemONE - Dashboard.

Konfigurowanie powiadomień email

Po przejściu do zakładki Email w oknie konfiguracji modułu powiadomień, wybieramy przcisk Akcja, a następnie opcję Edytuj:

W nowym oknie mamy możliwość konfiguracji następujących opcji:

Zakładka Ogólne

Wysyłanie email:

ustawiamy na ON w celu włączenia globlanego wysyłania wiadomości email,

Typ serwera:

wybieramy czy chcemy aby systemONE wysyłał emaile za pomocą wbudowanego serwera poczty, czy aby korzystał z zewnętrznego serwera (smarthost),

Nazwa serwera email:

ustawiamy nazwę serwera poczty systemONE - powinna być to nazwa podlegająca rozwiązywaniu nazw DNS,

Adres nadawcy:

ustawiamy adres pocztowy nadawcy wiadomości z serwera systemONE,

TLS włączone:

określamy czy komunikacja pomiędzy serwerami poczty ma się odbywać w kanale szyfrowanym,

Nazwa smarthosta:

ustawiamy adres serwera pośredniczącego w wysłaniu poczty,

Port smarthosta:

określamy numer portu SMTP do którego ma się łączyć systemONE w celu wysłania wiadomości,

Włączenie autentykacji:

włączamy autentykację przy wysyłaniu wiadomości,

Login autentykacji:

podajemy nazwę konta za pomocą którego ma następować autentykacja na serwerze smarthost,

Hasło autentykacji:

podajemy hasło do konta za pomocą którego ma następować autentykacja na serwerze smarthost.

Zakładka Logi

Włączony:

ustawiamy na ON w celu logowania wysyłania wiadomości email w głównym ekranie logów,

Metoda usuwania:

ustawiamy w jaki sposób ma następować usuwanie starych logów, interwał, wpisy.

Zakładka Szablon

Wybieramy globalny szablon dla wysyłek wiadomości email. Domyślny szablon email zawiera wszystkie informacje dot. powiadomień o alarmach.

Konfigurowanie powiadomień email - autoryzacja OAUTH2 - Office 365

Zarejestrowanie aplikacji w Azure

1. Zaloguj się do Azure Portal:

   Przejdź do https://portal.azure.com i zaloguj się za pomocą konta z uprawnieniami administracyjnymi dla Microsoft Entra ID.

2. Przejdź do sekcji Rejestracja aplikacji:

   W menu po lewej stronie wybierz Manage, a następnie App registrations

   

3. Zarejestruj nową aplikację wybierając New registration

   

4. Skonfiguruj aplikację:

   

Name:

Podaj nazwę aplikacji ( np. astozi systemONE - SMTP auth )

Supported account types:

w większości przypadków wybieramy opcję Single tenant only - MSFT

Redirect URI:

Wybieramy typ przekierowania jako Web, a następnie podajemy adres na jaki serwer autoryzacji przekieruje użytkownika po pomyślnym uwierzytelnieniu w celu zwrócenia tokena dostępowego do konta e-mail. Dla rozwiązania systemONE należy podać URL w formacie: https://[ADRES_IP_lub_NAZWA_DOMENOWA_SERWERA_SYSTEMONE]/command/api/msoauth2/auth

Aby zakończyć kliknij przycisk Register.

5.Kopiowanie identyfikatorów nowo utworzonej aplikacji

Ze strony przeglądu aplikacji należy skopiować do notatnika, następujące dane:

Application (client) ID:

identyfikator aplikacji (klienta)

Directory (tenant) ID:

identyfikator katalogu (dzierżawcy)

Tworzenie tajnego klucza klienta

1. Utworzenie tajnego klucza klienta:

   

Należy przejść do sekcji Certificates & secrets, a następnie wybrać przycisk New client secret

Następnie należy podać opis oraz wybrać okres ważności ( np. 24 miesiące ).

2. Skopiowanie tajnego klucza klienta:

Po wybraniu przycisku Add należy natychmiast skopiować do schowka, a następnie np. do notatnika, wartość klucza tajnego klienta. Przechowuj go bezpiecznie, ponieważ zapewnia on dostęp do aplikacji.

Ostrzeżenie

Wartość klucza tajnego klienta jest wyświetlana tylko raz i nie będzie można jej odzyskać po opuszczeniu tej strony. Jeśli klucz tajny zostanie zgubiony, to należy wygenerować nowy.

Przyznanie uprawnień API

1. Dodawanie uprawnień

   

   W menu aplikacji po lewej stronie wybieramy API permissions, a następnie przycisk Add a permission.

   

   Wybieramy Microsoft Graph z zakładki Microsoft APIs.

   

   Następnie wybieramy Delegated permissions.

   

   i w polu filtracji wpisujemy offline_access, a następnie zaznaczamy pole wyboru z uprawnieniem i klikamy Add permissions.

   

   Następnie w polu filtracji wpisujemy SMTP, w znalezionych uprawnieniach wybieramy SMTP.Send a następnie klikamy Add permissions.

Włączenie SMTP AUTH dla skrzynki pocztowej

1. Po zalogowaniu się do centrum administracyjnego Microsoft 365, wybieramy sekcję Active users. Następnie klikamy w użytkownika, którego skrzynka będzie wykorzystywana do wysyłania powiadomień e-mail i w oknie konfiguracji wybieramy zakładkę Mail.

   

2. Wybieramy opcję Manage email apps

   

3. Włączamy uwierzytelnioną komunikację SMTP

   

Konfiguracja powiadomień na serwerze systemONE

Po przejściu do zakładki Email w oknie konfiguracji modułu powiadomień, wybieramy przcisk Akcja, a następnie opcję Edytuj.

Konfigurujemy wymagane pola:

Nazwa host: nazwa hosta systemONE Adres nadawcy: adres email nadawcy ( skrzynki pocztowej użytkownika Microsoft 365 )

Identyfikator dzierżawcy: skopiowany wczesniej identyfikator katalogu (dzierżawcy) Identyfikator klienta: skopiowany wczesniej identyfikator aplikacji (klienta) Tajny klucz klienta: skopiowana wczesniej wartość klucza tajnego klienta.

Zapisujemy ustawienia klikając Zapisz zmiany, a następnie wybieramy przycisk Pobierz token dostępowy.

W przeglądarce otworzy się nowe okno w którym będzie możliwość wybrania konta lub wpisania loginu oraz hasła za pomocą, którego uzyskamy token dostępowy.

Po poprawnym wpisaniu parametrów logowania, serwer uwierzytelniający przesyła token dostępowy na adres URL skonfigurowany podczas tworzenia aplikacji w Azure.

Jeżeli wszystko się powiodło to w częsci Token status powinna pojawić się informacja o poprawności pobrania tokena oraz jego terminie ważności. Serwer automatycznie odświeża token dostępowy korzystając z przydzielonego podczas uwierzytelaniania Refresh token.

Informacja

Informacje o procesie uzyskiwania tokena oraz działania procedury uwierzytelniania z wykorzystaniem OAuth2 są dostępne na stronach:

• `https://learn.microsoft.com/en-us/exchange/client-developer/legacy-protocols/how-to-authenticate-an-imap-pop-smtp-application-by-using-oauth`_

• `https://learn.microsoft.com/en-us/entra/identity-platform/v2-oauth2-auth-code-flow`_

Konfigurowanie powiadomień SMS

Po przejściu do zakładki SMS w oknie konfiguracji modułu powiadomień, wybieramy przcisk Akcja, a następnie opcję Edytuj:

W nowym oknie mamy możliwość konfiguracji następujących opcji:

Zakładka Ogólne

Wysyłanie sms:

ustawiamy na ON w celu włączenia globlanego wysyłania wiadomości sms,

Dostawca SMSów:

wybieramy dostawcę realizującego usługę wysyłania SMS’ów - może to być usługa w chmurze lub fizyczne urządzenie.

W zależności od wyboru Dostawcy SMSów pojawią się odpowiednie pola konfiguracyjne.

Zakładka Logi

Włączony:

ustawiamy na ON w celu logowania wysyłania wiadomości sms w głównym ekranie logów,

Metoda usuwania:

ustawiamy w jaki sposób ma następować usuwanie starych logów, interwał, wpisy.

Zakładka Szablon

Wybieramy globalny szablon do wysyłek wiadomości sms. Domyślny szablon sms zawiera wszystkie informacje dot. powiadomień o alarmach.

Szablony powiadomień

Szablony powiadomień umożliwiają dostosowanie informacji jaka ma być zawarta w treści powiadomienia drogą:

• email,

• sms.

W celu konfiguracji szablonów powiadomień należy wybrać Administracja -> Szablony -> Powiadomienia -> Email i SMS.

Tworzenie szablonów powiadomień

W celu utworzenia nowego szablonu powiadomień wybieramy przycisk Dodaj.

W nowym oknie mamy możliwość wybrania jakie treści mają się znaleźć w wiadomościach email i SMS.

Zaaplikowanie utworzonego szablonu jako globalnego do wszystkich powiadomień

W celu konfiguracji modułu powiadomień do korzystania z utworzonego szablonu powiadomień należy wybrać Administracja -> Brama -> Powiadomienia.

Po przejściu do zakładki Email w oknie konfiguracji modułu powiadomień, wybieramy przcisk Akcja a następnie opcję Edytuj:

W nowym oknie przechodzimy do zakładki Szablon i tam wybieramy utworzony szablon.

W ten sam sposób definiujemy szablon powiadomień dla wiadomości typu SMS.

Zaaplikowanie utworzonego szablonu dla wybranego czujnika

SystemONE umożliwia określanie szablonów powiadomień zarówno globlanie jak i per czujnik.

W celu zaaplikowania szablonu powiadomień per czujnik należy przejść do wybranego czujnika, a następnie wybrać ikonę edycji ustawień.

W nowym oknie wybieramy zakładkę Alarmy i wskazujemy szablon powiadomień.

Zarządzanie kontaktami

Opis

Rozwiązanie systemONE umożliwia tworzenie kontaktów posiadających różne role i będące przypisane do różnych lokalizacji. Pozwala to na tworzenie elastycznych schematów powiadomień w zależności od typu wdrożenia.

Tworzenie kontaktów

W celu zarządzania kontaktami wybrać Dashboard -> Powiadomienia -> Kontakty, a następnie zakładkę Kontakty.

Dodanie nowego kontaktu realizujemy po wybraniu przycisku Dodaj.

W nowym oknie mamy możliwość podania następujących parametrów:

Zakładka Ogólne

Sekcja Status kontaktu

Aktywny:

ustawiamy na ON w celu włączenia kontaktu.

Sekcja Szczegóły kontaktu

Imię:

podajemy dane dot. kontaktu,

Nazwisko:

podajemy dane dot. kontaktu,

Opis:

podajemy dane dot. kontaktu.

Zakładka Parametry

Sekcja Email

Włącz email:

ustawiamy na ON w celu włączenia powiadomień drogą email,

Email:

podajemy adres email.

Sekcja Telefon

Włącz SMS:

ustawiamy na ON w celu włączenia powiadomień drogą SMS,

Dzwonek włączony:

opcja wykorzystywana w niektórych bramkach SMS. Po wysłaniu SMS wykonywane jest połączenie głosowe - dzwonek,

Telefon:

podajemy numer telefonu.

Przyciski Test, Test SMS, Test dzwonka pozwalają na sprawdzenie wprowadzonych parametrów.

Zakładka Role

Sekcja Email

Operator:

włącza przekazywanie powiadomień drogą email dot. przekroczenia progów alarmowych,

Konserwator:

włącza przekazywanie powiadomień drogą email dot. niedostępności urządzeń, awarii czujników itp.

Sekcja SMS

Operator:

włącza przekazywanie powiadomień drogą SMS dot. przekroczenia progów alarmowych

Konserwator:

włącza przekazywanie powiadomień drogą SMS dot. niedostępności urządzeń, awarii czujników itp.

Zakładka Lokalizacje

Sekcja Lokalizacje

Przypinamy utworzony kontakt do wybranych lokalizacji dla których kontakt ma być widoczny jako możliwy do wyboru przy konfigurowaniu powiadomień.

Tworzenie grup kontaktów

W celu zarządzania kontaktami należy wybrać Dashboard -> Powiadomienia -> Kontakty, a następnie zakładkę Grupy kontaktów.

Dodanie nowej grupy kontaktów, realizujemy po wybraniu przycisku Dodaj.

W nowym oknie mamy możliwość podania następujących parametrów:

Zakładka Ustawienia

Sekcja Ogólne

Włączony:

ustawiamy na ON w celu włączenia powiadomień w grupie kontaktów,

Nazwa:

podajemy nazwę grupy,

Opis:

podajemy opis grupy.

Sekcja Szczegóły

Włącz email:

ustawiamy na ON w celu włączenia powiadomień email w grupie kontaktów,

Włącz SMS:

ustawiamy na ON w celu włączenia powiadomień SMS w grupie kontaktów.

Zakładka Kontakty

Sekcja Kontakty

Dodajemy kontakty, które mają należeć do grupy konaktów.

Zakładka Lokalizacje

Sekcja Lokalizacje

Przypinamy konfigurowaną grupę kontaktów do wybranych lokalizacji, dla których grupa ma być widoczna, jako możliwa do wyboru przy konfigurowaniu powiadomień.

Konfigurowanie progów alarmowych na poziomie grupy

Opis

Rozwiązanie systemONE umożliwia konfiguracje progów alarmowych na kilka sposobów. Najszybszym i najłatwiejszym jest konfiguracja progów alarmowych na poziomie grupy, gdzie progi alarmowe dotyczą wszystkich obiektów oraz czujników dołączonych do grupy.

Konfiguracja progów alarmowych

W celu zarządzania kontaktami wybrać Dashboard -> Grupy, a następnie wybrać lokalizację oraz grupę która będzie konfigurowana.

Po wybraniu grupy przechodzimy do zakłądki Progi alarmowe i wybieramy menu Akcja, a następnie Edytuj.

W nowym oknie mamy możliwość podania progów alarmowych dla wszystkich typów czujników numerycznych/pomiarowych jakie wchodzą w skład grupy.

Przypisywanie kontaktów do grupy - tryb podstawowy

Przypisywanie kontaktów do powiadomień w grupie w trybie podstawowym, pozwala na wybranie kontaktów, które mają być powiadamiane oraz sposobu powiadomienia.

W celu przypisania kontaktów do powiadomień grupy należy wybrać Dashboard -> Grupy, a następnie wybrać lokalizację oraz grupę która będzie konfigurowana.

Następnie w zakładce Powiadomienia wybieramy przycisk Akcja, a następnie Edycja.

W nowym oknie w zakładce Ogólne wybieramy typ Podstawowy. W zakładce Podstawowy wybieramy kontakty, które mają być dołączone do powiadomień w grupie, a następnie zaznaczamy sposób wysyłania powiadomień.

Ostrzeżenie

Aktualnie nie zaleca się korzystania z tego trybu. Jest on pozostawiony w celu zachowania kompatybilności wstecznej. W tym trybie brak jest możliwości korzystania z grup kontaktów, co ogranicza sposób jego wykorzystania. Zaleca się korzystanie z trybu rozszerzonego.

Przypisywanie kontaktów do grupy - tryb rozszerzony

Przypisywanie kontaktów do powiadomień w grupie w trybie rozszerzonym, pozwala na wybranie kontaktów oraz grup kontaktów, które mają być powiadamiane wraz ze sposobem powiadomienia. Dodatkowo tryb rozszerzony pozwala na korzystanie z harmonogramów dostępnych dla kontaktów oraz grup kontaktów.

W celu przypisania kontaktów do powiadomień grupy należy wybrać Dashboard -> Grupy, a następnie wybrać lokalizację oraz grupę która będzie konfigurowana.

Następnie w zakładce Powiadomienia wybieramy przycisk Akcja, a następnie Edycja.

W nowym oknie w zakładce Ogólne wybieramy typ Rozszerzony. W zakładce Rozszerzony dodajemy kontakty oraz grupy kontaktów, które mają być dołączone do powiadomień w grupie obiektów oraz wybieramy sposób wysyłania powiadomień.

Informacja

We wdrożeniach/organizacjach w których jest wiele kontaktów i/lub następują częste zmiany, zaleca się korzystanie z grup kontaktów w celu ułatwienia zarządzania zmianami.

Konfigurowanie powiadomień dźwiękowych

Opis

Rozwiązanie systemONE umożliwia informowanie operatorów pracujących w centrach sterowania/zarządzania infrastrukturą za pomocą powiadomień dźwiękowych. Istnieje możliwość zdefiniowania różnych pul powiadomień dźwiękowych, które można dołączać do różnych typów danych dla różnych grup.

Dodawanie plików multimedialnych

W celu dodania plików multimedialnych reprezentujących powiadomienia dźwiękowe należy wybrać Konfiguracja -> Powiadomienia -> Dźwieki.

Po wybraniu opcji Dodaj wypełniamy:

Zakładka Ustawienia

Sekcja Ogólne

Nazwa:

podajemy nazwę powiadomienia dźwiękowego,

Opis:

podajemy opis.

Sekcja Plik

Choose file:

wskazujemy plik dźwiękowy z dysku lokalnego komputera,

Załaduj plik:

wgrywamy wskazany plik do systemu.

Przypisywanie powiadomień dźwiękowych do grupy

W celu przypisania kontaktów do powiadomień grupy należy wybrać Dashboard -> Grupy, a następnie lokalizację oraz grupę która będzie konfigurowana.

Następnie w zakładce Dźwięki wybieramy przycisk Akcja, dalej Edycja, a w nowym oknie przypisujemy powiadomienia dźwiękowe do wybranych typów czujnika.

Stosowanie planów reakcji na zdarzenia

Opis

Domyślnie moduł powiadomień korzysta z progów alarmowych zdefiniowanych na poziomie grupy do której należy obiekt.

Istnieje możliwość dokładniejszego określenia sposobu reakcji na przekraczanie progów alarmowych z wykorzystaniem planów reakcji.

Poniżej przedstawiony zostanie sposób konfiguracji planu reakcji na zdarzenia związane z otwarciem i zamknięciem drzwi.

Tworzenie statusów

Rozwiązanie systemONE daje możliwość utowrzenia własnych statusów ( oprócz statusu alarmowego i prawidłowego ).

W celu konfiguracji nowych statusów należy wybrać: Konfiguracja -> Akcje -> Statusy.

Po kliknięciu przycisku Dodaj:

pojawią się następujące opcje:

Nazwa:

wpisujemy nazwę statusu,

Opis:

wpisujemy opis statusu,

Wartość:

podajemy wartość liczbową jaka ma definiować dany status. Każdy status powinien mieć unikalną wartość.

Priorytet:

określmy priorytet statusu. Wyższa wartość priorytetu oznacza większą wagę statusu w przypadkach gdy będzie się nakładać wiele progów alarmowych,

Kolor:

wybieramy kolor statusu, jaki będzie się pojawiać na wykresach, ramkach na mapach itp.

Status alarmowy:

włączamy, jeżeli dany status ma być statusem alarmowym czyli być uwzględniany przez moduł alarmowy

Tworzenie progów alarmowych

W celu utworzenia progów alarmowych należy wybrać: Konfiguracja -> Akcje -> Progi alarmowe.

Po kliknięciu przycisku Dodaj:

W nowym oknie mamy możliwość konfiguracji następujących opcji:

Zakładka Ustawienia

Sekcja Ogólne

Włączony:

ustawiamy na ON w celu włączenia progu,

Nazwa:

wpisujemy nazwę progu alarmowego,

Opis:

wpisujemy opis progu alarmowego,

Typ czujnika:

wybieramy typ czujnika dla którego określamy próg alarmowy,

Zakładka Stany

Sekcja Stany

wartość OK:

wybieramy jaka wartość numeryczna ma określać wartość prawidłową dla danego progu pomiarowego

Zakładka Progi alarmowe

Sekcja Progi alarmowe

dolny:

podajemy dolną wartość progu alarmowego

górny:

podajemy górną wartość progu alarmowego

Sekcja Szczegóły

Histereza:

podajemy wartość histerezy dla danego progu alarmowego

Krok alarmu:

podajemy wartość kroku alarmy okreslającego co jaką zmianę odczytu wartości czujnika ma być generowane dodatkowe powiadomienie o alarmie

Tworzenie polityk powiadamiania

W celu utworzenia polityk powiadomień należy wybrać: Dashboard -> Powiadomienia -> Polityki.

Po kliknięciu przycisku Dodaj:

W nowym oknie mamy możliwość konfiguracji następujących opcji:

Zakładka Ustawienia

Sekcja Ogólne

Włączony:

ustawiamy na ON w celu włączenia polityki powiadamiania,

Nazwa:

wpisujemy nazwę polityki powiadamiania,

Opis:

wpisujemy opis polityki powiadamiania,

Sekcja Szczegóły

Opóźnienie:

podajemy wartość opóźnienia w wysyłaniu powiadomienia

Interwał powtórzeń:

podajemy co ile sekund system ma ponawiać wysyłanie powiadomień przy aktywnym progu alarmowym

Zakładka Grupy

Sekcja Grupy kontaktów

Grupa:

przypisujemy do polityki powiadomień grupy kontaktów

Tworzenie planu reakcji

W celu utworzenia planu reakcji należy wybrać: Konfiguracja -> Akcje -> Plany reakcji.

Po kliknięciu przycisku Dodaj:

W nowym oknie mamy możliwość konfiguracji następujących opcji:

Zakładka Ustawienia

Sekcja Ogólne

Włączony:

ustawiamy na ON w celu włączenia polityki powiadamiania,

Nazwa:

wpisujemy nazwę polityki powiadamiania,

Opis:

wpisujemy opis polityki powiadamiania,

Sekcja Wyzwalacze

Próg alarmowy:

przypisujemy do planu akcji wcześniej utworzony próg alarmowy

Zakładka Akcje

Sekcja Polityki powiadomień

Dodajemy do planu reakcji na zdarzenia polityki powiadomień jakie chcemy stosować.

Podłączenie planu reakcji do czujnika

W celu zastosowania planu reakcji do zdarzeń związanych z czujnikiem, wybieramy interesujący nas obiekt, a następnie klikamy ikonę edycji czujnika do którego chcemy przypiąć plan.

Następnie przechodzimy do zakładki Alarmy i zmieniamy Typ konfiguracji z Grupa na Indywidualny.

W nowo pokazanej sekcji dodajemy plany reakcji i przypisujemy do nich odpowiednie statusy.