
libpff
Outlook 파일 형식을 위한 오픈 소스 C 라이브러리
무료 오픈 소스 C API를 통해 PST, OST, PAB 및 OFF 파일에서 데이터를 읽고, 구문 분석하며, 추출합니다.
libpff란 무엇인가요?
libpff는 Microsoft Outlook에서 사용하는 개인 폴더 파일(PFF) 및 오프라인 폴더 파일(OFF) 형식에 접근하도록 설계된 강력한 오픈 소스 C 라이브러리입니다. 이 라이브러리를 사용하면 개발자가 PST, OST, PAB 및 OFF 파일에 저장된 이메일, 연락처, 일정 항목 및 기타 데이터를 프로그래밍 방식으로 읽고, 구문 분석하고, 추출할 수 있습니다. 이 라이브러리는 32비트 ANSI와 64비트 Unicode 문자열 인코딩을 모두 지원하며, Outlook 2013에 도입된 4K 페이지 DEFLATE 압축 OST 파일과 같은 압축 형식도 지원합니다. 견고한 파싱 엔진을 갖춘 libpff는 디지털 포렌식, 이메일 마이그레이션 및 데이터 복구 워크플로우에서 특히 유용합니다.
이 라이브러리는 LGPL-3.0-or-later 라이선스 하에 활발히 유지 관리되고 있으며 현재 알파 상태에 있어 기능은 동작하지만 생산 환경에서 사용하기 위한 완전한 기능 구현이나 안정성이 부족할 수 있습니다. 항목 복구 도구를 포함하고 있으며 암호화 유형이 없는 손상된 또는 암호화된 파일을 처리할 수 있습니다. libpff는 MAPI 정의를 위한 libfmapi와 같은 관련 프로젝트와도 통합되며 복잡한 Outlook 파일 구조를 분석하는 데 도움이 되는 상세한 포렌식 문서를 제공합니다. 개발자는 소스에서 빌드하거나 사전 컴파일된 바이너리를 사용할 수 있으며, 프로젝트는 GitHub에 호스팅되어 커뮤니티 기여 및 이슈 추적이 가능합니다.
libpff 시작하기
libpff를 사용하려면 공식 [libpff GitHub](https://github.com/libyal/libpff) 저장소에서 소스 코드를 복제하고 CMake 또는 autotools를 사용하여 빌드할 수 있습니다. 사전 컴파일된 바이너리는 공식적으로 배포되지 않으므로 소스에서 빌드하는 것이 권장되는 방법입니다. 이 프로젝트에는 libyal/libcerror 및 libyal/libcdata와 같은 종속성을 포함한 자세한 빌드 지침이 포함되어 있습니다. 빌드가 완료되면 제공된 명령줄 도구(예: `pffexport`, `pffinfo`)를 사용하여 PST/OST 파일의 데이터를 검사하고 추출할 수 있습니다. 프로그래밍적으로 사용하려면 C/C++ 애플리케이션에서 컴파일된 라이브러리를 링크하십시오. 이 라이브러리는 가볍고 외부 종속성이 최소라서 임베디드 또는 포렌식 환경에 적합합니다.
소스 빌드를 통해 libpff 설치
git clone https://github.com/libyal/libpff.git
cd libpff
./configure
make
sudo make install
PST 파일에서 이메일 및 첨부 파일 추출
libpff는 PST 파일을 구문 분석하고 개별 이메일 메시지와 해당 첨부 파일을 추출하는 강력한 기능을 제공합니다. 개발자는 폴더 계층 구조를 탐색하고, 메시지 속성(예: 제목, 발신자, 수신자, 타임스탬프)에 접근하며, 원시 MIME 콘텐츠 또는 구조화된 데이터를 내보낼 수 있습니다. 이 라이브러리는 ANSI와 Unicode 문자열 인코딩을 모두 지원하여 1990년대부터 최신 버전까지의 Outlook과 호환성을 보장합니다. 또한 최신 Outlook 버전에서 흔히 사용되는 압축된 OST 파일(4K 페이지 DEFLATE)도 처리합니다. 이러한 이유로 libpff는 이메일 마이그레이션 도구, 전자증거 발견 플랫폼 및 포렌식 분석에 이상적이며, 메시지 본문과 첨부 파일을 정확하게 추출하는 것이 중요합니다. API는 MAPI 속성에 대한 저수준 접근을 제공하여 데이터 검색에 대한 세밀한 제어를 가능하게 합니다.
C API를 사용하여 PST 파일에서 이메일을 추출하는 방법?
pff_file_t *pff_file = NULL;
pff_error_t *error = NULL;
if (pff_file_open(&pff_file, "example.pst", PFF_OPEN_READ, &error) != 1) {
// handle error
}
pff_item_t *root_item = NULL;
if (pff_file_get_root_item(pff_file, &root_item, &error) != 1) {
// handle error
}
// Iterate over items and extract messages
pff_item_t *item = NULL;
while (pff_item_get_sub_item(root_item, &item, &error) == 1) {
// Process each item (e.g., folder or message)
pff_item_free(&item, NULL);
}
pff_item_free(&root_item, NULL);
pff_file_close(pff_file, &error);
손상된 Outlook 파일에 대한 포렌식 분석
libpff는 손상되었거나 부분적으로 손상된 Outlook 파일에 대한 포렌식 분석을 위한 특수 기능을 포함합니다. 누락되었거나 일관성이 없는 헤더가 있는 파일을 구문 분석하고, 고아가 된 항목을 복구하며, 내부 인덱스가 손상된 경우에도 메시지 트리를 재구성할 수 있습니다. 이 라이브러리는 암호화 유형이 "none"인 파일을 지원하며, 사용 가능한 데이터를 추출하기 위해 특정 구조적 오류를 우회할 수 있습니다. 이는 증거가 저하된 PST/OST 파일에 존재할 수 있는 디지털 포렌식 조사에서 특히 가치가 있습니다. libpff는 또한 상세한 로깅 및 오류 보고를 제공하여 분석가가 구문 분석 결정과 데이터 손실 지점을 추적할 수 있게 합니다. MAPI 속성 추출과 결합하여, libpff는 법적 및 규정 준수 표준을 충족하는 포렌식 도구를 구축하기 위한 신뢰할 수 있는 기반을 제공합니다.
손상된 PST 파일에서 항목을 복구하는 방법?
pff_file_t *pff_file = NULL;
pff_error_t *error = NULL;
// Open with recovery mode (if supported)
if (pff_file_open_recover(&pff_file, "corrupted.pst", PFF_OPEN_READ, &error) != 1) {
// fallback to standard open
pff_file_open(&pff_file, "corrupted.pst", PFF_OPEN_READ, &error);
}
// Use item recovery functions
pff_item_t *recovered_item = NULL;
if (pff_file_get_recovered_item(pff_file, &recovered_item, &error) == 1) {
// Process recovered item
pff_item_free(&recovered_item, NULL);
}
pff_file_close(pff_file, &error);
MAPI 속성 및 메타데이터 파싱
libpff는 Outlook 항목에 포함된 MAPI 속성을 깊이 있게 검사할 수 있게 합니다. 개발자는 `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME`와 같은 표준 속성 및 애플리케이션에서 정의한 사용자 지정 속성을 검색할 수 있습니다. 이 라이브러리는 메시지, 폴더 또는 첨부 파일의 모든 속성을 반복할 수 있는 속성 집합 API를 제공합니다. 이는 규정 준수 감사, 메타데이터 추출 또는 MAPI 기반 시스템과의 통합이 필요한 애플리케이션에 필수적입니다. libpff는 명명된 식별자와 숫자 식별자 모두를 지원하며, 32비트 및 64비트 값 유형(예: 문자열, 정수, 바이너리 블롭)도 처리합니다. libfmapi와의 긴밀한 통합을 통해 MAPI 정의를 정확하게 해석할 수 있어 고급 Outlook 데이터 분석 도구를 구축하는 데 적합합니다.
메시지 항목에서 MAPI 속성을 추출하는 방법?
pff_item_t *message_item = NULL;
pff_property_t *property = NULL;
pff_error_t *error = NULL;
// Assume message_item is obtained from traversal
while (pff_item_get_property(message_item, &property, &error) == 1) {
uint32_t property_tag = 0;
uint32_t property_type = 0;
const uint8_t *value_data = NULL;
size_t value_data_size = 0;
pff_property_get_tag(property, &property_tag, &error);
pff_property_get_type(property, &property_type, &error);
pff_property_get_value_data(property, &value_data, &value_data_size, &error);
// Process property (e.g., print subject if PR_SUBJECT)
if (property_tag == 0x0037001F) { // PR_SUBJECT (Unicode)
printf("Subject: %ls\n", (wchar_t*)value_data);
}
pff_property_free(&property, NULL);
}
데이터를 표준 형식(CSV, JSON, XML)으로 내보내기
libpff는 주로 저수준 파싱을 위한 C 라이브러리이지만, 명령줄 유틸리티와 API를 포함하여 Outlook 데이터를 CSV, JSON, XML과 같은 널리 사용되는 형식으로 내보내는 것을 용이하게 합니다. `pffexport`와 같은 도구는 PST/OST 내용을 구조화된 텍스트 파일로 변환하여 폴더 계층 구조와 메시지 메타데이터를 보존합니다. 개발자는 라이브러리를 프로그래밍 방식으로 사용하여 맞춤형 내보내기 도구를 구축할 수 있습니다—예를 들어, MAPI 속성을 JSON 객체로 매핑하여 검색 엔진이나 분석 플랫폼에 삽입하는 경우 등. 이러한 내보내기 기능은 데이터 마이그레이션, 백업 및 표준화된 입력 형식을 요구하는 현대 클라우드 서비스와의 통합에 필수적입니다. libpff의 유연한 설계는 개발자가 특정 규정 준수 또는 워크플로 요구사항에 맞게 내보내기 로직을 조정할 수 있게 합니다.
CLI를 통해 PST 내용을 JSON으로 내보내는 방법?
# Export all messages to JSON with metadata
pffexport -f json -o output_dir/ example.pst
# Export only messages with attachments
pffexport -f json -a example.pst
# View help for export options
pffexport --help
