cli-anything-jumpserver

O que cli-anything-jumpserver faz?

CLI com estado para servidor de bastião JumpServer. Gerencie ativos, usuários, permissões, contas, sessões, auditorias e mais através da API REST do JumpServer.

Início Rápido

# Instalação
cd agent-harness && pip install -e .

# Autenticação
cli-anything-jumpserver auth login --url https://jumpserver.example.com --username admin

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

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

Orientação de Uso para Agentes

Esta CLI foi projetada para consumo por agentes de IA. Recursos principais para agentes:

Modo de Saída JSON

Todos os comandos suportam --output json para saída processável por máquina:

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

Modo Dry Run

Todos os comandos de mutação suportam --dry-run para visualizar sem executar:

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

Variáveis de Ambiente

• JUMPSERVER_URL - URL padrão do JumpServer
• JUMPSERVER_USERNAME - Nome de usuário padrão
• JUMPSERVER_PASSWORD - Senha padrão

Fluxos de Trabalho Típicos para Agentes

1. Descoberta e Inventário

# Verificar conexão
cli-anything-jumpserver auth status --output json

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

# Obter detalhes de um ativo
cli-anything-jumpserver asset get <ID> --type host --output json

# Listar todos os usuários
cli-anything-jumpserver user list --output json

2. Gerenciamento de Usuários e Permissões

# Criar usuário
cli-anything-jumpserver user create --name "Novo Usuário" --username novousuario --email [email protected] --output json --dry-run

# Conceder acesso a ativos
cli-anything-jumpserver perm create --name "Acesso ao App" --users "user1,user2" --assets "asset1,asset2" --output json --dry-run

# Verificar permissões
cli-anything-jumpserver perm users <PERM_ID> --output json

3. Auditoria de Segurança

# Verificar logins com falha
cli-anything-jumpserver audit login --status failed --output json

# Revisar operações
cli-anything-jumpserver audit operate --action delete --output json

# Verificar sessões ativas
cli-anything-jumpserver session list --active --output json

# Visualizar histórico de comandos
cli-anything-jumpserver session command list --risk 5 --output json

4. Gerenciamento de Sessões

# Monitorar sessões ativas
cli-anything-jumpserver session list --active --output json

# Verificar saúde do terminal
cli-anything-jumpserver session terminal list --output json
cli-anything-jumpserver session terminal status <TERMINAL_ID> --output json

Formatos de Saída

Formato	Flag	Caso de Uso
Tabela	--output table (padrão)	Exibição legível para humanos
JSON	--output json	Consumo por agentes, scripts
YAML	--output yaml	Configuração, legibilidade

Códigos de Saída

Código	Significado
0	Sucesso
1	Erro de CLI (autenticação, API, etc.)
2	Erro de uso (opções/argumentos inválidos)
130	Interrompido (Ctrl+C)

Localizações de Arquivos

Caminho	Propósito
~/.jumpserver-cli/session.json	Sessão de autenticação
~/.jumpserver-cli/state.json	Estado operacional da CLI