PortEx

PortEx에 오신 것을 환영합니다

PortEx는 Portable Executable 파일의 정적 악성코드 분석을 위한 Java 라이브러리입니다. PE 변형 내성 및 이상 탐지에 중점을 둡니다. PortEx는 Java와 Scala로 작성되었으며 Java 애플리케이션을 대상으로 합니다.

기능

• MSDOS 헤더, COFF 파일 헤더, 옵셔널 헤더, 섹션 테이블에서 헤더 정보 읽기
• PE 구조 읽기: 임포트, 리소스, 익스포트, 디버그 디렉토리, 재배치, 지연 로드 임포트, 바운드 임포트
• 섹션, 리소스, 오버레이, 임베디드 ZIP, JAR 또는 .class 파일 덤핑
• 구조적 이상, 사용 중단, 예약, 잘못된 또는 기본값이 아닌 값을 포함한 파일 형식 이상 탐색
• 가변 색상 및 크기로 PE 파일 구조, 로컬 엔트로피 및 바이트플롯 시각화
• 파일 및 섹션에 대한 섀넌 엔트로피 및 카이제곱 계산
• 파일 및 섹션에 대한 ImpHash, Rich 및 RichPV 해시 값 계산
• RichHeader 파싱 및 체크섬 검증
• 옵셔널 헤더 체크섬 계산 및 검증
• PEiD 시그니처, 내부 파일 유형 시그니처 또는 자체 시그니처 데이터베이스 스캔
• Jar to EXE 래퍼 스캔 (예: exe4j, jsmooth, jar2exe, launch4j)
• 파일에 포함된 유니코드 및 ASCII 문자열 추출
• 리소스 섹션의 아이콘에서 .ICO 파일 추출 및 변환
• 파일에서 버전 정보 및 매니페스트 추출
• .NET 메타데이터 및 스트림 읽기 (알파)

자세한 내용은 PortEx Wiki 및 문서를 참조하세요.

PortexAnalyzer CLI 및 GUI

PortexAnalyzer CLI는 내부적으로 PortEx 라이브러리를 실행하는 명령줄 도구입니다.

즉시 사용 가능한 명령줄 PE 스캐너를 찾고 계신다면 여기에서 최신 버전을 찾을 수 있습니다 PortexAnalyzer.jar

CLI 도구의 장기 릴리스 버전은 릴리스 페이지에 있습니다.

GUI 버전은 여기에서 사용 가능합니다: PortexAnalyzerGUI

PortEx 사용하기

Maven 프로젝트에 PortEx 포함하기

다음 Maven 의존성을 추가하여 프로젝트에 PortEx를 포함할 수 있습니다:

<dependency>
   <groupId>io.github.struppigel</groupId>
   <artifactId>portex_2.12</artifactId>
   <version>5.0.6</version>
</dependency> 

로컬 빌드를 사용하려면 다음과 같이 라이브러리를 추가하세요:

<dependency>
   <groupId>io.github.struppigel</groupId>
   <artifactId>portex_2.12</artifactId>
   <version>5.0.6</version>
   <scope>system</scope>
   <systemPath>$PORTEXDIR/target/scala-2.12/portex_2.12-5.0.6.jar</systemPath>
</dependency> 

SBT 프로젝트에 PortEx 포함하기

build.sbt에 다음과 같이 의존성을 추가하세요:

libraryDependencies += "io.github.struppigel" % "portex_2.12" % "5.0.6"

PortEx 빌드하기

요구사항

PortEx는 sbt로 빌드됩니다.

sbt로 컴파일 및 빌드

프로젝트를 간단히 컴파일하려면 다음을 실행하세요:

$ sbt compile

jar를 생성하려면:

$ sbt package

명령줄 도구로 사용할 수 있는 fat jar를 컴파일하려면 다음을 입력하세요:

$ sbt assembly

Eclipse 프로젝트 생성

sbteclipse 플러그인을 사용하여 Eclipse 프로젝트를 생성할 수 있습니다. project/plugins.sbt에 다음 줄을 추가하세요:

addSbtPlugin("com.typesafe.sbteclipse" % "sbteclipse-plugin" % "2.4.0")

Eclipse용 프로젝트 파일 생성:

$ sbt eclipse

Import Wizard를 통해 Eclipse로 프로젝트를 가져오세요.

후원

저는 여가 시간에 취미로 PortEx와 PortexAnalyzer를 개발합니다. 마음에 드신다면 커피 한 잔 사주시는 것을 고려해 주세요: https://ko-fi.com/struppigel

저자

Karsten Hahn

Twitter/X: @Struppigel

Mastodon: [email protected]

Bluesky: https://bsky.app/profile/struppigel.bsky.social

Youtube: MalwareAnalysisForHedgehogs

라이선스

Apache License, Version 2.0