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

🐧 Linux / Unix

Automatischer SSH-Zugriff, z. B. ssh://192.168.188.125. Unterstützt werden Linux, Unix, FreeBSD, OpenBSD, Solaris und AIX.

🪟 Windows

RDP über rdpadmin://192.168.188.122. Der eigene Windows Protocol Handler startet anschließend mstsc.exe.

🔌 Checkmk-Integration

In Setup → Hosts erscheinen abhängig vom Betriebssystem SSH- bzw. RDP-Aktionen. Zusätzlich werden die Aktionen in die Icons-Spalte der Monitoring Views integriert.

🔎 Automatische Betriebssystemerkennung

Die Auswahl von SSH oder RDP erfolgt anhand der Checkmk Host Labels, insbesondere cmk/os_family. Als Ziel wird bevorzugt host_address verwendet.

📥 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

Danach gegebenenfalls einen Hard-Reload im Browser 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

🖥️ Windows SSH / RDP

Für ssh:// muss unter Windows ein geeigneter SSH-Client zugeordnet sein; getestet wurde PuTTY. Für RDP startet der rdpadmin://-Handler mstsc.exe, ohne .rdp-Dateien herunterzuladen.

🧰 Fehlerdiagnose

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

✅ 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.