cli-anything-jumpserver は何をしますか？
JumpServer 堡垒機（バスティオンホスト）のためのステートフルCLIハーネス。JumpServer REST API を介して、アセット、ユーザー、権限、アカウント、セッション、監査などを管理します。
クイックスタート
# インストール
cd agent-harness && pip install -e .
# 認証
cli-anything-jumpserver auth login --url https://jumpserver.example.com --username admin
# ホスト一覧表示
cli-anything-jumpserver asset list --type host
# 対話型REPLモード
cli-anything-jumpserver --interactive
エージェント利用ガイド
このCLIはAIエージェントによる利用を想定して設計されています。エージェント向けの主な機能は次のとおりです。
JSON出力モード
すべてのコマンドは --output json をサポートしており、機械が解析しやすい形式で出力します。
cli-anything-jumpserver asset list --type host --output json
ドライランモード
すべての変更コマンドは --dry-run をサポートしており、実行前に結果をプレビューできます。
cli-anything-jumpserver asset create --name test --address 10.0.0.1 --platform 1 --dry-run --output json
環境変数
JUMPSERVER_URL- デフォルトのJumpServer URLJUMPSERVER_USERNAME- デフォルトのユーザー名JUMPSERVER_PASSWORD- デフォルトのパスワード
典型的なエージェントワークフロー
1. 資産発見とインベントリ
# 接続確認
cli-anything-jumpserver auth status --output json
# 全ホスト一覧
cli-anything-jumpserver asset list --type host --output json
# 資産詳細の取得
cli-anything-jumpserver asset get <ID> --type host --output json
# 全ユーザー一覧
cli-anything-jumpserver user list --output json
2. ユーザーと権限管理
# ユーザー作成
cli-anything-jumpserver user create --name "新規ユーザー" --username newuser --email [email protected] --output json --dry-run
# アセットアクセス権限付与
cli-anything-jumpserver perm create --name "アプリケーションアクセス" --users "user1,user2" --assets "asset1,asset2" --output json --dry-run
# 権限の確認
cli-anything-jumpserver perm users <PERM_ID> --output json
3. セキュリティ監査
# 失敗したログインの確認
cli-anything-jumpserver audit login --status failed --output json
# 操作履歴の確認
cli-anything-jumpserver audit operate --action delete --output json
# アクティブセッションの確認
cli-anything-jumpserver session list --active --output json
# コマンド履歴の表示
cli-anything-jumpserver session command list --risk 5 --output json
4. セッション管理
# アクティブセッションの監視
cli-anything-jumpserver session list --active --output json
# ターミナルのヘルスチェック
cli-anything-jumpserver session terminal list --output json
cli-anything-jumpserver session terminal status <TERMINAL_ID> --output json
出力フォーマット
| フォーマット | フラグ | ユースケース |
|---|---|---|
| テーブル | --output table（デフォルト） | 人間が読める表示 |
| JSON | --output json | エージェント消費、スクリプト処理 |
| YAML | --output yaml | 構成、可読性 |
終了コード
| コード | 意味 |
|---|---|
| 0 | 成功 |
| 1 | CLIエラー（認証、APIなど） |
| 2 | 使用法エラー（オプション/引数が無効） |
| 130 | 中断（Ctrl+C） |
ファイル保存場所
| パス | 目的 |
|---|---|
~/.jumpserver-cli/session.json | 認証セッション |
~/.jumpserver-cli/state.json | CLI操作状態 |