
log4j 완화 작업
이 Ansible role은 영향을 받는 Log4j JAR 파일에서 취약한 JndiLookup 클래스를 제거하여 Log4Shell 취약점(CVE-2021-44228)을 프로그래밍 방식으로 완화하는 Python 기반 스크립트를 배포합니다.
Ansible을 통해 실행하도록 설계되었지만, 원한다면 스크립트를 수동으로 실행할 수도 있습니다.
Log4Shell 취약점에 대한 자세한 내용은 다음을 참조하세요:
.jar, .war, .ear 파일을 검색합니다JndiLookup.class가 존재하는지 확인합니다zipfile을 사용하여 JndiLookup.class를 제거합니다--apply 없이 스크립트는 모든 아카이브를
읽기 전용으로 열고 여전히 JndiLookup.class를 포함하는 아카이브를
보고합니다. 백업이나 재작성은 수행되지 않습니다. role은
log4shell_apply: false가 아닌 한 --apply를 전달합니다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: 작업 추적을 위한 로그 파일 경로이 role을 playbook에 추가하세요:
- name: Mitigate Log4Shell CVE-2021-44228
hosts: all
become: true
roles:
- log4shell_mitigation
스크립트를 수동으로 실행하려면 다음과 같이 하면 됩니다:
스크립트와 그 옆에 있는 공유 라이브러리를 대상 머신에 복사합니다:
files/log4shell_mitigator.py
files/samp_common.py
같은 디렉터리에 자신만의 config.yaml을 생성하세요.
실행하세요:
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이 패치되었는지 확인하십시오이 저장소는 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