Skip to content
KitploitKITPLOIT
도구익스플로잇블로그
Log in
제출
도구익스플로잇블로그
제출

해킹, 침투 테스트 및 사이버 보안 도구를 당신의 보안 무기고에!

Kitploit은 해킹, 사이버 보안 및 침투 테스트 도구 디렉토리입니다. 최신 프로젝트 업데이트를 발견하여 취약점을 찾고, 시스템을 분석하고, 테스트를 자동화하고, 보안을 강화하세요.

피드문의개인정보© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
CVE-2021-44228 — log4j 완화 작업 | Kitploit
도구/GitHubGitHub/axisops/cve-2021-44228
Vulnerability ScannersVulnerability AnalysisScripting & AutomationConfiguration AuditingDevSecOpsMisconfiguration
GitHubaxisops/cve-2021-44228

CVE-2021-44228

log4j 완화 작업

저장소 보기
2619일 전아직 검토되지 않음
공유

Log4Shell CVE-2021-44228 완화 Ansible Role

이 Ansible role은 영향을 받는 Log4j JAR 파일에서 취약한 JndiLookup 클래스를 제거하여 Log4Shell 취약점(CVE-2021-44228)을 프로그래밍 방식으로 완화하는 Python 기반 스크립트를 배포합니다.

Ansible을 통해 실행하도록 설계되었지만, 원한다면 스크립트를 수동으로 실행할 수도 있습니다.

Log4Shell 취약점에 대한 자세한 내용은 다음을 참조하세요:

  • Wikipedia
  • NVD CVE-2021-44228
  • Our Twitter Thread

기능

  • 지정된 애플리케이션 디렉터리에서 .jar, .war, .ear 파일을 검색합니다
  • JndiLookup.class가 존재하는지 확인합니다
  • 수정 전에 원본 아카이브를 백업하며, 전체 경로를 그대로 반영하여 백업 디렉터리 아래에 저장하므로 서로 다른 서비스에 있는 동일한 이름의 JAR이 서로를 덮어쓰지 않습니다
  • Python의 zipfile을 사용하여 JndiLookup.class를 제거합니다
  • 패치할 수 없는 중첩 아카이브(WAR 또는 EAR 내부의 JAR, 또는 Spring Boot fat JAR)를 조용히 건너뛰지 않고 이름으로 보고합니다
  • 기본값은 드라이 런입니다. --apply 없이 스크립트는 모든 아카이브를 읽기 전용으로 열고 여전히 JndiLookup.class를 포함하는 아카이브를 보고합니다. 백업이나 재작성은 수행되지 않습니다. role은 log4shell_apply: false가 아닌 한 --apply를 전달합니다
  • 모든 작업을 로그 파일에 기록하고 요약을 stdout에 출력합니다
  • 스크립트 기준 상대 경로로 해석되는 YAML 파일을 통해 구성할 수 있습니다
  • 여러 시스템에 자동 배포할 수 있도록 Ansible role로 패키징되어 있습니다

요구 사항

  • Python 3.9+
  • PyYAML, YAML 구성 파일을 읽는 실행(설치된 apply)에만 필요합니다. role은 배포판(python3-yaml, py3-yaml 또는 python3-pyyaml)에서 설치하며, PyPI에서는 절대 설치하지 않습니다. 탐지 엔트리는 표준 라이브러리만 필요합니다. 구성은 JSON으로 stdin을 통해 전달됩니다

zip이나 zipinfo는 필요하지 않습니다. 아카이브는 표준 라이브러리의 zipfile로 읽고 재작성되며, 이는 둘 다 설치되지 않은 최소 컨테이너 베이스 이미지에서 중요합니다.

구성

스크립트는 role에 의해 자동으로 템플릿화되는 YAML 파일을 통해 구성됩니다.

config.yaml 예시:

app_directories:
  - /opt/apps
backup_directory: /opt/backups
log_file: /var/log/log4j_mitigation.log
  • app_directories: JAR 파일을 검색할 디렉터리 목록
  • backup_directory: 원본 JAR 백업을 저장할 위치
  • log_file: 작업 추적을 위한 로그 파일 경로

Ansible Role로 사용하기

이 role을 playbook에 추가하세요:

- name: Mitigate Log4Shell CVE-2021-44228
  hosts: all
  become: true
  roles:
    - log4shell_mitigation

직접 사용

스크립트를 수동으로 실행하려면 다음과 같이 하면 됩니다:

  1. 스크립트와 그 옆에 있는 공유 라이브러리를 대상 머신에 복사합니다:

    files/log4shell_mitigator.py
    files/samp_common.py
    
  2. 같은 디렉터리에 자신만의 config.yaml을 생성하세요.

  3. 실행하세요:

    python3 log4shell_mitigator.py                  # dry run, config.yaml beside the script
    python3 log4shell_mitigator.py --config /path/to/config.yaml
    sudo python3 log4shell_mitigator.py --apply     # back up and rewrite
    

