BurnerNet

제로 트러스트, 안티-포렌식 HTTP 클라이언트. 비밀을 지우고, 흔적을 끊습니다. 스텔스 탱크의 CPR. 👻

BurnerNet은 C++20 안티-포렌식 HTTP 클라이언트입니다. 로컬 머신을 완전히 신뢰할 수 없는 애플리케이션을 위해 유연하고 CPR과 유사한 API를 제공합니다. RAM에서 비밀을 물리적으로 지우고 실행 흔적을 차단하여 스캐너와 디버거로부터 로직을 숨깁니다.

일반 HTTP에는 친숙한 호스트 호환 기본값을 제공하고, 적대적 환경에는 명시적인 Hardened 프로필을 제공합니다. 두 경로 모두 수명이 짧은 클라이언트를 선호하며, 고급 신뢰는 애플리케이션이 소유합니다.

BurnerNet이 다운로드한 페이로드를 보호하고 싶으신가요? 메모리 내 자산 디스크램블링을 위해 RipStop Codec을 확인하세요.

원칙 • 시작하기 • 통합 경로 • 보안 현실: 화이트박스 방어

한눈에 보기

사용 이유

일반 HTTP 클라이언트가 환경에 비해 너무 신뢰적일 때 BurnerNet을 사용하세요.

다음과 같은 경우에 도움이 됩니다:

• 전역 전송을 공유하는 대신 요청 클라이언트를 수명이 짧게 유지
• 로컬 DNS 및 기타 호스트 기본값에 대한 의존성 감소
• 토큰, 인증서 및 검증 비밀을 필요할 때만 가져오기
• 응답 검증 로직을 자체 애플리케이션 코드에 유지
• 강화된 빌드에서 명백한 일반 텍스트 문자열 및 메타데이터 감소

대상 사용자

BurnerNet은 다음과 같은 프로젝트에 적합합니다:

• 고가치 인증, 라이선싱 또는 업데이트 요청이 있는 Windows 데스크탑 앱
• 완전히 신뢰하지 않는 호스트에서 실행되는 임베디드 또는 인젝션 코드
• 유연한 C++ API를 포기하지 않으면서 더 엄격한 전송 검사를 원하는 도구

표준 스택 대 BurnerNet

방어 결과

• 제로-고스트 메모리 아키텍처: BurnerNet은 사용자 정의 접두사-크기 스크러버를 사용하여 libcurl 및 OpenSSL 기반 흐름의 내부 메모리 할당 경로를 후킹합니다. 민감한 전송 버퍼는 BurnerNet 관리 수명을 벗어날 때 지워집니다. 이 위생은 문서에 설명된 감사된 구성 내에서 Windows와 Linux 모두에서 검증됩니다.
• 스택-프레임 스와이핑: 모든 요청 후 라이브러리는 자체 스레드 스택(최고 수위 표시 스크러빙)을 능동적으로 스크러빙합니다. 이는 제어권이 애플리케이션으로 돌아가기 전에 일시적인 전송 조각을 파괴하기 위한 것입니다.
• 이동-표적 힙: 일회용 전송과 정렬된 메타데이터 헤더의 조합은 높은 주소 공간 분산을 생성하여 프로세스 메모리를 예측 불가능하게 만들고 안정적인 포인터 매핑에 저항합니다.
• 수명이 짧은 요청 상태: BurnerNet은 프로세스 전체 싱글톤 전송 대신 일회용 클라이언트를 중심으로 설계되었습니다.
• 호스트에 대한 신뢰 감소: DoH 지원, 고정 키 지원 및 전송 감사는 손상된 로컬 기본값에 대한 의존성을 줄이는 데 도움이 됩니다.
• 낮은 일반 텍스트 노출: 제공자 콜백 및 안전한 지우기 유틸리티는 인증서, 키, 토큰 및 기타 민감한 버퍼의 수명을 줄입니다.
• 앱 소유 검증: 응답 검증은 WithResponseVerifier(...)를 통해 코드에 유지되며, 공유 라이브러리에 하드코딩되지 않습니다.
• 더 어려운 정적 지문 채취: 강화된 빌드는 BURNERNET_DIAGNOSTIC_STRINGS=0을 설정하여 ErrorCodeToString(...)이 기호 오류 이름을 포함하지 않고 안정적인 E<number> 값을 반환하도록 할 수 있습니다.
• 가벼운 임포트 배포 옵션: BURNERNET_HARDEN_IMPORTS=1은 BurnerNet의 Windows KernelResolver 경로를 사용하여 직접 임포트 테이블에 광고하는 대신 런타임 종속성을 동적으로 해결할 수 있습니다.
• 호출 스택 격리 (비동기 핸드오프): .WithStackIsolation(true)를 통해 활성화하면 라이브러리는 분리된 작업자 스레드에서 전송 수명 주기를 실행합니다. 이는 호출자의 호출 스택을 물리적으로 차단하고 애플리케이션 로직의 직접적인 상향식 추적을 줄일 수 있습니다.

