# Connect Tools

SSH-Verbindungstools und Shortcuts für den schnellen Zugriff auf easyname-Infrastruktur.

---

## Inhaltsverzeichnis

- [Übersicht](#übersicht)
- [Enthaltene Tools](#enthaltene-tools)
- [Voraussetzungen](#voraussetzungen)
- [Lizenz / Sichtbarkeit](#lizenz--sichtbarkeit)

---

## Übersicht

Die Connect-Tools vereinfachen den Zugriff auf verschiedene easyname-Server durch intelligente SSH-Shortcuts mit Kerberos-Authentifizierung. Sie reduzieren wiederkehrende Eingaben und ermöglichen schnelle Verbindungen zu Web-, Mail-, Logger- und Support-Servern.

---

## Enthaltene Tools

### [`go`](./go)
SSH-Shortcut-Tool für schnelle Verbindungen zu easyname-Servern.

- [Dokumentation & Beispiele](./go/README.md)

**Features:**
- Kerberos-Authentifizierung (`go kinit`)
- Web-Server Zugriff mit optionalem easyuser-Wechsel (`go web 42 e110604`)
- Mail-Server Zugriff (`go mx 12`)
- Logger-Server Zugriff (`go logger`)
- Support-Server Zugriff (`go support`)
- Remote-Command Ausführung mit `--` Separator
- Unterstützung für Here-Documents und Piping

**Quick Examples:**
```bash
# Kerberos-Auth
go kinit

# Web-Server mit easyuser
go web 42 e110604

# Remote-Command auf MX-Server
go mx 12 -- mailq | head -5

# Logs auf Logger durchsuchen
go logger -- grep "error" /var/log/syslog
```

---

## Voraussetzungen

### Generelle Anforderungen
- **Kerberos-Setup**: Funktionierende Kerberos-Konfiguration
- **SSH-Zugriff**: Berechtigungen für easyname-Infrastruktur
- **LUSER Variable**: Muss in Environment gesetzt sein

### Setup-Anleitung
1. LUSER in `~/.bashrc` oder `~/.bash_env` setzen:
   ```bash
   export LUSER="deinusername"
   ```

2. Kerberos-Ticket erstellen:
   ```bash
   kinit deinusername@NESSUS.AT
   # oder mit go-Tool:
   go kinit
   ```

3. Tool in PATH hinzufügen oder Alias erstellen:
   ```bash
   # Option 1: Alias
   alias go="/pfad/zu/connect/go/go.sh"
   
   # Option 2: Symlink
   ln -s /pfad/zu/connect/go/go.sh ~/bin/go
   ```

---

## Lizenz / Sichtbarkeit

> Dieses Repository ist **intern** für easyname Support.  
> Falls eine Freigabe nach extern geplant ist, bitte vorab mit Teamleitung abklären.

---

*Diese Tools wurden mit Hilfe von Claude Code erstellt.*