NocMate Connect ist ein optionaler Tunnel, der App-Anfragen über unser Relay an einen
kleinen Agent auf deinem Checkmk-Server weiterleitet. Damit muss Checkmk nicht öffentlich
erreichbar sein. Hier die häufigsten Fragen zu Sicherheit, Datenschutz und Betrieb.
Wie ist der Datenfluss bei Connect?
App → Relay → Agent → lokales Checkmk → zurück über denselben Pfad. Die App kennt
keine direkte URL deines Checkmk-Servers; sie spricht ausschliesslich mit
api.nocmate.app. Der Agent baut
ausgehend eine HTTPS-Verbindung zum Relay auf und holt sich Anfragen per Long-Polling ab.
Werden Monitoring-Daten beim Relay gespeichert?
Nein. Anfragen und Antworten werden nur im RAM des Relays durchgereicht und nach der
Auslieferung verworfen. Es gibt keine Snapshots, keinen Cache, kein Body-Logging.
Persistiert werden nur die Routing-Metadaten (User-Key-Bindung, Token-Hash, last-seen-Timestamp).
Ist der Tunnel Ende-zu-Ende verschlüsselt?
Verschlüsselung am Transport: ja, jede Verbindung ist TLS (HTTPS). Streng technisch ist es kein
klassisches End-to-End, weil das Relay die Anfragen während der Weiterleitung im RAM sieht – das
ist das gleiche Vertrauensmodell wie bei Cloudflare Tunnel, ngrok oder Tailscale Funnel.
Wir loggen keine Inhalte und cachen nichts. Echtes End-to-End mit ECDH-Schlüsselaustausch zwischen
App und Agent ist als Phase-2-Erweiterung geplant; das Relay sieht dann nur noch Routing-Header
und opaque Ciphertext.
Wie ist der Tunnel gegen Hijacking abgesichert?
- Pairing-Code: 6-stellig, 5 Minuten gültig, single-use, beim Claim sofort verbraucht
- Agent-Token: HMAC-basiert, im Server nur als SHA-256-Hash gespeichert
- App-Aufrufe brauchen
X-User-Access-Key; daraus löst der Server den User-Key auf
- Jede Proxy-Anfrage prüft DB-seitig: gehört diese
instance_id dem authentifizierten User?
- Cross-User-Routing ist konstruktiv unmöglich, weil Tunnel-Queues pro (User-Key, Instance-ID) getrennt sind
- Tunnel kann jederzeit aus der App gelöscht werden – damit wird der Token-Hash entfernt
Wo läuft das Relay und wer hat Zugriff?
Das Relay läuft auf einem Server in Deutschland (EU). Zugriff hat ausschliesslich der
Verantwortliche von DIGIFLO (siehe Datenschutz).
Die SQLite-Datenbank des Relays enthält für Connect ausschliesslich: User-Key, Instance-ID,
Instance-Name (frei vergeben), Agent-Token-Hash und Zeitstempel. Keine Hostnamen, keine
Service-Daten, keine Plugin-Outputs.
Welche Firewall-Regeln muss ich öffnen?
Nur ausgehend zu api.nocmate.app:443
(HTTPS). Keine eingehenden Ports, kein Reverse Proxy, kein DNS-Eintrag, kein VPN nötig.
Der Agent kann jederzeit gestoppt werden – die Verbindung bricht dann ab und die App zeigt
den Connector als offline.
Was sieht der Agent von Checkmk?
Der Agent nutzt die lokal hinterlegten Checkmk-Credentials (per Default die
automation-Secret aus der OMD-Site).
Damit hat er nur die Rechte, die du dem entsprechenden Checkmk-Benutzer gegeben hast.
Du kannst einen eigenen, schmalen Automation-User für NocMate anlegen und dem Agent
ausschliesslich die nötigen Berechtigungen vergeben.
Können mehrere Personen denselben Server verwenden?
Ja. Ein einziger Connector kann mehrere NocMate-Identitäten parallel bedienen — jede mit eigenen
Tunnel-Credentials und ihrem eigenen Checkmk-User. Du fügst weitere Personen mit
curl -fsSL https://api.nocmate.app/install/connect.sh | sudo bash -s -- pair --add
hinzu, ohne den Service neu zu installieren oder zu unterbrechen.
Weil jede Identity sich gegen Checkmk als ihr eigener User authentifiziert, greifen die nativen
Checkmk-Permissions (Contact Groups, Roles) auch durch den Tunnel. Was die Kollegin im Web-UI nicht
sehen darf, sieht sie auch in NocMate nicht. Acknowledgements erscheinen im Audit-Log unter dem
korrekten User-Namen — kein geteilter automation-Account nötig.
Details unter Team-Setup.
Was passiert, wenn das Relay ausfällt?
Die App zeigt den Connector als offline und liefert die zuletzt erfolgreich geladenen Daten weiter.
Der Agent versucht in kurzen Abständen, sich neu am Relay anzumelden. Sobald das Relay wieder
erreichbar ist, läuft alles automatisch weiter. Push-Notifications laufen unabhängig vom Tunnel,
Checkmk schickt sie weiterhin direkt an die Push-API.
Wie deinstalliere ich Connect?
In der App: Settings → Sites die
Connect-Site löschen (Token wird serverseitig sofort entwertet). Bei einem Team-Setup mit mehreren
Identities reicht das, um nur deine eigene zu entfernen — die der Kolleginnen läuft weiter.
Wenn du eine Identity zentral entfernen willst:
sudo bash -c "$(curl -fsSL https://api.nocmate.app/install/connect.sh)" -- pair --remove <name>.
Wenn keine Identity mehr aktiv ist und der Service ganz weg soll:
sudo systemctl disable --now nocmate-connector und
sudo rm /usr/local/bin/nocmate-connector /etc/systemd/system/nocmate-connector.service /etc/nocmate/connector.conf.