검증된 스텔스

BurnerNet은 단순히 가벼운 임포트 강화 모드를 주장하는 것이 아닙니다. 특정 테스트 구성에 대한 감사 노트도 함께 제공됩니다. BURNERNET_HARDEN_IMPORTS=ON을 사용한 Windows x64 릴리스 감사에서:

• IAT 블랙아웃: 감사된 바이너리에서 libcurl.dll, ws2_32.dll, bcrypt.dll 또는 crypt32.dll에 대한 항목이 관찰되지 않았습니다.
• 메모리 다크아웃: 포렌식 스캔(Cheat Engine의 "All Strings")이 프로세스 힙 또는 스택에서 민감한 카나리 URL이나 헤더를 발견하지 못했습니다.
• 디버거 블라인드니스: 통합 테스트는 라이브러리가 "ID 이동"을 트리거함을 확인합니다. 의사 결정자(앱)와 전송자(BurnerNet)는 별도의 스레드 ID에서 작동하여 라이브 디버깅 세션 중 상향식 추적을 줄입니다.
• 노이즈 대 신호: 라이브러리는 지우기 권한 내에서 포렌식 위생을 목표로 하지만, OS 및 런타임 환경에 남아 있는 시스템 수준의 "그림자"를 인정합니다.

감사 세부 사항 및 방법론:

• docs/BINARY_STEALTH_AUDIT.md

시작하기

가장 빠른 경로:

• CMake 또는 Visual Studio 소스 드롭으로 빌드에 BurnerNet을 추가하세요.
• <burner/net.h>를 포함하세요.
• 스택 클라이언트를 만들고, 요청을 보낸 다음, 범위를 벗어나게 두세요.

최소 예제:

#include <iostream>

#include <burner/net.h>

int main() {
    burner::net::Client client;
    if (!client.IsReady()) {
        std::cerr << burner::net::ErrorCodeToString(client.InitError()) << '\n';
        return 1;
    }

    const auto response = client
        .Get("https://example.com")
        .WithHeader("Accept", "text/html")
        .WithTimeoutSeconds(10)
        .Send();

    if (!response.TransportOk()) {
        std::cerr << burner::net::ErrorCodeToString(response.transport_error) << '\n';
        return 1;
    }

    std::cout << "HTTP " << response.status_code << '\n';
    return 0;
}

Client는 표준 기본값을 사용합니다: 시스템 CA, DNS, 프록시, TLS 피어 및 호스트 이름 검증 활성화. WithCasualDefaults()는 표준 호환 별칭으로 계속 사용 가능합니다.

보안이 중요한 트래픽의 경우 Hardened 프로필을 사용하세요. Build()는 요청 전에 누락된 제어를 거부합니다:

auto secure = burner::net::ClientBuilder(burner::net::ClientProfile::Hardened)
    .WithMtlsProvider(ProvideMtlsCredentials)
    .WithSecurityPolicy(AppSecurityPolicy{})
    .WithDnsFallback(burner::net::DnsMode::Doh,
                     "https://resolver.example/dns-query",
                     "Primary DoH")
    .AllowSystemDns(true) // explicit fallback, after DoH
    .WithResponseVerifier(VerifySignedResponse)
    .Build();

