에이전트 전용 봉인 모듈(agent_seal): 완전 엔트로피 기계키 봉인 + 정보이론적 OTP

[kevin9327]

Closes #4843

무엇을 / 왜

문서 암호화의 약한 고리는 알고리즘이 아니라 사람이 고른 낮은 엔트로피 암호입니다.
Argon2id 같은 강한 KDF 도 이 사실을 늦출 뿐 없애지 못합니다. 반면 에이전트는 완전
엔트로피 기계 키(OS 난수 32바이트)를 직접 보관·전달할 수 있으므로 이 약한 고리를
아예 제거할 수 있습니다.

그리고 "양자내성보다 더 강한" 암호는 존재하지 않습니다 — 딱 하나 예외가 정보이론적
안전성(일회용 패드) 입니다. 이 PR 은 이 두 가지를 정직하게 제공하는 새 독립 모듈
src/agent_seal.rs 를 추가합니다. 마법의 "양자 초월 암호"는 없습니다.

동시에 작업 중인 src/security_trailer.rs(ML-KEM 공개키 축)와는 완전히 독립입니다.
자체 마법 마커(RHWPAGT1/RHWPAGND)를 써서 형식이 서로 겹치지 않습니다. 그 파일은
이 PR 에서 건드리지 않았습니다.

두 가지 모드

1번 모드 — 완전 엔트로피 에이전트 키 (계산적 안전, 양자내성)

• agent_keygen() -> [u8; 32] — OS 난수 32바이트. 이 원시 키 자체가 "에이전트 암호"
  입니다(사람 암호·Argon2id 없음). 호출자가 base64/hex 로 인코딩해 다룹니다.
• seal_with_key(host, secret, key) -> Vec<u8> — XChaCha20-Poly1305 AEAD, 매 호출 새
  24바이트 난수 논스. 트레일러 헤더를 AAD 로 묶어 변조를 탐지합니다. 트레일러는 호스트
  문서 뒤에 붙어 평범한 뷰어가 무시합니다(가시 계층 = 호스트). 인증(AEAD) 있음.
• open_with_key(bytes, key) -> Opened — 꼬리에서 트레일러를 탐지해
  Plain / Sealed{plaintext} / Broken{reason} 를 반환. 손상된 입력에도 패닉하지 않음
  (엄격한 경계 검사). 키 불일치·변조는 AEAD 인증 실패로 Broken.

2번 모드 — 일회용 패드 (정보이론적 안전 — 유일하게 "양자보다 강한" 것)

• otp_generate_pad(len) -> Vec<u8> — len 바이트 진짜 난수.
• otp_seal(secret, pad) -> Result<Vec<u8>, AgentSealError> — pad.len() >= secret.len()
  을 강제(짧으면 PadTooShort 오류; 잘린 봉인을 만들지 않음) → secret XOR pad.
  1번과 같은 트레일러 컨테이너에 distinct algo 바이트로 자기서술합니다.
• otp_open(sealed, pad) -> Opened — XOR 로 복원. 엄격한 경계·무패닉.

OTP 의 정직한 조건과 한계 (코드 doc 에도 기재)

OTP 가 무조건적으로 안전한 것은 오직 다음이 모두 성립할 때뿐입니다:

1. 패드가 진짜 난수여야 한다(의사난수 PRNG 는 안 됨).
2. 패드 길이가 메시지 길이 이상이어야 한다.
3. 패드를 정확히 한 번만 써야 한다(재사용 시 완전히 깨짐).
4. 패드를 대역 외(out-of-band)로 안전하게 공유해야 한다.

이 조건을 못 지키면 OTP 는 오히려 약한 XOR 암호로 전락합니다. 또한 OTP 는 기밀성만
제공하며 무결성/인증이 없어 비트 뒤집기 변조를 탐지하지 못합니다(1번 모드의 AEAD 와
대비되는 정직한 한계). 인증이 필요하면 1번 모드를 쓰십시오.

트레일러 형식 (자기서술)

  MAGIC_START "RHWPAGT1"  (8)
  version                 (1)  = 1
  algo                    (1)  = 1(XChaCha20-Poly1305) | 2(OTP-XOR)
  nonce_len               (1)  = 24(XChaCha) | 0(OTP)
  nonce                   (nonce_len)   ── 위까지가 header = AEAD 의 AAD ──
  ciphertext              (가변)
  trailer_len  u64 LE     (8)
  MAGIC_END "RHWPAGND"    (8)

의존성

• chacha20poly1305 = { version = "0.10", features = ["alloc"] } 추가(순수 Rust, wasm 호환).
• OTP 모드는 XOR + 기존 getrandom 만 사용(추가 의존성 없음).

검증

• cargo build --bin rhwp 통과.
• cargo test --lib agent_seal:: — 16/16 통과:
  • 1번: keygen 32바이트·난수성, seal→open 라운드트립(비밀 복원 + 가시 계층=호스트),
    빈 비밀 라운드트립, 오키 → Broken(무패닉), 서로 다른 두 무작위 키의 상호 열람 불가,
    변조 암호문 → Broken(AEAD), 평문 호스트 → Plain, 손상 입력 전수 무패닉.
  • 2번: OTP 라운드트립(길이 정확/여유 패드), 짧은 패드 → PadTooShort 오류(잘린 봉인 아님),
    복원 시 짧은 패드 → Broken, ciphertext == secret XOR pad 직접 검증, 손상 입력 무패닉.
  • 교차 모드: OTP 블롭을 open_with_key 로 / AEAD 블롭을 otp_open 으로 열면 Broken.
• cargo test --lib — 전체 3718 passed, 0 failed, 13 ignored (회귀 없음).
• 리프 파일만 rustfmt --edition 2021 src/agent_seal.rs 로 정렬(--check 통과). cargo clippy --lib 통과.

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

[jangster77]

통합 PR #4883(4412546)로 병합 완료했습니다.

원 head와 CI를 다시 확인해 누적 반영했고, 상세 검토·메인터너 보정·검증 근거는 archive 검토 기록에 남겼습니다.

중복 병합을 막기 위해 이 원 PR을 닫습니다. 감사합니다.