mcpField
C
cli-anything-jumpserver

cli-anything-jumpserver

github.com/hkudsセキュリティ57.6k204 回インストール5 週間前に更新
リポジトリ

cli-anything-jumpserver について

REST APIを通じてJumpServerの踏み台サーバーを管理するステートフルなCLIハーネスです。AIエージェントのワークフロー向けに、JSON出力と、資産・ユーザー・権限・セッション・監査記録の変更を事前確認するdry-runを備えています。

主な機能

  1. 01資産、ユーザー、権限の管理
  2. 02セッションと監査記録の確認
  3. 03JumpServerへの認証
  4. 04JSONとYAMLの出力モード
  5. 05dry-runによる変更の事前確認

活用シーン

  1. 01ホストの一覧化と資産詳細の確認
  2. 02ユーザー作成と資産アクセス権の付与
  3. 03ログイン失敗とアクティブセッションの監査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-jumpserver

インストール後、Claude Code で/cli-anything-jumpserverを入力して読み込まれたか確認します。

詳細

cli-anything-jumpserver

JumpServer 踏み台ホスト向けのステートフル CLI ハーネスです。JumpServer REST API を通じて、アセット、ユーザー、権限、アカウント、セッション、監査などを管理できます。

クイックスタート

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

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

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

# Interactive REPL mode
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 URL
  • JUMPSERVER_USERNAME - デフォルトのユーザー名
  • JUMPSERVER_PASSWORD - デフォルトのパスワード
典型的なエージェントワークフロー

1. 検出とインベントリ

# Check connection
cli-anything-jumpserver auth status --output json

# List all hosts
cli-anything-jumpserver asset list --type host --output json

# Get asset details
cli-anything-jumpserver asset get <ID> --type host --output json

# List all users
cli-anything-jumpserver user list --output json

2. ユーザーと権限の管理

# Create user
cli-anything-jumpserver user create --name "New User" --username newuser --email [email protected] --output json --dry-run

# Grant asset access
cli-anything-jumpserver perm create --name "App Access" --users "user1,user2" --assets "asset1,asset2" --output json --dry-run

# Verify permissions
cli-anything-jumpserver perm users <PERM_ID> --output json

3. セキュリティ監査

# Check failed logins
cli-anything-jumpserver audit login --status failed --output json

# Review operations
cli-anything-jumpserver audit operate --action delete --output json

# Check active sessions
cli-anything-jumpserver session list --active --output json

# View command history
cli-anything-jumpserver session command list --risk 5 --output json

4. セッション管理

# Monitor active sessions
cli-anything-jumpserver session list --active --output json

# Check terminal health
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成功
1CLI エラー (認証、API など)
2使用法エラー (無効なオプション/引数)
130中断 (Ctrl+C)

ファイルの場所

パス目的
~/.jumpserver-cli/session.json認証セッション
~/.jumpserver-cli/state.jsonCLI の動作状態

コメント

Markdown 対応