Hardened는 피어 및 호스트 이름 검증, 스택 격리, DoH 우선 라우팅, 앱 응답 검증기 및 앱 소유 신뢰 마운트를 요구합니다. 영구적인 WithMtls(...) 자격 증명은 거부됩니다. WithMtlsProvider(...)를 사용하세요.

통합 경로

1. Standard CMake

하위 프로젝트가 이미 CMake를 사용하고 있고 가장 깔끔한 종속성 관리 경로를 원할 때 사용하세요.

문서:

• docs/CMAKE_INTEGRATION.md
• examples/cmake-consumer/README.md

2. Visual Studio Source-Drop

환경이 MSBuild 우선이거나 BurnerNet을 .vcxproj 내부에서 직접 컴파일하려는 경우 사용하세요.

문서:

• docs/VISUAL_STUDIO_INTEGRATION.md
• examples/vs-consumer/README.md

3. Hardened Runtime Imports

명백한 런타임 종속성 노출을 줄이고 부트스트랩 로딩을 명시적으로 관리할 준비가 되었을 때 사용하세요.

활성화:

• BURNERNET_HARDEN_IMPORTS=1
• Windows에서 BurnerNet의 KernelResolver 경로를 사용하여 더 가벼운 임포트 런타임 풋프린트를 지원합니다.

참조:

• docs/USAGE_BEST_PRACTICES.md
• docs/CMAKE_INTEGRATION.md
• docs/VISUAL_STUDIO_INTEGRATION.md

Linux 지원: BurnerNet은 Linux에서 완전한 포렌식 패리티(메모리 지우기 및 스택 격리)를 제공합니다. 빌드 지침은 docs/LINUX_USAGE.md를 참조하세요.

사용 참고 사항

권장 기본값:

• 클라이언트를 일회용 전송으로 취급
• 높은 신뢰와 낮은 신뢰 트래픽을 별도의 클라이언트로 분리
• mTLS 자료, 베어러 토큰 및 응답 검증 비밀에는 제공자 콜백 사용
• 비즈니스 규칙 및 신뢰 앵커를 애플리케이션에 유지

예제 및 문서

예제:

• examples/01_basic_usage.cpp
• examples/02_zero_trust_pipeline.cpp
• examples/03_custom_security_policy.cpp
• examples/04_bootstrap_runtime.cpp
• examples/05_mtls_usage.cpp
• examples/06_hmac_custom_verifier.cpp

문서:

• PRINCIPLES.md
• docs/USAGE_BEST_PRACTICES.md
• docs/CMAKE_INTEGRATION.md
• docs/VISUAL_STUDIO_INTEGRATION.md
• docs/LINUX_USAGE.md

요구 사항

• C++20
• Windows x64/x86 또는 Linux (GCC 13+ / Clang 15+)
• libcurl 7.87.0+ 및 OpenSSL 헤더
• Linux 가이드: docs/LINUX_USAGE.md 참조

보안 현실 및 화이트박스 방어

BurnerNet은 공격 비용을 전문가 수준으로 높이기 위해 설계된 강화 계층입니다. 우리는 스텔스는 표면적이 아니라 구조적이어야 한다는 원칙에 따라 운영됩니다.

공격자가 소스 코드를 가지고 있으면 BurnerNet을 우회할 수 있나요?

BurnerNet의 소스 코드에 대한 지식만으로는 모든 하위 애플리케이션의 마스터 키가 아닙니다. BurnerNet은 Kerckhoffs의 원칙을 따릅니다: 라이브러리는 앱별 신뢰 앵커(HMAC 비밀, 고정 키, UI 로직, 정책 후크)가 애플리케이션 소유로 남도록 설계되었습니다. 전송 계층을 안다고 해서 특정 보안 흐름을 자동으로 우회할 수 있는 것은 아닙니다.

• 지연으로서의 스텔스: 강화는 공격자를 표준 편의 도구에서 벗어나 지루한 명령어 수준 분석으로 이끕니다.
• 데이터로서의 루트: 기능적 의존성(원칙 6)을 사용하여 앱이 서버 제공 데이터 없이는 말 그대로 작동하지 않도록 하세요.
• 유령 이점: 공격자가 요청 로직을 찾을 때쯤이면 스택 격리 및 메모리 지우기가 이미 필요한 포렌식 증거를 파괴합니다.