# 저장소 클론
git clone https://github.com/tjnel/certgraveyard_yara.git
cd certgraveyard_yara

# UV로 설치
uv sync --all-extras

# CertGraveyard에서 최신 CSV 다운로드
cert-graveyard-yara download

# CSV 변경 여부 확인
cert-graveyard-yara check-changed

# YARA 규칙 생성
cert-graveyard-yara generate

# 규칙 검증
cert-graveyard-yara validate --engine yara

# 결합 파일 및 ZIP 아카이브 생성
cert-graveyard-yara combine
cert-graveyard-yara package

# 전체 파이프라인 실행
cert-graveyard-yara run --all

# 결합 규칙 세트로 스캔
yara rules/combined/MAL_Compromised_Cert_*.yara /path/to/scan

# 또는 개별 규칙 사용
yara rules/individual/*.yara /path/to/scan

cert-graveyard-yara/
├── .github/workflows/      # GitHub Actions
│   ├── daily-update.yml    # 일일 CSV 확인 및 규칙 생성
│   ├── ci.yml              # PR 검증 및 테스트
│   └── release.yml         # 릴리스 생성
├── src/cert_graveyard_yara/  # 소스 코드
│   ├── __init__.py
│   ├── downloader.py       # CSV 다운로드 및 캐싱
│   ├── parser.py           # CSV 파싱
│   ├── generator.py        # YARA 규칙 생성
│   ├── validator.py        # 규칙 검증
│   ├── changelog.py        # 변경 로그 관리
│   └── cli.py              # 명령줄 인터페이스
├── tests/                  # 테스트 스위트
├── rules/
│   ├── individual/         # 개별 YARA 규칙 파일
│   └── combined/           # 결합 릴리스 파일
├── data/                   # CSV 데이터 및 해시 파일
├── templates/              # Jinja2 템플릿
└── CHANGELOG.md

import "pe"

rule MAL_Compromised_Cert_Emotet_DigiCert_0a_1b_2c_3d {
   meta:
      description         = "손상된 인증서를 사용하는 악성코드 Emotet 탐지..."
      author              = "TNEL (https://github.com/tjnel/certgraveyard_yara)"
      reference           = "https://certgraveyard.org"
      
      hash                = "a1b2c3d4..."
      malware             = "Emotet"
      malware_type        = "Trojan"
      
      cert_issuer         = "DigiCert SHA2 Assured ID Code Signing CA"
      cert_serial         = "0a:1b:2c:3d"
      cert_valid_from     = "2024-01-15"
      cert_valid_to       = "2025-01-15"

   condition:
      uint16(0) == 0x5a4d and
      for any sig in pe.signatures : (
         sig.issuer contains "DigiCert SHA2 Assured ID Code Signing CA" and
         sig.serial == "0a:1b:2c:3d"
      )
}

# 개발 종속성과 함께 설치
uv sync --all-extras

# 린트 실행
uv run ruff check src tests

# 타입 검사 실행
uv run mypy src

# 테스트 실행
uv run pytest

# 모든 테스트를 커버리지와 함께 실행
uv run pytest

# 특정 테스트 파일 실행
uv run pytest tests/test_generator.py

# 상세 출력과 함께 실행
uv run pytest -v