cli-anything-jumpserver

¿Qué hace cli-anything-jumpserver?

Harness CLI con estado para el servidor bastión JumpServer. Administra activos, usuarios, permisos, cuentas, sesiones, auditorías y más a través de la API REST de JumpServer.

Inicio rápido

# Instalación
cd agent-harness && pip install -e .

# Autenticación
cli-anything-jumpserver auth login --url https://jumpserver.ejemplo.com --username admin

# Listar hosts
cli-anything-jumpserver asset list --type host

# Modo REPL interactivo
cli-anything-jumpserver --interactive

Guía de uso para agentes

Esta CLI está diseñada para ser utilizada por agentes de IA. Funciones clave para agentes:

Modo de salida JSON

Todos los comandos admiten --output json para una salida legible por máquina:

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

Modo de simulación (dry-run)

Todos los comandos de mutación admiten --dry-run para previsualizar sin ejecutar:

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

Variables de entorno

• JUMPSERVER_URL - URL predeterminada de JumpServer
• JUMPSERVER_USERNAME - Nombre de usuario predeterminado
• JUMPSERVER_PASSWORD - Contraseña predeterminada

Flujos de trabajo típicos para agentes

1. Descubrimiento e inventario

# Verificar conexión
cli-anything-jumpserver auth status --output json

# Listar todos los hosts
cli-anything-jumpserver asset list --type host --output json

# Obtener detalles de un activo
cli-anything-jumpserver asset get <ID> --type host --output json

# Listar todos los usuarios
cli-anything-jumpserver user list --output json

2. Gestión de usuarios y permisos

# Crear usuario
cli-anything-jumpserver user create --name "Nuevo Usuario" --username nuevo_usuario --email [email protected] --output json --dry-run

# Conceder acceso a activos
cli-anything-jumpserver perm create --name "Acceso App" --users "usuario1,usuario2" --assets "activo1,activo2" --output json --dry-run

# Verificar permisos
cli-anything-jumpserver perm users <ID_PERMISO> --output json

3. Auditoría de seguridad

# Verificar inicios de sesión fallidos
cli-anything-jumpserver audit login --status failed --output json

# Revisar operaciones
cli-anything-jumpserver audit operate --action delete --output json

# Ver sesiones activas
cli-anything-jumpserver session list --active --output json

# Ver historial de comandos
cli-anything-jumpserver session command list --risk 5 --output json

4. Gestión de sesiones

# Monitorear sesiones activas
cli-anything-jumpserver session list --active --output json

# Verificar estado de terminales
cli-anything-jumpserver session terminal list --output json
cli-anything-jumpserver session terminal status <ID_TERMINAL> --output json

Formatos de salida

Formato	Indicador	Caso de uso
Tabla	--output table (predeterminado)	Visualización legible para humanos
JSON	--output json	Consumo por agentes, scripts
YAML	--output yaml	Configuración, legibilidad

Códigos de salida

Código	Significado
0	Éxito
1	Error de CLI (autenticación, API, etc.)
2	Error de uso (opciones/argumentos inválidos)
130	Interrumpido (Ctrl+C)

Ubicaciones de archivos

Ruta	Propósito
~/.jumpserver-cli/session.json	Sesión de autenticación
~/.jumpserver-cli/state.json	Estado operacional de la CLI