Modul létrehozása

Ez az oldal bemutatja, hogyan kell kommunikációs modulokat konfigurálni a SIWENOID v2 rendszerben. A modulok azok az összetevők, amelyek lehetővé teszik, hogy a SIWENOID v2 kimenő értesítéseket küldjön — például SMS üzeneteket és e-maileket — események hatására. A modulokat egyszer kell létrehozni, majd a Taskok (lásd a Creating Tasks oldalt) használják fel őket annak meghatározására, hogy mikor és kinek történjen az értesítés.

A SIWENOID v2-ben a modul egy konfigurált kommunikációs csatorna, amelyet a szerver kimenő üzenetek küldésére használ. Minden modul egy adott kommunikációs módszer technikai kapcsolatparamétereit határozza meg. A támogatott kimenő értesítési modulok típusai:

• SMS modul — szöveges üzeneteket küld GSM modem vagy USB SIM kártyás eszköz segítségével, amely a SIWENOID v2 szervergéphez van csatlakoztatva. Fizikai GSM hardvert és SIM kártyát igényel.
• Email modul — e-mail értesítéseket küld SMTP levelezőszerveren keresztül. Hálózati elérést igényel a SIWENOID v2 szervertől a konfigurált SMTP szerver felé.

Ugyanabból a típusból több modul is létrehozható — például két SMS modul különböző SIM kártyákkal redundancia céljából, vagy két email modul különböző feladó fiókokkal eltérő értesítési célokra.

A modulok önmagukban nem határozzák meg, hogy mikor és kinek történik az üzenetküldés. Ezt a Taskok konfigurálják. A modul kizárólag a technikai küldési csatornát jelenti.

Prev ← Creating Categories Next → Everyday Operation of SIWENOID v2

A modulok beállításához navigálj ide: File → Preferences → Modules.

A Modules képernyő listázza az összes jelenleg konfigurált modult. Új modul létrehozásához kattints az Add gombra (plusz ikon). Adj nevet a modulnak, majd válaszd ki a modul típusát (SMS vagy Email) a típus legördülő menüből. A megjelenő konfigurációs mezők a kiválasztott típustól függnek.

Az SMS modul lehetővé teszi, hogy a SIWENOID v2 szöveges üzeneteket küldjön USB GSM modem vagy SIM kártyát tartalmazó USB eszköz segítségével, amely a szervergéphez van csatlakoztatva.

Az SMS modul konfigurálása előtt meg kell határozni a USB GSM eszköz Vendor ID (VID) és Product ID (PID) értékeit. Ezek az értékek egyértelműen azonosítják a USB hardvert a SIWENOID v2 számára, és szükségesek ahhoz, hogy a szoftver kommunikálni tudjon az eszközzel.

A VID és PID meghatározása Windows rendszeren:

1. Csatlakoztasd a USB GSM eszközt a szervergéphez.
2. Nyisd meg a Windows Device Manager-t (jobb klikk a Start gombra és válaszd a Device Manager-t, vagy futtasd a devmgmt.msc parancsot).
3. Keresd meg a GSM eszközt az eszközlistában. Általában a „Ports (COM & LPT)” vagy „Modems” alatt jelenik meg.
4. Kattints duplán az eszközre a tulajdonságok megnyitásához.

1. Válaszd a Details fület a tulajdonságablakban.
2. A Property legördülő listában válaszd a Hardware IDs opciót.

A Hardware IDs érték tartalmazza a VID és PID adatokat a következő formátumban: USB\VID_XXXX&PID_XXXX

• A VID_ utáni négy karakter a Vendor ID (például: 067B).
• A PID_ utáni négy karakter a Product ID (például: 2303).

Jegyezd fel ezeket az értékeket a további konfigurációhoz.

Az SMS modul szerkesztőben töltsd ki a következő mezőket:

Név A modul megnevezése, amely azonosításra szolgál a Taskok konfigurálásakor. Példa: “GSM modem 1” vagy “SMS értesítési csatorna”.

PIN kód A GSM eszközben található SIM kártya PIN kódja. Ha a SIM kártyán nincs PIN kód beállítva, hagyd üresen ezt a mezőt. Hibás PIN kód megadása esetén a SIM kártya három sikertelen próbálkozás után lezárhat — a mentés előtt ellenőrizd a PIN kódot.

VID (Vendor ID) Add meg az 1. lépésben talált Vendor ID értéket (például: 067B).

PID (Product ID) Add meg az 1. lépésben talált Product ID értéket (például: 2303).

Miután minden mezőt kitöltöttél, kattints a Save gombra. A SIWENOID v2 megpróbálja inicializálni a kommunikációt a GSM eszközzel a megadott VID/PID alapján. Ellenőrizd, hogy a modul státusza „connected” vagy „ready” állapotba kerül-e mentés után.

Az SMS modul ezután elérhető lesz a Taskok konfigurálásánál. A telefonszámokat nem a modulban, hanem a Task definícióban kell megadni.

Az email modul lehetővé teszi, hogy a SIWENOID v2 e-mail értesítéseket küldjön SMTP levelezőszerveren keresztül.

Töltsd ki a következő mezőket:

Név A modul megnevezése. Példa: “Biztonsági értesítések email” vagy “SMTP kimenő”.

Felhasználónév Az SMTP szerverhez történő hitelesítéshez használt felhasználónév. A legtöbb szolgáltatónál ez a teljes e-mail cím (például: siwenoid.alerts@yourdomain.com).

Küldő cím Az az e-mail cím, amely a kimenő üzenetek „From” mezőjében megjelenik. Ez általában megegyezik a felhasználónévvel.

Jelszó Az SMTP szerverhez történő hitelesítéshez használt jelszó.

Host Az SMTP szerver címe. Példák:

• Office 365: smtp.office365.com
• Saját mail szerver: mail.yourdomain.com

Port Az SMTP szerver TCP portja. Gyakori értékek:

• 587 — SMTP STARTTLS titkosítással (ajánlott)
• 465 — SMTP SSL/TLS-en keresztül
• 25 — titkosítás nélküli SMTP (nem ajánlott, sok helyen blokkolt)

A helyes beállításokhoz mindig a szolgáltató dokumentációját kell követni.

A Google megszüntette a „less secure apps” opciót, ezért a Gmail közvetlen SMTP használata a hagyományos felhasználónév/jelszó módszerrel nem támogatott.

Ha mégis Gmail fiókot kell használni, az alábbi lehetőségek vannak:

• App Password használata (2-Step Verification bekapcsolása szükséges)
• Google Workspace SMTP relay használata adminisztrátori konfigurációval
• Más e-mail szolgáltató vagy dedikált vállalati SMTP fiók használata

Új telepítések esetén ajánlott inkább vállalati levelezőszervert vagy dedikált SMTP szolgáltatást használni.

Miután minden mezőt kitöltöttél, kattints a Save gombra. Az email modul ezután elérhető lesz a Taskokban. A címzetteket a Task definícióban kell megadni.

• A modulok szerver oldali komponensek, amelyeket a SIWENOID v2 szerverfolyamat kezel. Akkor is működnek, ha nincs kliens csatlakoztatva.
• Az SMS modulhoz használt USB GSM eszköznek fizikailag azon a gépen kell lennie, amelyen a SIWENOID v2 szerver fut. Nem lehet távoli gépen vagy hálózaton keresztül elérhető eszköz.
• Ha a GSM eszköz lecsatlakozik vagy a SIM kártya elveszíti a hálózatot, az SMS küldés sikertelen lesz. A hibák az event logban rögzítésre kerülnek.
• A modul konfigurációk a SIWENOID v2 adatbázis részét képezik, és bekerülnek az adatbázis mentésekbe.
• Modul létrehozása vagy módosítása után tesztelni kell a működést egy olyan teszt eseménnyel, amely ezt a modult használja egy Taskban, és ellenőrizni kell, hogy az SMS vagy e-mail sikeresen megérkezik.

—

Prev ← Creating Categories Next → Everyday Operation of SIWENOID v2