Repository navigation
Installation SMS Gateway
Das Gateway ist fuer den SMS-Versand optional, wenn eine Organisation EUS verwendet. Auswahl und Fallback sind unter SMS-Versandweg administrieren beschrieben.
Der SMS-Versand/-Empfang läuft über die native Einsatzcockpit-Android-App (Repo BattloXX/Einsatzcockpit-Android) auf einem beliebigen Android-Gerät mit SIM-Karte. Die App verbindet sich ausgehend per WebSocket mit der Haupt-App und versendet/empfängt SMS über die eingebaute SmsManager-API — kein separater Server, kein Modem, keine offenen Ports nötig.
Zweck: SMS-Versand/-Empfang für die Telefonnummern-Verifizierung im Bürgerportal, Einsatzinfo-SMS bei Alarm, manuellen Versand an Gruppen/Mitglieder und die Weiterleitung eingehender SMS (Teams-Webhook, Gruppen, Mitglieder, Ad-hoc-Nummern).
| Anforderung | Details |
|---|---|
| Android-Gerät mit SIM-Karte | Bleibt dauerhaft eingesteckt/geladen am Standort (z.B. altes Diensthandy im Gerätehaus) |
| Einsatzcockpit-Android-APK | Sideload-APK aus GitHub Releases (kein Play Store nötig) |
Rolle admin
|
Zum Anlegen des SMS-Gateway-Geräts unter Admin → Geräte-Login |
| WLAN oder Mobilfunk am Gerätestandort | Die App hält eine dauerhafte WebSocket-Verbindung zur Haupt-App |
- Aktuelle APK von Releases auf das Android-Gerät laden (USB, E-Mail, Link)
- Einstellungen → Sicherheit → Unbekannte Quellen erlauben (einmalig)
- APK antippen → installieren
Unter Admin → Geräte-Login (/admin/geraete-login):
- + Gerät registrieren
- Gerätetyp: 📡 SMS-Gateway auswählen (statt „Einheit-Gerät")
- Bezeichnung eingeben (z.B.
SMS-Gateway Gerätehaus) - Erstellen — der QR-Code wird angezeigt und enthält den Verbindungs-Token; er wird nur einmal angezeigt
- Einsatzcockpit-Android-App auf dem Gateway-Gerät öffnen
- QR-Code scannen antippen und den QR-Code aus Schritt 2 einscannen
- Die App erkennt automatisch den SMS-Gateway-Modus und wechselt in den Gateway-Bildschirm
- Akku-Optimierung deaktivieren, sobald die App danach fragt (siehe unten — zwingend für Dauerbetrieb)
Der Gateway-Bildschirm zeigt danach laufend: Verbindungsstatus, Server, Token (maskiert), die letzten gesendeten SMS, empfangene SMS (falls SMS-Empfang aktiviert ist) sowie ein Verbindungslog zur Fehlersuche.
Ohne Ausnahme kappt Android (Doze-Modus) die Gateway-Verbindung, sobald das Gerät länger ruht — SMS würden dann nicht zugestellt. Die App fordert das direkt beim ersten Start an; manuell geht es über:
Einstellungen → Apps → Einsatzcockpit → Akku → „Nicht eingeschränkt" / „Keine Einschränkungen"
Bei manchen Herstellern reicht das allein nicht aus:
| Hersteller | Zusätzlich erforderlich |
|---|---|
| Xiaomi/Redmi (MIUI/HyperOS) | „Autostart" aktivieren; Akku → „Keine Einschränkungen"; App in den Recent-Apps „sperren" (Schloss-Symbol) |
| Huawei/Honor (EMUI) | App-Start → „Manuell verwalten" → Autostart/Hintergrund/Wecken erlauben |
| Samsung (One UI) | Akku → „Apps in den Ruhezustand versetzen" → App ausschließen; „Nicht überwachte Apps" |
| OnePlus/Oppo/Realme (ColorOS) | Akku → „Hintergrundaktivität zulassen"; Autostart an |
Übersicht je Hersteller: https://dontkillmyapp.com/
Zusätzlich empfohlen: Gerät dauerhaft am Strom lassen und ein zuverlässiges Netz (WLAN/Mobil) sicherstellen. Bei Netzwechsel verbindet die App automatisch neu.
Ist SMS-Empfang für die Organisation serverseitig eingeschaltet, zeigt der Gateway-Bildschirm eine Karte „SMS-Empfang aktiviert – Berechtigung fehlt" — dort SMS-Empfang erlauben antippen, damit die App die Android-Berechtigung RECEIVE_SMS erhält. Ohne diese Berechtigung werden weiterhin SMS versendet, aber keine eingehenden SMS erkannt/weitergeleitet.
- In der App: Gateway-Bildschirm zeigt Verbindungsstatus (grün = verbunden), Anzahl gesendeter SMS und ein Verbindungslog (kopierbar/herunterladbar für die Fehlersuche)
- Im Admin-Bereich: Admin → Geräte-Login zeigt bei jedem SMS-Gateway ein Badge Verbunden oder Nicht verbunden neben dem Status Aktiv beziehungsweise Widerrufen; eine Test-SMS lässt sich über Admin → SMS senden direkt vom Server aus verschicken
Mehrere Gateways können gleichzeitig registriert werden. Einzel-SMS (etwa Bürgerportal-Codes, Verleih-PINs und Erinnerungen) wechseln zwischen den verbundenen Geräten, ebenso wie SMS innerhalb eines Sammelversands verteilt werden. Mit den Auf-/Ab-Pfeilen in der SMS-Gateway-Tabelle wird die Reihenfolge dieser Verteilung festgelegt. Bei einem Verbindungsfehler vor dem Senden wird das nächste Gateway versucht. Bleibt nach der Übergabe die Bestätigung aus, wird dieselbe SMS nicht erneut gesendet, um Doppelzustellungen zu vermeiden.
Unter Admin → Geräte-Login beim jeweiligen SMS-Gateway-Eintrag Widerrufen wählen. Widerrufene Geräte können bei Bedarf wieder reaktiviert werden; für ein Ersatzgerät einfach ein neues SMS-Gateway-Gerät anlegen (Schritt 2) und den neuen QR-Code scannen.
Der Gateway-Bildschirm prüft automatisch gegen die GitHub Releases und zeigt bei verfügbarem Update einen Download-Button an.
Verwandt: SMS-Einsatzinfo, manueller Versand & SMS-Empfang — Einrichtung der eigentlichen SMS-Funktionen, sobald das Gateway verbunden ist.
Nächster Schritt: Erst-Setup
Einsatz führen
Im Einsatz
Einsatzbegleitend
Verwaltung & Planung
Auswertung
Großschadenslage
Verwaltung
Systemadministration
- Überblick und Inbetriebnahme
- Systemdiagnose
- Datenbank: Snapshot-Isolation
- System-Admin-MCP
- Zwei-Faktor-Authentifizierung
Mehr