# 🔗 Checkmk Remote Access

![Version](https://img.shields.io/badge/Version-1.4.4-blue)
![Checkmk](https://img.shields.io/badge/Checkmk-Community%202.5-15d1a0)
![SSH](https://img.shields.io/badge/Access-SSH-informational)
![RDP](https://img.shields.io/badge/Access-RDP-informational)

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.