vulnx

취약점 데이터를 탐색하기 위한 강력한 검색, 필터링 및 분석 기능을 갖춘 최신 CLI

빠른 시작

# 1. Get vulnx
go install github.com/projectdiscovery/vulnx/v2/cmd/vulnx@latest

# 2. Explore commands
vulnx --help
vulnx search --help

# 3. Start exploring vulnerabilities (no API key required)
vulnx filters                          # See all available search fields
vulnx search apache                    # Basic search (subject to rate limits)

# 4. Set up your API key (recommended to avoid rate limits)
vulnx auth                              # Get free API key at https://cloud.projectdiscovery.io

# 5. Enhanced exploration with higher limits
vulnx search apache                    # No rate limits
vulnx id CVE-2021-44228               # Faster responses

vulnx가 하는 일

취약점을 정밀하게 검색:

vulnx search "severity:critical && is_remote:true"
vulnx search "apache || nginx" --limit 20
vulnx search "cvss_score:>8.0 && cve_created_at:2024"

상세 취약점 정보 확인:

vulnx id CVE-2021-44228
vulnx id CVE-2024-1234 --json

취약점 패턴 분석:

vulnx analyze --fields severity
vulnx analyze --fields affected_products.vendor

핵심 명령어

필수 옵션

출력 형식:

vulnx search "apache" --json              # Machine-readable JSON
vulnx search "apache" --output results.json  # Save to file
vulnx search "apache" --silent            # Quiet output

검색 제어:

vulnx search "apache" --limit 50          # Get 50 results
vulnx search "apache" --sort-desc cvss_score  # Sort by CVSS score
vulnx search "apache" --fields cve_id,severity  # Specific fields only

고급 검색:

vulnx search --term-facets severity=5,tags=10 "apache"
vulnx search --range-facets numeric:cvss_score:high:8:10 "remote"
vulnx search --highlight "apache"            # Enable search highlighting
vulnx search --facet-size 20 "nginx"         # More facet buckets
vulnx search --detailed "xss"                # Detailed output like 'id' command

사용 가능한 필드 탐색

검색 가능한 항목 탐색:

vulnx filters                           # Show all available search fields
vulnx filters --json                    # Machine-readable field list
vulnx filters --output fields.json      # Save field info to file

filters 명령어는 모든 검색 가능한 필드에 대한 상세 정보를 표시합니다:

필드 이름 및 데이터 유형
설명 및 예시
필드의 정렬 및 패싯 지원 여부
특정 필드에 사용 가능한 열거형 값
검색 분석기 유형

출력 예시:

Field: severity
Data Type: string
Description: Vulnerability severity level (e.g., critical, high, medium, low, info)
Can Sort: Yes
Facet Possible: Yes
Search Analyzer: keyword-lower
Examples: severity:critical, severity:high
Enum Values: critical, high, medium, low, info, unknown

Total: 69 filters available

이 명령어를 사용하면 복잡한 쿼리를 작성하기 전에 새로운 검색 가능성을 발견하고 필드 구문을 이해할 수 있습니다.

일반적인 검색 패턴

고위험 취약점 찾기:

vulnx search "severity:critical && is_remote:true && is_kev:true"
vulnx search "cvss_score:>8.0 && cve_created_at:>=2024"  # High CVSS from 2024
vulnx search "is_kev:true && age_in_days:<90"            # Recent KEV exploits

기술별 검색:

vulnx search "apache"                     # Apache vulnerabilities
vulnx search "apache || nginx"          # Multiple technologies
vulnx search "affected_products.vendor:microsoft"  # By vendor

심각도 및 점수별 필터링:

vulnx search "severity:high"              # High severity
vulnx search "cvss_score:>7.0"            # CVSS score above 7
vulnx search "epss_score:>0.8"            # High EPSS score

시간 기반 검색:

vulnx search "cve_created_at:>=2024"      # Published in 2024 or later
vulnx search "cve_created_at:>=2024-01-01 && cve_created_at:<2024-07-01"  # First half of 2024
vulnx search "age_in_days:<30"            # Recent vulnerabilities (last 30 days)

