mceeomoba/apex-kev-change-desk오프라인 CISA KEV 스냅샷 비교를 통한 필드 수준 변경 검토. 무료 프로토타입이며 보안 평가가 아님. AI 지원 개발.
IT 팀이 두 개의 CISA Known Exploited Vulnerabilities(KEV) JSON 스냅샷을 비교하기 위한 오프라인 변경 검토 프로토타입입니다. 추가, 제거 및 편집된 레코드를 보고하며, 변경된 모든 필드에 대해 정확한 변경 전/후 값을 포함합니다. 이는 데이터 검토 유틸리티이며, 보안 평가가 아닙니다.
무료 프로토타입. 고객, 유료 서비스 또는 수요 검증을 주장하지 않습니다. AI 지원으로 개발되었습니다. CISA와 제휴하거나 CISA의 보증을 받지 않았습니다.
아래의 합성 예제를 실행하거나, 저장된 두 개의 공개 카탈로그 스냅샷을 비교하세요. 워크플로 피드백 공유: 어떤 검토 작업을 완료하려고 했으며, 이 도구가 수동 단계를 제거했나요? 피드백은 공개되며 GitHub 신원이 노출됩니다. 비공개 자산 인벤토리, 고객 이름, 자격 증명 또는 사고 세부 정보를 포함하지 마세요. Apex 프로젝트를 위해 게시되었으며, AI 지원 프로토타입 및 피드백 수집입니다. 유료 파일럿이나 응답 시간 약속은 없습니다.
입력 제한: 소수 및 지수 형식의 JSON 숫자는 거부되며, 확장 필드에서도 마찬가지입니다. 정수 숫자는 정확하게 유지됩니다. 향후 스키마가 작동한다고 보장되지 않습니다. 이 제한을 우회하기 위해 소스 값을 수정하지 마세요.
Python 3.10 이상. 표준 라이브러리만 사용. 계정이나 설치가 필요하지 않습니다.
python3 kev_diff.py examples/before.json examples/after.json > review.json
python3 kev_diff.py examples/before.json examples/after.json --vendor 'Example Vendor' > vendor-review.json
python3 kev_diff.py examples/before.json examples/after.json --format markdown > review.md
python3 -m unittest discover -s tests -v
예제 카탈로그는 합성 데이터이며, 현재의 취약점 피드가 아닙니다. 이는 하나의 추가, 하나의 편집된 레코드, 하나의 제거를 보여줍니다. 편집된 레코드는 마감일과 알 수 없는 확장 필드를 변경합니다. 백그라운드에서 실행되는 것은 없습니다.
실제 데이터의 경우, CISA 카탈로그 또는 공식 미러에서 연속적인 JSON 스냅샷을 직접 다운로드하여 보관하십시오. 출처와 다운로드 날짜를 확인하십시오. 이전 스냅샷을 먼저 전달하십시오. 이 도구는 소스를 가져오거나, 진위를 확인하거나, 카탈로그가 완전한지 판단하거나, 최신이라고 주장하지 않습니다. 파일 SHA-256 값은 재현성을 지원할 뿐, 인증을 지원하지 않습니다.
체크아웃에서 python3 -B scripts/verify_release.py를 실행하십시오. 이는 번들된 합성 테스트를 실행하고, JSON 및 Markdown 예제를 번들된 예상 출력과 비교하며, 잘못된 중복 키 입력이 보고서를 생성하지 않는지 확인합니다. 발견된 테스트가 없으면 실패합니다. 종료 코드 0은 이러한 수용 검사가 통과되었음을 의미하고, 종료 코드 1은 실패를 의미합니다. 데이터를 가져오지 않고 JSON 요약과 나열된 core/example 및 지원 파일의 해시를 출력합니다. 임시 잘못된 입력 파일은 운영 체제의 임시 디렉터리에서 생성되고 제거됩니다. 번들된 러너/테스트는 의도적으로 체크아웃을 편집하지 않습니다. -B는 일반적인 바이트코드 쓰기를 방지합니다.
이는 체크아웃의 Python 코드(테스트 포함)를 실행합니다. 실행하기 전에 해당 코드를 검사하고 신뢰하십시오. 검사 통과와 파일 해시는 보안 감사, 소프트웨어 서명, 소스 진위 증명, 노출 평가 또는 고객의 증거가 아닙니다. 출력을 소스 또는 예제 파일로 리디렉션하지 마십시오.
JSON이 기본값입니다. --format markdown은 카운트, 스냅샷 출처, 제한, 메타데이터 변경 사항, 그리고 일치하는 변경에 대한 각각의 완전한 before/after 레코드를 포함한 사람이 읽을 수 있는 리뷰를 생성합니다. 이는 분석을 추가하거나 비교를 변경하지 않습니다. 소스 값은 JSON 코드 블록에 유지됩니다. 동적으로 크기가 조정되는 펜스는 일반적인 Markdown 렌더러(모든 뷰어는 아님)에서 내장된 백틱이 해당 블록을 벗어나는 것을 방지합니다. 신뢰하는 뷰어에서 Markdown을 여십시오. 공유하기 전에 보고서를 검토하십시오. 일치하는 변경에 대한 전체 before/after 레코드, 메타데이터 변경 사항 및 벤더 필터가 포함됩니다. 이 선택적 형식을 위해 markdown_report.py를 kev_diff.py와 함께 유지하십시오.
added: 제공된 after 파일에만 존재하는 CVE ID.removed: before 파일에만 존재하는 CVE ID. 수정 또는 안전의 증거가 아닙니다. 부분적인 after 파일은 많은 겉보기 제거를 초래할 수 있습니다.changed: 적어도 하나의 레코드 필드가 다릅니다. Before 및 after 값, 필드 존재 플래그 및 전체 레코드가 유지됩니다.--vendor는 두 스냅샷 중 하나에 대해 vendorProject에 대한 정확하고 대소문자를 구분하지 않는 일치입니다. 퍼지 매칭이나 설치된 제품 감지가 아닙니다. 이를 생략하면 제공된 전체 카탈로그를 비교합니다.출력을 어느 입력 파일로도 리디렉션하지 마십시오. 예를 들어, > before.json은 Python이 읽기 전에 해당 소스를 잘라냅니다. 새 출력 파일 이름을 사용하십시오.
종료 코드 0은 변경 없음 결과를 포함하여 유효한 비교가 생성되었음을 의미합니다. 종료 코드 2는 잘못된 입력 또는 파일 오류를 의미하며, 프로그램에서 보고서가 생성되지 않습니다. 셸 리디렉션을 사용하는 경우, 셸이 오류 시에도 빈 출력 파일을 생성할 수 있으므로 이전 보고서를 교체하기 전에 종료 코드를 확인하십시오.
모든 파일 처리는 로컬에서 이루어집니다. 네트워크 요청, 텔레메트리, 스토리지 계정, 자동 알림, 스캐닝, 익스플로잇, 리메디에이션 또는 스토어 통합은 없습니다. 저장한 파일은 사용자의 기기에 남습니다. 보고서에는 제공된 레코드와 벤더 필터가 포함되므로 공유 전에 검토하십시오. 최대 입력 크기는 파일당 20 MB입니다. 잘못된 UTF-8, 중복 JSON 키/ID, 잘못된 날짜, 개수 불일치 및 역순 릴리스 타임스탬프는 거부됩니다. 알 수 없는 필드는 스키마 검증 없이 보존됩니다. 스냅샷 어디에 있든 소수점 및 지수 형식의 JSON 숫자는 확장 필드를 포함하여 명시적으로 거부되며, 이는 값을 조용히 반올림하는 것을 방지하기 위함입니다. 정수 JSON 숫자는 정확하게 유지됩니다. 이 제한을 우회하기 위해 소스 값을 수정하지 마십시오. 이는 정확성을 위해 전방 호환성을 포기하는 것입니다. 소수점/지수 값을 가진 향후 공식 피드는 지원이 추가될 때까지 거부됩니다. 필수 필드는 현재 공식 스키마를 따르지만, 이는 완전한 JSON Schema 구현이 아닙니다.
v0.1.1은 45개의 합성 테스트를 통과했으며, v0.1.0에는 43개가 포함되었습니다. 2026년 10월 14일, 프로토타입은 catalogVersion 2026.10.13, 1,741개 항목 및 dateReleased 2026-10-13T19:10:43.6568Z가 있는 공식 미러 스냅샷을 로드했습니다. 해당 스냅샷을 자기 자신과 비교한 결과 레코드 변경은 0건이었습니다. 이는 해당 단일 스냅샷에 대한 입력 호환성만을 증명하며, 진위성, 노출 또는 두 개의 연속된 실제 피드의 올바른 처리를 증명하지는 않습니다. 해당 스냅샷의 SHA-256은 136904f12e4c6762e526352e3a67ed7b28cd21b4d82bed9c91719ff2e94f2f28이었습니다.
CISA는 이미 무료 카탈로그를 제공합니다. 공식 저장소 README는 대화형 커밋 변경 대시보드를 링크합니다. 다른 오픈소스 diff 및 모니터링 도구도 존재합니다. 이 프로토타입은 좁은 범위의 오프라인, 필드 수준 검토 워크플로를 탐구합니다. 독점 시장, 판매자 검증, 보안 인증, 유료 알림 서비스 또는 지불 의향에 대한 주장은 하지 않습니다. 향후 관리형 제공 또는 유료 제품은 별도의 검증과 운영 통제가 필요할 것입니다.
프로토타입 소스 코드: MIT, LICENSE 참조. CISA 로고, 인장 또는 보증은 사용되지 않습니다.
v0.1.0은 +00:60과 같은 잘못된 형식의 dateReleased 오프셋 구성 요소를 허용했습니다. v0.1.1은 비교 전에 이를 거부합니다. 취약점/노출 또는 변경된 유효 오프셋 결과에 대한 주장은 없습니다. 오프셋 시간은 00-23, 분은 00-59여야 합니다. -00:00은 정렬을 위해 0으로 정규화되며, 원래 타임스탬프 문자열은 보고서에 남습니다. 이는 소스의 시간대 지식에 대한 주장이 아닙니다.
v0.1.1 소스에는 45개의 합성 테스트가 포함되어 있습니다(v0.1.0에는 43개 포함). 검사는 감사나 소스 진위성, 완전성, 노출 또는 수요의 증명이 아닙니다.