Modul erstellen

Diese Seite beschreibt, wie Kommunikationsmodule in SIWENOID v2 konfiguriert werden. Module sind die Komponenten, die es SIWENOID v2 ermöglichen, ausgehende Benachrichtigungen — wie SMS-Nachrichten und E-Mails — als Reaktion auf Ereignisse zu senden. Module werden einmal erstellt und anschließend von Tasks (siehe Tasks erstellen) referenziert, die definieren, wann und an wen Benachrichtigungen gesendet werden.

Ein Modul in SIWENOID v2 ist ein konfigurierter Kommunikationskanal, den der Server zum Senden ausgehender Nachrichten verwenden kann. Jedes Modul definiert die technischen Verbindungsparameter für eine bestimmte Kommunikationsmethode. Die zwei unterstützten Typen von Benachrichtigungsmodulen sind:

• SMS-Modul — sendet Textnachrichten über ein GSM-Modem oder ein USB-SIM-Karten-Gerät, das mit der SIWENOID v2 Servermaschine verbunden ist. Erfordert ein physisches GSM-Hardwaregerät mit SIM-Karte.
• E-Mail-Modul — sendet E-Mail-Benachrichtigungen über einen SMTP-Mailserver. Erfordert Netzwerkzugriff vom SIWENOID v2 Server auf den konfigurierten SMTP-Server.

Es können mehrere Module desselben Typs erstellt werden — zum Beispiel zwei SMS-Module mit unterschiedlichen SIM-Karten zur Redundanz oder zwei E-Mail-Module mit unterschiedlichen Absenderkonten für verschiedene Benachrichtigungstypen.

Module selbst definieren nicht, wann Nachrichten gesendet werden oder an wen. Diese Konfiguration erfolgt in Tasks. Ein Modul ist ausschließlich der technische Versandkanal.

Prev ← Kategorien erstellen Next → Alltäglicher Betrieb von SIWENOID v2

Um auf die Modulkonfiguration zuzugreifen, navigieren Sie zu File → Preferences → Modules.

Der Modulbildschirm listet alle aktuell konfigurierten Module auf. Klicken Sie auf die Schaltfläche Add (Plus-Symbol), um ein neues Modul zu erstellen. Geben Sie einen Namen für das Modul ein und wählen Sie den Modultyp (SMS oder Email) aus dem Typ-Dropdown. Die angezeigten Konfigurationsfelder hängen vom gewählten Typ ab.

Das SMS-Modul ermöglicht es SIWENOID v2, Textnachrichten über ein USB-GSM-Modem oder ein USB-Gerät mit SIM-Karte zu senden, das mit der Servermaschine verbunden ist.

Bevor das SMS-Modul konfiguriert wird, müssen die Vendor ID (VID) und die Product ID (PID) des USB-GSM-Geräts ermittelt werden. Diese Werte identifizieren die USB-Hardware eindeutig für SIWENOID v2 und sind erforderlich, damit die Software mit dem Gerät kommunizieren kann.

Um die VID und PID unter Windows zu finden:

1. Verbinden Sie das USB-GSM-Gerät mit der Servermaschine.
2. Öffnen Sie den Windows Geräte-Manager (Rechtsklick auf die Start-Schaltfläche und Auswahl von Geräte-Manager oder Ausführen von devmgmt.msc).
3. Suchen Sie das GSM-Gerät in der Geräteliste. Es erscheint typischerweise unter „Anschlüsse (COM & LPT)“ oder „Modems”.
4. Doppelklicken Sie auf das Gerät, um das Eigenschaftenfenster zu öffnen.

1. Wählen Sie im Eigenschaftenfenster die Registerkarte Details.
2. Wählen Sie im Dropdown Eigenschaft den Eintrag Hardware-IDs.

Der Wert der Hardware-IDs enthält die VID und PID im Format: USB\VID_XXXX&PID_XXXX

• Die vier Zeichen nach VID_ sind die Vendor ID (zum Beispiel: 067B).
• Die vier Zeichen nach PID_ sind die Product ID (zum Beispiel: 2303).

Notieren Sie diese Werte, bevor Sie mit der Modulkonfiguration fortfahren.

Füllen Sie im SMS-Modul-Editor die folgenden Felder aus:

Name Ein beschreibender Name für dieses SMS-Modul, der verwendet wird, um es bei der Zuweisung zu einem Task zu identifizieren. Beispiel: „GSM-Modem 1“ oder „SMS-Benachrichtigungskanal”.

PIN-Code Der PIN-Code der SIM-Karte, die im USB-GSM-Gerät installiert ist. Wenn die SIM-Karte keinen PIN-Code hat, lassen Sie dieses Feld leer. Ein falscher PIN-Code führt dazu, dass die SIM-Karte nach drei fehlgeschlagenen Versuchen gesperrt wird — überprüfen Sie den PIN-Code vor dem Speichern.

VID (Vendor ID) Geben Sie den in Schritt 1 gefundenen Vendor-ID-Wert ein (zum Beispiel: 067B).

PID (Product ID) Geben Sie den in Schritt 1 gefundenen Product-ID-Wert ein (zum Beispiel: 2303).

Nachdem alle Felder ausgefüllt wurden, klicken Sie auf Save. SIWENOID v2 versucht, die Kommunikation mit dem GSM-Gerät unter Verwendung der konfigurierten VID/PID zu initialisieren. Überprüfen Sie nach dem Speichern, ob der Modulstatus als verbunden oder bereit angezeigt wird.

Das SMS-Modul ist nun zur Auswahl verfügbar, wenn Tasks konfiguriert werden. Empfänger-Telefonnummern werden in der Task-Definition konfiguriert, nicht im Modul selbst.

Das E-Mail-Modul ermöglicht es SIWENOID v2, E-Mail-Benachrichtigungen über einen SMTP-Mailserver zu senden.

Füllen Sie die folgenden Felder aus:

Name Ein beschreibender Name für dieses E-Mail-Modul. Beispiel: „Sicherheitsbenachrichtigungen E-Mail“ oder „SMTP-Ausgang”.

Benutzername Der Benutzername zur Authentifizierung beim SMTP-Server. Bei den meisten E-Mail-Anbietern ist dies die vollständige E-Mail-Adresse des Absenderkontos (zum Beispiel: siwenoid.alerts@yourdomain.com).

Absenderadresse Die E-Mail-Adresse, die im „Von“-Feld aller ausgehenden Benachrichtigungen angezeigt wird. Dies ist typischerweise dieselbe wie der Benutzername.

Passwort Das Passwort des Absender-E-Mail-Kontos, das zur Authentifizierung beim SMTP-Server verwendet wird.

Host Die SMTP-Serveradresse des E-Mail-Anbieters. Beispiele:

• Office 365: smtp.office365.com
• Benutzerdefinierter Mailserver: mail.yourdomain.com

Port Der vom SMTP-Server verwendete TCP-Port. Häufige Werte:

• 587 — SMTP mit STARTTLS-Verschlüsselung (empfohlen für die meisten Anbieter)
• 465 — SMTP über SSL/TLS
• 25 — unverschlüsseltes SMTP (nicht empfohlen, von vielen Anbietern blockiert)

Konsultieren Sie die Dokumentation Ihres E-Mail-Anbieters für die korrekten Host- und Portwerte.

Google hat die Option „Zugriff durch weniger sichere Apps erlauben” entfernt, die zuvor für den direkten SMTP-Zugriff auf Gmail-Konten erforderlich war. Gmail kann in dieser Konfiguration nicht mehr direkt als SMTP-Absender mit einem Standard-Benutzernamen und Passwort verwendet werden.

Wenn ein Gmail-Konto verwendet werden muss, stehen folgende Alternativen zur Verfügung:

• Konfigurieren Sie ein App-Passwort im Google-Konto (erfordert aktivierte Zwei-Faktor-Authentifizierung) und verwenden Sie dieses App-Passwort im Passwortfeld anstelle des regulären Kontopassworts.
• Verwenden Sie ein Google Workspace-Konto mit vom Administrator konfiguriertem SMTP-Relay.
• Verwenden Sie einen anderen E-Mail-Anbieter oder ein dediziertes Benachrichtigungs-E-Mail-Konto auf einem Domain-Mailserver.

Für neue Installationen wird empfohlen, ein dediziertes E-Mail-Konto auf einem Unternehmens-Mailserver oder einen professionellen SMTP-Relay-Dienst zu verwenden, anstatt ein persönliches Gmail-Konto.

Nachdem alle Felder ausgefüllt wurden, klicken Sie auf Save. Das E-Mail-Modul steht nun zur Auswahl bei der Konfiguration von Tasks zur Verfügung. Empfänger-E-Mail-Adressen werden in der Task-Definition konfiguriert, nicht im Modul selbst.

• Module sind serverseitige Komponenten, die vom SIWENOID v2 Serverprozess verwaltet werden. Sie funktionieren unabhängig davon, ob ein Client verbunden ist.
• Das USB-GSM-Gerät für das SMS-Modul muss mit der physischen Maschine verbunden sein, auf der der SIWENOID v2 Server läuft. Es kann sich nicht auf einem entfernten Rechner befinden oder über ein Netzwerk verbunden sein.
• Wenn das GSM-Gerät getrennt wird oder die SIM-Karte das Signal verliert, schlägt der SMS-Versand fehl. Fehler bei der Task-Ausführung werden im SIWENOID v2 Ereignisprotokoll aufgezeichnet.
• Modulkonfigurationen werden in der SIWENOID v2 Datenbank gespeichert und sind in Datenbanksicherungen enthalten.
• Nach dem Erstellen oder Ändern eines Moduls sollte dieses getestet werden, indem ein Testereignis manuell ausgelöst wird, das dieses Modul in einem Task verwendet, und überprüft wird, ob die SMS oder E-Mail korrekt empfangen wird.

—

Prev ← Kategorien erstellen Next → Alltäglicher Betrieb von SIWENOID v2