Was macht cli-anything-jumpserver?
Statusbehaftete CLI-Werkzeugkiste für JumpServer-Bastion-Host. Verwalten Sie Assets, Benutzer, Berechtigungen, Konten, Sitzungen, Audits und mehr über die JumpServer-REST-API.
Schnellstart
# Installation
cd agent-harness && pip install -e .
# Authentifizierung
cli-anything-jumpserver auth login --url https://jumpserver.example.com --username admin
# Hosts auflisten
cli-anything-jumpserver asset list --type host
# Interaktiver REPL-Modus
cli-anything-jumpserver --interactive
Anleitung zur Agentennutzung
Diese CLI ist für den Einsatz durch KI-Agenten konzipiert. Hauptfunktionen für Agenten:
JSON-Ausgabemodus
Alle Befehle unterstützen --output json für maschinenlesbare Ausgabe:
cli-anything-jumpserver asset list --type host --output json
Trockenlauf-Modus
Alle Mutation-Befehle unterstützen --dry-run zur Vorschau ohne Ausführung:
cli-anything-jumpserver asset create --name test --address 10.0.0.1 --platform 1 --dry-run --output json
Umgebungsvariablen
JUMPSERVER_URL- Standard-JumpServer-URLJUMPSERVER_USERNAME- Standard-BenutzernameJUMPSERVER_PASSWORD- Standard-Passwort
Typische Agenten-Workflows
1. Discovery und Inventarisierung
# Verbindung prüfen
cli-anything-jumpserver auth status --output json
# Alle Hosts auflisten
cli-anything-jumpserver asset list --type host --output json
# Asset-Details abrufen
cli-anything-jumpserver asset get <ID> --type host --output json
# Alle Benutzer auflisten
cli-anything-jumpserver user list --output json
2. Benutzer- und Berechtigungsverwaltung
# Benutzer erstellen
cli-anything-jumpserver user create --name "Neuer Benutzer" --username neuerbenutzer --email [email protected] --output json --dry-run
# Asset-Zugriff gewähren
cli-anything-jumpserver perm create --name "App-Zugriff" --users "benutzer1,benutzer2" --assets "asset1,asset2" --output json --dry-run
# Berechtigungen überprüfen
cli-anything-jumpserver perm users <BERECHTIGUNGS_ID> --output json
3. Sicherheitsaudit
# Fehlgeschlagene Anmeldungen prüfen
cli-anything-jumpserver audit login --status failed --output json
# Operationen überprüfen
cli-anything-jumpserver audit operate --action delete --output json
# Aktive Sitzungen prüfen
cli-anything-jumpserver session list --active --output json
# Befehlsverlauf anzeigen
cli-anything-jumpserver session command list --risk 5 --output json
4. Sitzungsverwaltung
# Aktive Sitzungen überwachen
cli-anything-jumpserver session list --active --output json
# Terminal-Zustand prüfen
cli-anything-jumpserver session terminal list --output json
cli-anything-jumpserver session terminal status <TERMINAL_ID> --output json
Ausgabeformate
| Format | Flag | Anwendungsfall |
|---|---|---|
| Tabelle | --output table (Standard) | Menschenlesbare Anzeige |
| JSON | --output json | Agenten-Nutzung, Skripterstellung |
| YAML | --output yaml | Konfiguration, Lesbarkeit |
Exit Codes
| Code | Bedeutung |
|---|---|
| 0 | Erfolg |
| 1 | CLI-Fehler (Auth, API, usw.) |
| 2 | Nutzungsfehler (ungültige Optionen/Argumente) |
| 130 | Unterbrochen (Strg+C) |
Dateipfade
| Pfad | Zweck |
|---|---|
~/.jumpserver-cli/session.json | Authentifizierungssitzung |
~/.jumpserver-cli/state.json | CLI-Betriebszustand |