검증

  • 스크립트는 scanned=N vulnerable=N patched=N already_stripped=N unreadable=N failed=N nested_needing_review=N dry_run=N을 stdout에 출력합니다. vulnerable은 여전히 JndiLookup.class를 포함하는 아카이브 수를 세고, already_stripped는 해당 클래스가 없는 log4j-core 아카이브 수를 셉니다. nested_needing_review 또는 unreadable이 0이 아니면 해당 아카이브는 판정되지 않은 것이므로 수동으로 처리해야 하며, 로그에 각각의 이름이 기록됩니다.
  • 종료 코드: 0 해당 클래스를 포함한 것이 남아 있지 않음, 2 아카이브가 여전히 해당 클래스를 포함하거나 판정할 수 없음, 1 백업 또는 재작성 실패, 130 중단됨
  • 구성된 로그 파일(기본값: /var/log/log4j_mitigation.log)을 확인하여 어떤 JAR이 패치되었는지 확인하십시오
  • 클래스 제거 후에도 애플리케이션이 정상적으로 시작되는지 확인하십시오
  • 애플리케이션이 깨지면 백업 디렉터리에서 복원하십시오. 백업은 원래 경로를 그대로 반영하므로 필요한 파일은 원래 있던 위치에 있습니다
  • 이상적으로는 프로덕션 배포 전에 스테이징 환경에서 테스트하십시오

참고 사항

  • 이 접근 방식은 Log4j를 업그레이드하지 않고 취약한 클래스를 제거하여 익스플로잇 경로를 차단합니다
  • 장기적인 해결책으로서 여전히 Log4j를 업그레이드해야 합니다
  • 중첩 아카이브는 패치되지 않습니다. EAR 안의 WAR 안의 JAR을 재작성하는 것은 재귀적 재패키징이며, 이를 잘못 처리하면 애플리케이션이 시작되지 않습니다. 스크립트는 해당 아카이브의 이름을 알려주므로 의도적으로 처리할 수 있습니다.
  • 광범위하게 배포하기 전에 항상 철저히 테스트하십시오

Substrate Ansible Mitigation Pack (SAMP)

이 저장소는 SAMP입니다. Microcelium Substrate가 이 정확한 URL에서 가져와 커밋으로 고정하고, 릴리스 태그의 서명을 검증하고, 스캔한 뒤, 어디서든 실행되기 전에 사람의 승인을 받습니다.

  • 매니페스트. samp.yaml은 CVE, 적용 대상 호스트, 탐지 및 적용 진입점, 각각의 root 필요 여부, 기본값이 있는 옵션, apply가 쓰는 모든 경로(touches), 실행하는 모든 프로그램(commands) 및 재시작할 수 있는 유닛을 선언합니다. 검토자는 이를 먼저 읽고, substrate는 코드를 이와 대조하여 검사합니다.

  • 탐지는 아무것도 쓰지 않습니다. tasks/detect.yml은 스크립트와 samp_common.py를 비공개 임시 디렉터리에 배치하고, 구성은 stdin으로 JSON, 로그는 stdout으로 하여 실행한 뒤 디렉터리를 제거합니다. 스크립트가 설치되지 않고, 구성이 템플릿화되지 않으며, 백업 디렉터리가 생성되지 않고, 로그 파일이 작성되지 않으며, 패키지가 설치되지 않습니다. 읽기만 하므로 ansible-playbook --check에서도 실행됩니다.

  • 적용. log4shell_apply: true와 함께 tasks/main.yml을 사용합니다. 옵션:

    • 없음

    옵션에서 명시하지 않는 한 아무것도 재시작되거나 다시 로드되지 않으며, 아무것도 되돌려지지 않습니다. 다운그레이드는 취약점을 다시 초래합니다.

  • 결과. stdout의 스크립트 마지막 줄은 SAMP-RESULT {"format":1,"verdict":…,"counters":{…},"backups":[…],…}이며, 이는 사람이 읽는 key=N 요약 줄 다음에 나옵니다. 판정은 vulnerable, no_fix, unknown, fixed(수정된 패키지가 아닌 우회 조치가 적용 중일 때는 "workaround":true 포함), not_affected, 또는 failed 중 하나입니다.

  • 종료 코드. 0 정상(fixed, not_affected), 2 취약 또는 미결정 (vulnerable, no_fix, unknown: 절대 정상 아님), 1 실행 자체 실패, 130 중단됨.

  • 공유 코드. log4shell_mitigation/files/samp_common.py는 samp-common 1.0.3(dpkg, rpm 및 apk 버전 비교, 결과 줄, 구성 로딩)의 바이트 단위 복사본입니다. 해당 sha256은 samp.yaml에 있으며, 복사본이 다르면 tests/test_samp_pack.py가 실패합니다. 여기서는 절대 편집하지 마십시오. samp-common의 scripts/vendor.py로 다시 벤더링하십시오.

  • 릴리스는 SSH 서명된 주석 태그 samp/v<version>(이번 것은 samp/v1.0.3)이며, 하드웨어 기반 키로 서명됩니다. substrate는 브랜치가 아닌 서명된 태그를 가져옵니다.

라이선스

MIT

기여

PR과 개선 사항을 환영합니다 -> 포크한 뒤 병합 요청을 제출해 주십시오.


면책 조항

이 소프트웨어와 함께 제공되는 Ansible 역할은 "있는 그대로" 제공되며, 명시적이든 묵시적이든 어떠한 종류의 보증도 제공하지 않습니다. 이 코드를 어떤 환경에 적용하기 전에 그 적합성, 안전성, 효과성을 평가하고 테스트하는 것은 전적으로 귀하의 책임입니다. AxisOps Ltd (GB08681761)는 이 코드의 사용 또는 오용으로 인해 발생하는 손해, 데이터 손실, 서비스 중단 또는 기타 피해에 대해 어떠한 책임도 명시적으로 부인합니다.

사용에 따른 위험은 귀하의 책임입니다. 프로덕션에 배포하기 전에 항상 통제된 환경에서 코드를 감사하고, 테스트하고, 검증하십시오.


SysOps Team @ AxisOps

도구 다운로드

인기

모두 보기 →

커뮤니티에서 가장 많이 사용되는 도구를 찾아보세요.

아직 인기 데이터가 없습니다.

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →