cli-anything-jumpserver

Que fait cli-anything-jumpserver ?

Interface en ligne de commande avec état pour le bastion JumpServer. Gérez les actifs, utilisateurs, permissions, comptes, sessions, audits et plus via l'API REST de JumpServer.

Démarrage rapide

# Installation
cd agent-harness && pip install -e .

# Authentification
cli-anything-jumpserver auth login --url https://jumpserver.example.com --username admin

# Lister les hôtes
cli-anything-jumpserver asset list --type host

# Mode interactif REPL
cli-anything-jumpserver --interactive

Conseils d'utilisation pour l'agent

Cette CLI est conçue pour être consommée par un agent d'IA. Fonctionnalités clés pour les agents :

Mode de sortie JSON

Toutes les commandes prennent en charge --output json pour une sortie interprétable par machine :

cli-anything-jumpserver asset list --type host --output json

Mode Dry Run

Toutes les commandes de mutation prennent en charge --dry-run pour prévisualiser sans exécution :

cli-anything-jumpserver asset create --name test --address 10.0.0.1 --platform 1 --dry-run --output json

Variables d'environnement

• JUMPSERVER_URL - URL par défaut de JumpServer
• JUMPSERVER_USERNAME - Nom d'utilisateur par défaut
• JUMPSERVER_PASSWORD - Mot de passe par défaut

Workflows typiques pour l'agent

1. Découverte et inventaire

# Vérifier la connexion
cli-anything-jumpserver auth status --output json

# Lister tous les hôtes
cli-anything-jumpserver asset list --type host --output json

# Obtenir les détails d'un actif
cli-anything-jumpserver asset get <ID> --type host --output json

# Lister tous les utilisateurs
cli-anything-jumpserver user list --output json

2. Gestion des utilisateurs et des permissions

# Créer un utilisateur
cli-anything-jumpserver user create --name "Nouvel utilisateur" --username newuser --email [email protected] --output json --dry-run

# Accorder l'accès à un actif
cli-anything-jumpserver perm create --name "Accès Application" --users "user1,user2" --assets "asset1,asset2" --output json --dry-run

# Vérifier les permissions
cli-anything-jumpserver perm users <PERM_ID> --output json

3. Audit de sécurité

# Vérifier les échecs de connexion
cli-anything-jumpserver audit login --status failed --output json

# Examiner les opérations
cli-anything-jumpserver audit operate --action delete --output json

# Vérifier les sessions actives
cli-anything-jumpserver session list --active --output json

# Voir l'historique des commandes
cli-anything-jumpserver session command list --risk 5 --output json

4. Gestion des sessions

# Surveiller les sessions actives
cli-anything-jumpserver session list --active --output json

# Vérifier la santé des terminaux
cli-anything-jumpserver session terminal list --output json
cli-anything-jumpserver session terminal status <TERMINAL_ID> --output json

Formats de sortie

Format	Drapeau	Cas d'utilisation
Tableau	--output table (par défaut)	Affichage lisible par l'humain
JSON	--output json	Consommation par agent, script
YAML	--output yaml	Configuration, lisibilité

Codes de sortie

Code	Signification
0	Succès
1	Erreur CLI (authentification, API, etc.)
2	Erreur d'utilisation (options/arguments invalides)
130	Interrompu (Ctrl+C)

Emplacements des fichiers

Chemin	Objectif
~/.jumpserver-cli/session.json	Session d'authentification
~/.jumpserver-cli/state.json	État opérationnel de la CLI