악용 가능한 취약점 찾기:

vulnx search "is_poc:true"                # Has proof of concept
vulnx search "is_kev:true"                # Known exploited vulns
vulnx search "is_template:true"           # Has Nuclei templates
vulnx search --detailed "log4j"          # Detailed analysis of specific vuln

필터 플래그

필터 플래그 참조

검색 제어 플래그

제품 및 공급업체 필터링:

vulnx search --product apache,nginx     # Filter by products (searches both vendor and product fields)
vulnx search --vendor microsoft,oracle  # Filter by vendors only
vulnx search "NOT apache"               # Exclude products using query syntax
vulnx search "NOT affected_products.vendor:microsoft"  # Exclude vendors using query syntax

심각도 및 점수:

vulnx search --severity critical,high   # Filter by severity
vulnx search "NOT severity:low"         # Exclude severities using query syntax
vulnx search --cvss-score ">8.0"        # Filter by CVSS score
vulnx search --epss-score ">0.8"        # Filter by EPSS score
vulnx search --vuln-status confirmed     # Filter by status
vulnx search --vuln-age "<30"           # Recent vulnerabilities

악용 특성:

vulnx search --kev                      # KEV vulnerabilities only
vulnx search --template                 # Has Nuclei templates
vulnx search --poc                      # Has proof of concept
vulnx search --hackerone                # HackerOne reported
vulnx search --remote-exploit           # Remotely exploitable

취약점 ID 조회

여러 입력 방법:

# Single ID lookup
vulnx id CVE-2024-1234

# Multiple IDs (comma-separated)
vulnx id CVE-2024-1234,CVE-2024-5678,CVE-2023-9999

# Auto-detection from stdin (no 'id' command needed!)
echo "CVE-2024-1234" | vulnx
echo -e "CVE-2024-1234\nCVE-2024-5678" | vulnx

# File input
vulnx id --file ids.txt

일괄 처리:

# JSON output for automation
vulnx id --json CVE-2024-1234 CVE-2024-5678

# Save to file
vulnx id --output vulns.json --file ids.txt

# Pipeline integration
cat report.txt | grep -o 'CVE-[0-9]\{4\}-[0-9]\+' | vulnx id --json

유용한 필드 이름

쿼리 구문

기본 검색:

vulnx search "apache"                     # Simple term
vulnx search "remote code execution"    # Phrase search
vulnx search "severity:critical"          # Field search

불리언 논리:

vulnx search "apache && nginx"           # Both terms
vulnx search "apache || nginx"            # Either term
vulnx search "apache NOT tomcat"          # Exclude term
vulnx search "(apache || nginx) && severity:high"  # Grouped

범위 및 와일드카드:

vulnx search "cvss_score:>8.0"            # Greater than
vulnx search "cvss_score:<9.0"            # Less than
vulnx search "cve_created_at:>=2024-01-01" # Date comparison
vulnx search "age_in_days:<30"            # Recent vulnerabilities
vulnx search "apache*"                    # Wildcard

날짜 쿼리

중요: 날짜 필드는 비교 연산자(>=, >, <, <=)가 필요합니다.

단일 날짜 비교:

vulnx search "cve_created_at:>=2024"      # CVEs from 2024 onward
vulnx search "cve_created_at:<2024"       # CVEs before 2024
vulnx search "cve_created_at:>2024-06-01" # CVEs after June 1, 2024

날짜 범위:

# CVEs from January 2024 only
vulnx search "cve_created_at:>=2024-01-01 && cve_created_at:<2024-02-01"

# High CVSS CVEs from 2024
vulnx search "cvss_score:>8.0 && cve_created_at:>=2024"

# Recent vulnerabilities (age-based)
vulnx search "age_in_days:<30"            # Last 30 days
vulnx search "age_in_days:>365"           # Older than 1 year

지원되는 형식:

2024 (년)
2024-01 (년-월)
2024-01-15 (전체 날짜)

구성

인증 (선택 사항)

vulnx는 API 키 없이도 작동하지만, 인증을 사용하면 상당한 이점이 있습니다:

