103 lines
2.9 KiB
Markdown
103 lines
2.9 KiB
Markdown
# 🔗 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](../README.md)
|
|
|
|
## ✨ 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`
|
|
|
|
```bash
|
|
mkp add /pfad/zu/remote_access-1.4.4.mkp
|
|
mkp enable remote_access 1.4.4
|
|
omd restart apache
|
|
mkp list
|
|
```
|
|
|
|
## ⬆️ Upgrade
|
|
|
|
```bash
|
|
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
|
|
|
|
```text
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```text
|
|
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.
|