VulnCheck CLI

VulnCheck CLI로 어디서든 VulnCheck를 활용하세요

MacOS, Linux, Windows 플랫폼 전반에서 CLI를 통해 VulnCheck 인텔리전스에 접근할 수 있습니다.
터미널에서 VulnCheck 인덱스를 탐색하고, 백업을 관리하며, 오프라인에서 VulnCheck IP 인텔리전스에 접근할 수 있습니다.

VulnCheck CLI에 어떻게 접근하나요?

VulnCheck CLI는 GitHub에서 오픈소스로 제공됩니다: https://github.com/vulncheck-oss/cli

VulnCheck CLI 설치

설치 스크립트를 사용해 손쉽게 설치할 수 있습니다. 운영체제에 맞는 방법을 선택하세요:

curl -sSL https://raw.githubusercontent.com/vulncheck-oss/cli/main/install.sh | bash

더 자세한 설치 방법은 GitHub에서 확인하세요.

VulnCheck 액세스 구성

  1. 터미널에서 아래 명령어로 VulnCheck 계정에 인증하세요:
vulncheck auth login
  1. 브라우저로 로그인하거나 인증 토큰을 붙여넣어 인증을 완료합니다.

VulnCheck CLI 사용법

스크립팅 및 자동화 (v1.0.0+)

vulncheck 1.0.0부터 CLI는 스크립트와 AI 에이전트를 위한 안정적인 계약을 제공합니다. 전체 참조는 GitHub에서 확인하세요. 요약:

  • --json은 모든 명령어에서 사용할 수 있는 전역 플래그입니다. stdout에는 JSON 페이로드만 출력되며, 정보, 진행 상황, 스피너, 경고는 stderr로 전송됩니다. vulncheck <cmd> --json | jq는 항상 작동합니다.
  • 의미 있는 종료 코드: 0 성공, 1 내부 오류, 2 검증 실패, 3 인증 실패, 4 없음, 5 속도 제한, 6 네트워크, 130 취소됨.
  • 구조화된 오류: --json 모드에서 실패 시 stdout에 {"schema_version":1,"error":{"code":"...","message":"...","http_status":...}}가 출력됩니다. .error.code를 기준으로 분기하세요.
  • --no-interactive는 프롬프트를 거부합니다 (--json, 비-TTY, 또는 CI=1에서 자동 적용). 인터랙티브 명령어는 종료 코드 2로 빠르게 실패합니다.
  • **vulncheck commands**는 전체 명령어 트리를 JSON으로 덤프하여 기능 탐색을 지원합니다 — --help를 파싱할 필요가 없습니다.
vulncheck auth status --json | jq -e '.authenticated'   # 인증된 경우 종료 코드 0
vulncheck version --json | jq -r .version               # CLI 버전 조회
vulncheck commands | jq '.root.subcommands[].name'      # 명령어 탐색

VulnCheck CLI에 기여하기

문제 제기와 기능 제안 등 커뮤니티 기여를 환영합니다. GitHub에서 제출할 수 있습니다.
이슈 제출 시 문제를 재현할 수 있는 충분한 정보를 포함해야 하며, 기능 제안 시 합리적인 사용 사례, 단위 테스트, CI/CD 자동 검증을 통과해야 합니다.

VulnCheck Insights

VulnCheck 오프라인