⚠️ API 키 없이:

분당 10회 요청으로 제한
엄격한 속도 제한 적용
"429 Too Many Requests" 오류가 발생할 수 있음

✅ API 키 사용 시:

훨씬 높은 속도 제한
모든 필터 접근 가능

인증 설정:

vulnx auth                              # Interactive setup
vulnx auth --api-key YOUR_API_KEY       # Non-interactive (automation)
vulnx auth --test                       # Test current API key
export PDCP_API_KEY="your-key-here"     # Environment variable

인증 모드:

대화형: vulnx auth - 프롬프트를 통한 안내 설정
비대화형: vulnx auth --api-key KEY - 자동화/CI/CD에 적합
테스트 전용: vulnx auth --test - 현재 구성 검증

버전 관리:

vulnx version                            # Show version and check for updates
vulnx version --disable-update-check     # Show version without update check
vulnx update                             # Update to latest version
vulnx --update                           # Alternative update command

전역 옵션:

vulnx --json search "apache"              # JSON output
vulnx --silent search "apache"            # No banner
vulnx --timeout 60s search "apache"       # Custom timeout
vulnx --disable-update-check search "apache"  # Disable automatic update checks

문제 해결

속도 제한 문제:

Rate limit exceeded! API key required for higher limits.
→ Run: vulnx auth to configure API key and get higher limits

자동화/CI/CD 설정:

# Docker containers
vulnx auth --api-key "$SECRET_API_KEY"

# CI/CD pipelines
vulnx auth --api-key "${PDCP_API_KEY}"

# Kubernetes init containers
vulnx auth --api-key "$(cat /secrets/api-key)"

# Test authentication in scripts
vulnx auth --test && echo "Auth OK" || echo "Auth failed"

속도 제한 제안:

Configure API key with 'vulnx auth' to avoid rate limits
→ This appears when no API key is configured. To remove:
  1. Set up API key: vulnx auth
  2. Or use --silent flag to suppress informational messages

결과 없음:

vulnx search "is_kev:true" --limit 1      # Test with known results
vulnx healthcheck                       # Check connectivity

대용량 결과 세트:

vulnx search "apache" --limit 100         # Increase limit
vulnx search "apache" --offset 100        # Pagination
vulnx search --fields cve_id,severity "apache"  # Fewer fields

연결 문제:

vulnx --timeout 60s search "apache"       # Increase timeout
vulnx --proxy http://localhost:8080 search "apache"  # Use proxy
vulnx --debug search "apache"             # Debug mode

도움말 보기

도움말 명령어 (API 키 불필요):

vulnx --help                           # All commands overview
vulnx search --help                    # Search command help
vulnx id --help                        # ID command help
vulnx filters --help                   # Filters command help
vulnx analyze --help                   # Analyze command help
vulnx version                          # Version info with update check
vulnx version --disable-update-check   # Version info without update check

데이터 탐색 (API 키 없이는 속도 제한 적용):

vulnx filters                          # Show all searchable fields
vulnx search help                      # Detailed search fields
vulnx analyze help                     # Available analyze fields

⚠️ 참고 모든 명령어는 API 키 없이도 작동하지만 속도 제한이 적용됩니다. 더 높은 한도와 더 나은 성능을 위해 vulnx auth로 API 키를 구성하세요.

팁

즉시 시작: vulnx는 API 키 없이도 작동합니다. vulnx search apache를 실행하세요.
속도 제한 방지: 많은 사용량이 필요하면 vulnx auth로 API 키를 구성하세요.
최신 상태 유지: vulnx는 업데이트를 자동으로 확인합니다. 비활성화하려면 --disable-update-check를 사용하세요.
vulnx filters를 사용하여 모든 검색 필드와 구문을 확인하세요.
넓은 검색으로 시작한 다음 필터로 범위를 좁히세요.
스크립팅 및 자동화에는 --json을 사용하세요.
정확한 결과를 위해 여러 필터를 결합하세요.
데이터 패턴을 이해하려면 analyze를 사용하세요.
자주 사용하는 쿼리를 셸 별칭으로 저장하세요.

