cmk-plugins/remote_access/README.md

🔗 Checkmk Remote Access

Direkter SSH- und RDP-Zugriff auf überwachte Hosts aus der Checkmk-Weboberfläche.

Version: 1.4.4 · Autor: Domenik Bildhauer · Zielplattform: Checkmk Community 2.5

⬅️ Zurück zur Plugin-Übersicht

✨ Funktionen

Das Plugin erweitert Checkmk um Remote-Access-Funktionen für Linux-/Unix- und Windows-Hosts.

Linux / Unix

Für Linux- und Unix-Systeme wird automatisch ein SSH-Zugriff angeboten:

ssh://192.168.188.125

Unterstützt werden Linux, Unix, FreeBSD, OpenBSD, Solaris und AIX.

Windows

Für Windows-Systeme wird ein RDP-Zugriff angeboten:

rdpadmin://192.168.188.122

rdpadmin:// verwendet einen eigenen Windows Protocol Handler, der mstsc.exe startet.

🔌 Checkmk-Integration

Setup → Hosts

Abhängig vom Betriebssystem werden ein SSH- bzw. RDP-Icon sowie Open SSH ↗ oder Open RDP ↗ angezeigt.

Monitoring

SSH und RDP werden zusätzlich in die Icons-Spalte der Checkmk Monitoring Views integriert.

🔎 Automatische Betriebssystemerkennung

Die Entscheidung zwischen SSH und RDP erfolgt anhand der von Checkmk ermittelten Host-Labels.

Linux:

cmk/os_family: linux
cmk/os_platform: ubuntu
cmk/os_name: Ubuntu
cmk/os_version: 22.04

Windows:

cmk/os_family: windows

Als Ziel verwendet das Plugin bevorzugt host_address.

📥 Installation

Paket: packages/remote_access-1.4.4.mkp

mkp add /pfad/zu/remote_access-1.4.4.mkp
mkp enable remote_access 1.4.4
omd restart apache
mkp list

⬆️ Upgrade

mkp disable remote_access 1.4.3
mkp add /pfad/zu/remote_access-1.4.4.mkp
mkp enable remote_access 1.4.4
omd restart apache

Anschließend im Browser gegebenenfalls einen Hard-Reload durchführen.

🧑‍💻 Source-Code

src/local/share/check_mk/web/plugins/wato/remote_access_setup.py
src/local/share/check_mk/web/plugins/views/remote_access_views.py
src/local/share/check_mk/web/htdocs/images/icons/remote_access_ssh.svg
src/local/share/check_mk/web/htdocs/images/icons/remote_access_rdp.svg

remote_access_setup.py integriert die Funktionen in Setup → Hosts.

remote_access_views.py integriert die Remote-Access-Icons in die Monitoring Views über multisite_icons_and_actions.

Windows SSH

Damit ssh:// unter Windows funktioniert, muss das Protokoll einem geeigneten SSH-Client zugeordnet sein. Getestet wurde PuTTY.

putty.exe 192.168.188.125

Windows RDP

Für RDP wird rdpadmin:// verwendet:

rdpadmin://192.168.188.122

Der Protocol Handler startet mstsc.exe; dadurch müssen keine .rdp-Dateien heruntergeladen werden.

🧰 Fehlerdiagnose

tail -n 50 ~/var/log/web.log
: > ~/var/log/web.log
omd restart apache
cat ~/var/log/web.log

✅ Status 1.4.4

Funktion	Status
Linux-Erkennung	✅ Getestet
Windows-Erkennung	✅ Getestet
SSH unter Setup → Hosts	✅ Getestet
RDP unter Setup → Hosts	✅ Getestet
SSH aus Monitoring-Ansicht	✅ Getestet
Eigene SSH-/RDP-Icons	✅
Verwendung der Host-IP	✅
RDP aus Monitoring-Problemansicht	⏳ Noch abschließend zu testen

📂 Repository-Struktur

remote_access/
├── README.md
├── CHANGELOG.md
├── packages/
│   └── remote_access-1.4.4.mkp
└── src/
    └── local/share/check_mk/

⚖️ Lizenz

Dieses Plugin wurde für den Einsatz mit Checkmk Community entwickelt.

Checkmk ist eine Marke der Checkmk GmbH.