cli-anything-jumpserver

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 모드

모든 변경 명령어는 --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. 탐색 및 인벤토리

# 연결 확인
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 운영 상태