고급 사용 패턴과 예시는 USAGE.md를 참조하세요.

개발

개발 환경 설정, 코드 품질 검사 및 기여 지침은 DEVELOPMENT.md를 참조하세요.

라이선스

vulnx는 MIT License에 따라 배포됩니다.

`search`	고급 필터로 취약점 검색	`vulnx search "apache && severity:high"`
`id`	특정 CVE의 세부 정보 확인	`vulnx id CVE-2021-44228`
`filters`	사용 가능한 모든 검색 필드와 필터 나열	`vulnx filters`
`analyze`	필드별 데이터 집계	`vulnx analyze -f severity`
`auth`	API 접근 구성	`vulnx auth`
`version`	버전 정보 표시 및 업데이트 확인	`vulnx version`
`update`	vulnx를 최신 버전으로 업데이트	`vulnx update`
`healthcheck`	연결 상태 테스트	`vulnx healthcheck`

`--product`	`-p`	제품별 필터링	`--product apache,nginx`
`--vendor`		공급업체별 필터링	`--vendor microsoft,oracle`
`--severity`	`-s`	심각도별 필터링	`--severity critical,high`
`--tags`		태그별 필터링	`--tags rce,injection`
`--cvss-score`		CVSS 점수별 필터링	`--cvss-score ">8.0"`
`--epss-score`		EPSS 점수별 필터링	`--epss-score ">0.8"`
`--vuln-age`	`-a`	기간(나이)별 필터링	`--vuln-age "<30"`
`--vuln-type`		취약점 유형별 필터링	`--vuln-type sql_injection`
`--kev`		KEV 취약점만	`--kev`
`--template`	`-t`	Nuclei 템플릿 보유	`--template`
`--poc`		개념 증명(PoC) 보유	`--poc`
`--hackerone`		HackerOne 신고됨	`--hackerone`
`--remote-exploit`		원격 악용 가능	`--remote-exploit`
`--vuln-status`		취약점 상태별 필터링	`--vuln-status confirmed`

`--detailed`		'id'와 같은 상세 출력	`--detailed`
`--highlight`		검색 하이라이트 활성화	`--highlight`
`--limit`	`-n`	결과 수	`--limit 50`
`--offset`		페이지네이션 오프셋	`--offset 100`
`--sort-asc`		오름차순 정렬	`--sort-asc cvss_score`
`--sort-desc`		내림차순 정렬	`--sort-desc cve_created_at`
`--fields`		특정 필드 선택	`--fields cve_id,severity`
`--term-facets`		용어 패싯 계산	`--term-facets severity=5`
`--range-facets`		범위 패싯 계산	`--range-facets numeric:cvss_score:high:8:10`
`--facet-size`		패싯 버킷 수	`--facet-size 20`

`severity`	취약점 심각도	`low`, `medium`, `high`, `critical`
`cvss_score`	CVSS 점수 (0-10)	`7.5`, `>8.0`, `<9.0`
`cve_id`	CVE 식별자	`CVE-2021-44228`
`is_remote`	원격 악용 가능	`true`, `false`
`is_kev`	알려진 악용 취약점	`true`, `false`
`is_poc`	개념 증명(PoC) 보유	`true`, `false`
`affected_products.vendor`	공급업체 이름	`apache`, `microsoft`
`affected_products.product`	제품 이름	`tomcat`, `windows`
`cve_created_at`	공개 날짜	`>=2024`, `>2024-01-01`, `<2023`
`age_in_days`	공개 후 경과 일수	`<30`, `>365`, `<=90`

vulnx

인기

vulnx

취약점 데이터를 탐색하기 위한 강력한 검색, 필터링 및 분석 기능을 갖춘 최신 CLI

빠른 시작

vulnx가 하는 일

핵심 명령어

필수 옵션

사용 가능한 필드 탐색

일반적인 검색 패턴

필터 플래그

필터 플래그 참조

검색 제어 플래그

취약점 ID 조회

유용한 필드 이름

쿼리 구문

날짜 쿼리

구성

인증 (선택 사항)

문제 해결

도움말 보기

팁

개발

라이선스