NocMate Logo NocMate
Schnelle Antworten für Setup und Push

NocMate FAQ: Checkmk, Push & Connect

Wie installiere ich Push-Notifications am schnellsten?

Auf dem Checkmk-Server curl -fsSL https://nocmate.app/downloads/install_nocmate_checkmk.sh | sudo bash ausführen — das legt das Push-Plugin in deiner OMD-Site ab und lädt Checkmk neu. Danach eine Notification-Rule mit der Methode „NocMate Push" anlegen und zwei Parameter setzen (siehe unten). Du brauchst nur den 40-stelligen User-Key aus der App — kein Connect, kein Agent.

Was kommt in die Notification-Rule?

Methode NocMate Push (nocmate_push), Parameter 1 = https://api.nocmate.app, Parameter 2 = User-Key aus der App (Settings → Push Notifications). Optional Parameter 3 = Sender-Key, falls das Relay mit erzwungener Sender-Authentifizierung läuft. (Der optionale Connect-Wizard kann die Rule auch automatisch anlegen.)

Bekomme ich Push auf iPhone und Mac gleichzeitig?

Ja. Mehrere Geräte können unter demselben User-Key registriert sein und erhalten dann dieselben Alerts parallel.

Mehrere Personen am selben Checkmk-Server?

Pro Person eine eigene Notification-Rule mit dem User-Key ihrer App-Installation — das Plugin selbst wird nur einmal installiert. Den User-Key bekommt jede Person aus ihrer eigenen App. Für den App-Zugriff (Hosts/Services) auf eine nicht-public Checkmk-Site siehe Connect-FAQ unten sowie das Team-Setup.

Was tun, wenn Push nicht ankommt?

Erst API-Health prüfen (api.nocmate.app/api/v1/health), danach Rule-Conditions und User-Key gegenprüfen. Bulking deaktivieren. Im Web-UI Setup → Notifications → Test Notification direkt auslösen, um die Methode unabhängig von Events zu prüfen.

NocMate Connect

FAQ zum Tunnel

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.

NocMate auswählen und starten

Welche App bringt Checkmk-Alerts auf iPhone und Mac?

NocMate zeigt Checkmk-Hosts und Services auf Apple-Geräten und empfängt Push-Benachrichtigungen bei Ausfällen und Recovery. Über die App kannst du Probleme quittieren und Wartungszeiten planen.

Brauche ich für Push einen öffentlich erreichbaren Checkmk-Server?

Nein. Für Push sendet das Checkmk-Notification-Skript Meldungen an die NocMate Push API. Für Live-Daten und Aktionen aus einer privaten Checkmk-Instanz kannst du zusätzlich NocMate Connect verwenden. Der Connect-Agent baut die Verbindung nach außen auf.

Was kostet NocMate?

Der Einstieg ist kostenlos und umfasst 30 Push-Benachrichtigungen pro Monat. Small umfasst 500 Push-Benachrichtigungen pro Monat; Unlimited umfasst unbegrenzte Push-Benachrichtigungen und einen Connect-Standort. Preise, Abo-Laufzeit und zusätzliche Connect-Pakete findest du im App Store und in der App.

Welche Geräte und Monitoring-Systeme werden unterstützt?

Der App-Store-Eintrag nennt iOS und iPadOS ab Version 17 sowie macOS ab Version 14 auf Apple Silicon ab M1. NocMate unterstützt Checkmk über REST API und Multisite sowie Nagios Core, Icinga und Thruk über Classic CGI. Die Setup-Anleitung beschreibt die Checkmk-Anbindung.

Kann ich NocMate zuerst ohne eigenes Monitoring testen?

Ja. Der Demo-Modus zeigt die App mit Beispieldaten, ohne dass du vorher einen Account oder eine Monitoring-Instanz einrichten musst.

Wie funktioniert Push für mehrere Geräte und Personen?

Mehrere Geräte können denselben User Key verwenden und Alerts parallel empfangen. Für mehrere Personen legst du in Checkmk eigene Notification-Regeln mit den jeweiligen User Keys an. Das Push-Skript wird auf der Site nur einmal installiert.

App Store · Alarmierungswege vergleichen