A · 동작 흐름How it works
원본과 전환본을 같은 규칙으로 검사해 판정을 내리고 그 과정을 검증 증적으로 남깁니다. 아래 두 줄은 0.3.0의 구현 검증입니다. KpqC 줄은 내 하네스가 문제지를 풀고, 그 답안을 KAT 판마다 대조합니다. NIST 줄은 따로 설치한 pq-verify의 감사 보고서를 받습니다. --pq-verify를 줄 때만 돌고, 답안 없이 감사만 돌릴 수도 있습니다. 두 줄 모두 같은 판정과 증적으로 갑니다. 왼쪽 프리셋('KpqC 구현 검증', 'NIST 감사(pq-verify)' 등)이나 그림의 칸을 눌러 경로를 따라가 보세요.Both trees go through the same rules. The verdict and everything behind it land in the verification evidence. The two bottom rows are the implementation check of 0.3.0. In the KpqC row, your harness answers the KpqC questions and the answers are matched against each KAT version. The NIST row takes the audit report of pq-verify, a tool you install yourself. It runs only with --pq-verify, and it can run alone without answers. Both rows feed the same verdict and evidence. Use the presets on the left (such as "KpqC implementation" or "NIST audit (pq-verify)"), or click a box, to follow one path.
같은 입력이면 판정과 검사 결과가 같습니다. 증적 해시는 실행 시각과 경로가 들어가 실행마다 새로 나옵니다. 구현 검증은 답안을 대조할 뿐이고, 구현을 실행하는 쪽은 내 하네스입니다.Same inputs give the same verdict and check results. The evidence hash also covers run times and paths, so each run gets a new one. The implementation check only compares answers; your harness, not PQ-Proof, runs the implementation.그림은 좌우로 밀어서 봅니다Swipe sideways to see the whole diagram
B · 무엇을 판정하나What it checks 검사 8개 + 구현 2개8 checks + 2 impl
하나라도 실패하면 실패입니다. 실패가 없고 미판정이 하나라도 있으면 미판정입니다. 검토 필요는 판정을 바꾸지 않고 사람이 볼 곳을 표시합니다.One failed check fails the run. With no failures, one undecided check makes the run undecided. "Needs review" keeps the verdict and marks a place for a person to look.
| 검사Check | 통과 조건Passes when | 걸리면If not |
|---|---|---|
| a-input | 두 트리가 같은 서비스이고(파일 절반 이상이 같은 경로) 원본에 바꿀 것이 있습니다. 원본에서 아무것도 못 찾으면 깨끗한 결과가 아무것도 증명하지 못하므로 미판정입니다.Both trees are the same service (at least half the files share a path) and the original has something to migrate. Finding nothing in the original makes the run undecided, since a clean result there proves nothing. 전환본에서 셈에 넣은 폴더(트리 맨 위 vendor/ 등), 1 MiB가 넘는 코드 파일, 트리 밖을 가리키는 링크는 목록으로 적고 검토 필요로 올립니다.Counted folders in the migrated tree (a top-level vendor/, for example), code files over 1 MiB and links that point outside the tree are listed and raised as "needs review". | 실패fail 미판정undecided 검토 필요needs review |
| a-cbom | 전환본 CBOM에 막는 위치가 0곳입니다. 주석·시험·허용 줄 밖에서 양자 컴퓨터로 깨지는 공개키 사용이 없어야 합니다. scan/cbom-scan.sh와 pqlite/scan.py 두 스캐너가 채웁니다.The CBOM of the migrated tree has zero blocking locations: no quantum-breakable public-key use outside comments, tests and allowed lines. Two scanners feed it, scan/cbom-scan.sh and pqlite/scan.py. 열지 못한 키 자료(암호화된 PKCS#8, 안 열리는 키스토어)와 복합 서명은 검토 필요로 셉니다(REQUIRE_RESOLVED=1이면 실패).Key material it cannot open (an encrypted PKCS#8 key, a keystore that does not open) and composite signatures count as "needs review" (a failure with REQUIRE_RESOLVED=1). | 실패fail 검토 필요needs review |
| b-weakening | 바뀐 파일이 TLS 검증을 끄지 않습니다. InsecureSkipVerify, 모두 믿는 TrustManager, proxy_ssl_verify off, TLS 1.0, TLS 1.3을 끄는 설정(MaxVersion: tls.VersionTLS12 등) 같은 규칙을 Go·Java·Spring·Node·Python·nginx에 겁니다.No changed file turns off a TLS check: InsecureSkipVerify, a trust-all TrustManager, proxy_ssl_verify off, TLS 1.0, settings that turn TLS 1.3 off (MaxVersion: tls.VersionTLS12 and the like) and similar rules for Go, Java, Spring, Node, Python and nginx. | 실패fail |
| b-tls | TLS를 쓰는 서비스에만 겁니다. X25519MLKEM768만 내미는 클라이언트가 그 그룹으로 붙고 옛 클라이언트(X25519,P-256)는 정한 대로(CLASSIC=allow 또는 deny) 응답을 받아야 합니다.Only when the service speaks TLS. A client that offers only X25519MLKEM768 connects with it, and an old client (X25519,P-256) gets the answer you asked for (CLASSIC=allow or deny). | 실패fail 미판정undecided |
| c-classic | scan/residue.sh가 기존 공개키 9계열(RSA, EC, 곡선 이름, OAEP/PKCS#1, 기존 서명 이름, JWT RS/ES/PS, EdDSA, X25519/ECDH, DH/DSA)의 코드 줄을 0줄로 셉니다. 보안레벨 3 미만 PQC와 레거시 읽기 전용 파일 쓰기도 없어야 합니다. 시험 경로의 줄은 따로 세어 보입니다.scan/residue.sh counts zero code lines in nine classical public-key families (RSA, EC, curve names, OAEP/PKCS#1, classical signature names, JWT RS/ES/PS, EdDSA, X25519/ECDH, DH/DSA). No PQC below NIST security category 3 and no writes in legacy read-only files. Lines in test paths are counted apart and listed. | 실패fail |
| c-expect | 시험 경로 밖 코드에 PQC 키 교환과 서명이 있습니다(기본 EXPECT=kem,sig). 기본 프로필 PROFILE=nist-cat3은 ML-KEM-768·1024와 ML-DSA-65·87, SLH-DSA 192·256(0.4.0부터)을 셉니다. cnsa2는 ML-KEM-1024·ML-DSA-87만, kpqc는 국내 KpqC 알고리즘까지 셉니다.Post-quantum key exchange and signatures appear in code outside test paths (EXPECT=kem,sig, the default). The default profile, PROFILE=nist-cat3, counts ML-KEM-768 or 1024 and ML-DSA-65, 87 or SLH-DSA 192 or 256 (from 0.4.0); cnsa2 counts only ML-KEM-1024 and ML-DSA-87, and kpqc also counts the Korean KpqC algorithms. | 실패fail |
| r-review | 서명 검증과 복호 호출이 줄지 않았고 verify 메서드가 return true로 줄어들지 않았습니다.Signature checks and decryption calls did not drop, and no verify method shrank to return true. | 검토 필요needs review |
| r-allow | 줄을 빼 주는 허용 항목마다 확인한 사람이 적혀 있고 전환본에서 안 쓰인 항목이 없습니다. REQUIRE_REVIEW=1이면 걸릴 때 실패입니다(F절).Every allowlist entry that takes lines out of the count names the person who checked it, and no entry is unused in the migrated tree. With REQUIRE_REVIEW=1 a miss fails the run (section F). | 검토 필요needs review |
| i-kpqc | 구현 검증(pqproof impl, 0.3.0)에서만 돕니다. 내 하네스가 KpqC 구현(SMAUG-T·NTRU+·HAETAE·AIMer)으로 만든 답안이나 PQCgenKAT .rsp가 받아 줄 참조판(기본 최신판)의 KAT와만 일치해야 합니다. PQ-Proof는 구현을 빌드하거나 실행하지 않고 대조만 합니다. 옛 판과 일치하면 판 이름을 적고 검토 필요로 둡니다. 결과는 '참조판 X의 KAT와 일치'라는 뜻이고 KCMVP 검증을 대신하지 않습니다(아래 구현 검증).Runs only in the implementation check (pqproof impl, 0.3.0). The answers your harness got from a KpqC implementation (SMAUG-T, NTRU+, HAETAE, AIMer), or a PQCgenKAT .rsp, match only an accepted reference version (the latest by default). PQ-Proof does not build or run the implementation; it only compares. A match with an old version names that version and needs review. The result means "matches the KAT of reference version X"; it does not replace a KCMVP validation (implementation check below). | 실패fail 미판정undecided 검토 필요needs review |
| i-nist | 구현 검증에 --pq-verify를 줄 때만 돕니다. pq-verify는 사용자가 따로 설치하는 바깥 도구(MIT)로, NIST PQC 라이브러리(ML-KEM·ML-DSA·SLH-DSA)를 불러 고정 벡터로 감사합니다. 종료 0, VERIFIED, 검사 범위 완전이면 통과입니다. 라이브러리를 실행하는 것은 그 도구이므로 믿지 못할 라이브러리는 컨테이너나 VM에서 돌립니다.Runs only when the implementation check gets --pq-verify. pq-verify checks a NIST PQC library (ML-KEM, ML-DSA, SLH-DSA) against pinned vectors; it is a separate tool (MIT) that you install yourself. Exit 0, VERIFIED and a complete scope pass. That tool runs the library, so audit one you do not trust in a container or VM. | 실패fail 미판정undecided |
건너뛴 검사는 통과로 세지 않습니다. 대상이 없는 검사는 '해당 없음'으로 따로 적고 원본에서 찾은 것이 없으면 판정을 미판정으로 둡니다. 통과인데 검토 필요가 남으면 판정 줄에 그 검사 이름을 붙입니다.A skipped check never counts as a pass. A check with nothing to look at says "not applicable", and a run that finds nothing in the original stays undecided. A pass that still has a check needing review names that check on the verdict line.
FAIL_ON_REVIEW=1일 때만, 구현 검증 CI에서 켬)pass that needs review (only with FAIL_ON_REVIEW=1; set it for the implementation check in CI)구현 검증Implementation check pqproof impl 0.3.0 새 기능new in 0.3.0구현은 실행하지 않음never runs the implementationKCMVP 대체 아님not a KCMVP substitute
PQ-Proof가 KAT 발췌로 문제지를 쓰면 내 하네스가 구현으로 답안을 만들고, PQ-Proof는 그 답안이 어느 참조판의 KAT와 일치하는지 판마다 대조해 증적(형식 4)에 남깁니다. 2026년 1월 최종 배포 뒤에도 참조 KAT가 바뀌었기 때문에 판 이름이 결과의 핵심입니다.PQ-Proof writes a question sheet from KAT excerpts, your harness answers it with your implementation, and PQ-Proof matches the answers against every reference version and records which one they match (evidence format 4). The reference KATs changed after the final release of January 2026, so the version name is the heart of the result.
받아 주는 판과 검토 필요인 판Accepted and needs-review versions
| 알고리즘Algorithm | 파라미터 세트Parameter sets | 받아 줌(기본)Accepted (default) | 검토 필요Needs review |
|---|---|---|---|
| SMAUG-T KEM | mode1mode3mode5modet | 1.2.0 | 1.1.1옛 참조판older reference |
| NTRU+ KEM | 7688641152 | 2026-01 | 없음none |
| HAETAE 서명signature | mode2mode3mode5 | 1.2.0 | 1.1.2옛 참조판older reference |
| AIMer 서명signature | 128f128s192f192s256f256s | 3.0 | aim2-2026-01옛 참조판older referencebc-round2알려진 변형known variant |
받아 줄 판은 scan/profiles.json kpqc 프로필의 impl_accept가 정합니다(기본 latest). 옛 판과 일치한 답은 틀린 답이 아닙니다. 프로젝트가 따를 판을 PQ-Proof가 모르므로 판 이름을 적고 사람에게 넘깁니다. 받으려면 "aimer@aim2-2026-01"처럼 항목을 더하고, 그 뒤 증적은 규칙 묶음 6+modified로 적힙니다.The accepted versions come from impl_accept in the kpqc profile of scan/profiles.json (latest by default). A match with an old version is not a wrong answer: PQ-Proof cannot know which version your project follows, so it names the version and leaves the call to a person. To accept one, add an entry such as "aimer@aim2-2026-01"; receipts after that name ruleset 6+modified.
판정 기준How each result is reached
| 검사Check | 통과pass | 검토 필요needs review | 실패fail | 미판정undecided |
|---|---|---|---|---|
| i-kpqc | 모든 세트가 받아 줄 판과만 일치하고, 한 바이트 바꾼 서명은 모두 거부하고, 자기 점검이 통과every set matches only an accepted version, every signature with one changed byte is rejected, and the self-check passes | 옛 판·알려진 변형과 일치, 또는 판을 가르지 못함(decaps·verify 답만 낸 경우)matches an old version or a known variant, or cannot tell versions apart (decaps or verify answers only) | 모든 문항이 맞는 판이 없음, 또는 바꾼 서명을 받아들임(첫 불일치 문항을 적음)no version matches every item, or a changed signature is accepted (the first mismatch is named) | 답 빠짐, 다른 문제지, 모르는 세트, 64 MiB 초과, 짧은 .rsp, 자기 점검 실패missing answers, another question sheet, an unknown set, over 64 MiB, a short .rsp, a failed self-check |
| i-nist | 종료 0, VERIFIED, 해시한 라이브러리와 묶인 보고서, 검사 범위 완전exit 0, VERIFIED, a report bound to the hashed library, complete scope | 없음none | 종료 1, FINDINGS PRESENT, 통과한 검사가 총수보다 적음exit 1, FINDINGS PRESENT, fewer checks passed than the total | 입력 오류, DEGRADED, 범위 불완전, 돌지 못한 검사, 실행 파일 없음, 시간 초과, 깨진 보고서input error, DEGRADED, incomplete scope, checks that did not run, no executable, a timeout, a broken report |
CI에서는 FAIL_ON_REVIEW=1을 켭니다. 옛 판과만 일치하면 판정은 통과(검토 필요)이고 종료 코드는 0입니다. 종료 코드만 읽는 파이프라인은 이 값을 켜야 5로 멈춥니다(D절 끝까지 시험의 k3b 경우).Set FAIL_ON_REVIEW=1 in CI. A match with an old version only is a pass (needs review) with exit 0. A pipeline that reads only the exit code stops on it (exit 5) only with this setting (case k3b of the end-to-end table in section D).
C · 검증 증적과 증적 해시Verification evidence and the evidence hash RFC 8785 + SHA-256
실행마다 새 출력 폴더에 검증 증적(receipt.json, receipt.html)과 전후 CBOM 표, 도구 원본 출력을 남깁니다. 증적 해시는 receipt_id 칸입니다.Each run writes a new output folder with the verification evidence (receipt.json, receipt.html), the CBOM of both trees and the raw tool output. The evidence hash is the receipt_id field.
입력을 고정합니다Pin the inputs
두 입력의 절대 경로와 파일 목록 SHA-256, zip이면 zip SHA-256을 적습니다.Absolute path, file-list SHA-256 and, for a zip, the zip SHA-256 of both inputs.
도구와 설정을 적습니다Record tools and settings
실행한 도구마다 경로와 SHA-256, 그리고 매개변수를 남깁니다.Every tool that ran, with its path and SHA-256, plus the parameters.
검사마다 기대값과 실제값Expected and actual per check
검사 결과, 단계별 시작·끝 시각, 출력 파일마다 크기와 SHA-256을 씁니다.Each check result, start and end time per step, and size and SHA-256 of every output file.
증적 해시를 계산합니다Compute the evidence hash
receipt_id 칸을 뺀 receipt.json을 RFC 8785(JCS)로 정규화하고 SHA-256을 냅니다.receipt.json without receipt_id, put in RFC 8785 (JCS) canonical form, hashed with SHA-256.
--verify로 다시 확인합니다Check again with --verify
증적 해시와 모든 파일 해시, 풀어 둔 입력 트리를 다시 계산하고 HTML 페이지, deck.json, 0.2.0부터 출력 폴더에 들어가는 README.txt를 다시 만들어 비교합니다.Recomputes the evidence hash, every file hash and the unpacked input tree, and rebuilds the HTML page, deck.json and, from 0.2.0, the README.txt in the output folder to compare.
# 예제 소스로 실행(실제 출력, 경로 줄과 진행 줄은 줄임)run on the bundled examples (real output; path and progress lines left out) # check lines are printed in Korean, as in the finals (see the FAQ); the verdict line and --verify are in English $ bash prove.sh examples/classic examples/pqc == PQ-Proof 0.5.0 (2026-11-21 20:47:35 KST) [arm64] … [a-input] 통과 공통 파일 5/5 · 원본 막는 위치 13 · 원본 공개키 code 17 · TLS 실측 대상 0 [a-cbom] 통과 막는 위치 0곳(원본 13) · 허용 0 · 주석·테스트 0 · 확인 0 [b-weakening] 통과 deny 0 · 본 파일 4 [b-tls] 해당 없음 TLS 서버·클라이언트 신호 0 [c-classic] 통과 공개키 code 0(원본 17) · 보안레벨 3 미만 0 · 레거시 쓰기 0 [c-expect] 통과 E-MLKEM768 2 + E-MLKEM1024 0 = 2 · E-MLDSA65 2 + E-MLDSA87 0 + E-SLHDSA 0 = 2 [r-review] 통과 0건 [r-allow] 해당 없음 허용 목록 없음 VERDICT=PASS receipt_id=0331a6012a3f… 검사 8개: 통과 6 · 해당 없음 2 (통과로 세는 것은 '통과'뿐) · 도구 0.5.0 · 규칙 묶음 6 · 증적 형식 4 검증 증적 다시 확인: ok (35개 검사) # 증적 다시 확인(해시는 실행마다 다름)check the evidence again (hashes differ per run) $ bash prove.sh --verify proof-out-20261121-204733 ok receipt.json is byte for byte the tool's own serialization of its values ok receipt.json fits the schema ok evidence format 4: pqproof 0.5.0, ruleset 6 (ruleset_sha256 matches the rule files in tools[]) ok receipt_id 0331a6012a3f… ok tables/report.md: sha256 fb9b934e… … ok receipt.html is this receipt ok README.txt is this receipt all checks pass (35 checks) # 한 바이트를 바꾸면change one byte $ printf ' ' >> proof-out-20261121-204733/tables/report.md $ bash prove.sh --verify proof-out-20261121-204733 FAIL tables/report.md: 2857 bytes, sha256 3838052b…; the receipt says 2856 bytes, fb9b934e… 1 check(s) failed (35 checks)
receipt.html, 기계가 읽을 receipt.json, 문서에 붙일 표 tables/report.md, 전후 CBOM과 도구 원본 출력이 들어갑니다. 실패하면 콘솔 끝에 전체 목록이 있는 곳과 다음 할 일이 나옵니다.receipt.html for people, receipt.json for programs, tables/report.md to paste into a document, the CBOM of both trees and the raw tool output. On a failure the console ends with where the full lists are and what to do next.artifacts/impl/에 답안·정답 키·문제지 사본, tables/impl.csv에 세트별 판 대조표가 들어가고, --pq-verify를 켜면 그 보고서도 들어갑니다. --verify는 답안 사본을 자기 규칙으로 늘 다시 판정합니다. 감사 도구를 다시 돌리거나 라이브러리를 다시 해시하지는 않습니다.Copies of the answers, answer key and question sheet go into artifacts/impl/, a per-set version table into tables/impl.csv, and with --pq-verify its report too. --verify always judges the saved answers again with its own rules; it does not rerun the audit tool or rehash the library.증적 해시 직접 계산해 보기Compute an evidence hash yourself 예시 데이터sample data
짧은 예시 증적입니다. 왼쪽을 고치면 RFC 8785 정규형과 SHA-256이 바로 다시 계산됩니다. 키 순서나 공백을 바꿔도 해시는 같고 값이 한 글자만 바뀌어도 해시가 달라집니다. 계산은 이 페이지 안에서만 합니다.A short sample of the evidence. Edit the left side and the RFC 8785 canonical form and SHA-256 update at once. Reordering keys or adding spaces keeps the hash, and changing one character of a value breaks it. Everything runs inside this page.
파일을 고치고 해시를 새로 쓰는 일은 누구나 할 수 있으므로 증적 해시는 실행 화면 출력이나 제출 기록처럼 믿을 만한 곳에 적힌 값과 비교할 때만 뜻이 있습니다. 모든 칸을 서로 맞춰 다시 쓴 증적은 --verify로 못 잡고 같은 소스로 다시 돌려 비교해야 잡힙니다.Anyone can edit the files and write fresh hashes. The evidence hash only tells you something when you compare it with a value from a place you trust, such as the console output of the run or a submission record. Evidence rewritten so that every field agrees again gets past --verify; only a fresh run on the same code catches it.
D · 공개 시험Public tests 태그 v0.5.0 (0b6610b) · 2026-11-21tag v0.5.0 (0b6610b) · 2026-11-21
공개 예제와 이 저장소의 시험으로 확인한 결과이며, 숫자는 태그 v0.5.0 (0b6610b) 기준입니다. 구현 검증은 셀프 시험 S11a~S11d, 변이 시험 11건, 형식 4 옛 증적 2개, 실제 KpqC 빌드로 돌린 끝까지 시험(아래 표)으로 확인합니다. 본선 뒤 찾은 결함 둘(D1·D2)은 공개 예제로 재현해 셀프 시험 S8~S10에 넣었고, 0.2.0에서 막은 우회와 규칙 빈틈은 변이 시험과 golden 기록에 하나씩 넣었습니다.These results come from the public examples and the tests in this repository; the numbers are for tag v0.5.0 (0b6610b). The implementation check is covered by self-tests S11a to S11d, 11 mutation cases, 2 format-4 evidence fixtures and an end-to-end run on real KpqC builds (table below). I reproduced the two flaws found after the finals (D1, D2) on the public examples and added them as self-tests S8 to S10. Each bypass and rule gap closed in 0.2.0 has its own mutation case and golden entry.
KpqC 끝까지 시험(실제 빌드, 태그 v0.3.0)KpqC end to end (real builds, tag v0.3.0)
실제 KpqC 참조 구현 20개, 결함을 심은 빌드 1개, PQClean ML-KEM-768 하나를 고정 SHA-256 압축본에서 빌드해 끝까지 돌린 결과입니다. 태그 v0.3.0에서 ubuntu·macOS가 같은 표를 냈고 모든 증적이 --verify를 통과했습니다. 기본 CI는 KpqC 소스를 받지 않고, 이 시험은 손으로 또는 릴리스 태그에서 kpqc-e2e.yml이 돕니다.Built from pinned SHA-256 archives: 20 KpqC reference libraries, one build with a planted defect and PQClean ML-KEM-768, run end to end. At tag v0.3.0, ubuntu and macOS gave the same table and every evidence folder passed --verify. The default CI does not fetch KpqC sources; kpqc-e2e.yml runs this by hand or on a release tag.
| 경우case | 무엇을what | 종료exit | i-kpqci-kpqc | i-nisti-nist | --verify--verify |
|---|---|---|---|---|---|
| k1-latest | SMAUG-T 1.2.0, NTRU+ 2026-01, AIMer 3.0 빌드(13세트, derand 답 포함)SMAUG-T 1.2.0, NTRU+ 2026-01, AIMer 3.0 builds (13 parameter sets, derand answers) | 0 | 통과pass | 해당 없음n/a | okok |
| k2-smaug-t-1.1.1 | SMAUG-T 1.1.1 빌드: 옛 판SMAUG-T 1.1.1 builds: old version | 0 | 검토 필요needs review | 해당 없음n/a | okok |
| k3-haetae-1.1.2 | HAETAE 1.1.2 빌드: 옛 판(Bouncy Castle 시험 자료와 같은 판)HAETAE 1.1.2 builds: old version (the one Bouncy Castle ships) | 0 | 검토 필요needs review | 해당 없음n/a | okok |
| k3b-haetae-1.1.2-fail-on-review | k3과 같은 답안을 FAIL_ON_REVIEW=1로same answers under FAIL_ON_REVIEW=1 | 5 | 검토 필요needs review | 해당 없음n/a | okok |
| k4-smaug-t-no-derand | SMAUG-T 1.2.0 mode3, decaps 답만: 판을 가르지 못함SMAUG-T 1.2.0 mode3, decaps answers only: versions cannot be told apart | 0 | 검토 필요needs review | 해당 없음n/a | okok |
| k5-wrong-build | SMAUG-T 1.2.0 mode3에 decaps 결함을 심은 빌드SMAUG-T 1.2.0 mode3 with a planted decaps defect | 1 | 실패fail | 해당 없음n/a | okok |
| k6-rsp | SMAUG-T 1.2.0 mode3 참조 KAT 프로그램이 쓴 PQCgenKAT .rspPQCgenKAT .rsp written by the SMAUG-T 1.2.0 mode3 reference KAT program | 0 | 통과pass | 해당 없음n/a | okok |
| n1-mlkem-native | mlkem-native ML-KEM-768을 pq-verify로 감사(최신 KpqC 답안과 함께)pq-verify on mlkem-native ML-KEM-768, with the latest KpqC answers | 0 | 통과pass | 통과pass | okok |
| n2-mlkem-native-bad | decaps 결함을 심은 mlkem-native, KpqC 답안 없음pq-verify on mlkem-native with a planted decaps defect, no answers | 1 | 해당 없음n/a | 실패fail | okok |
| n3-pqclean | PQClean ML-KEM-768 clean: 키 입력 검사 단계만 실패(FIPS 203은 이 검사를 호출자가 API 밖에서 해도 되지만 pq-verify는 실패로 봄)pq-verify on PQClean ML-KEM-768 clean: only the key input-check stages fail (FIPS 203 lets the caller run them outside the API; pq-verify still fails it) | 1 | 해당 없음n/a | 실패fail | okok |
로컬 macOS 실측: 참조 빌드 29개(4종 16세트의 최신판과 옛 판)로 최신판 16세트 모두 통과, 옛 판 16세트는 검토 필요 13 · 통과 3(NTRU+는 판이 하나). pq-verify 2.19.0은 mlkem-native 검사 1436/1436 통과, 결함 심은 판 1259/1436, PQClean clean 532/1436(키 입력 검사 단계만 실패, FIPS 203은 이 검사를 API 밖에서 호출자가 해도 됨), pq-verify가 없으면 미판정(종료 3).Local macOS run: with 29 reference builds (latest and old versions of all 16 sets), all 16 latest sets pass and the 16 old ones give 13 needs review and 3 passes (NTRU+ has one version). pq-verify 2.19.0: mlkem-native 1436/1436 checks pass, the planted defect 1259/1436, PQClean clean 532/1436 (only the key input-check stages fail; FIPS 203 lets the caller run those checks outside the API); without pq-verify the run is undecided (exit 3).
본선에서In the finals
본선에서는 다섯 과제 모두 첫 판정이 실패였고 마지막 판정은 통과였습니다. 그중 네 과제는 고친 코드를 그대로 둔 채 허용 항목만 바꿔 통과로 바뀌었고, 그 항목에는 사람 확인 기록이 없었습니다. 그래서 사람 확인 칸(r-allow)과 REQUIRE_REVIEW=1을 넣었습니다(F절). 최종 판정은 주최 측 채점이 했습니다.In the finals, the first run failed and the last run passed on all five tasks. On four of them the fixed code stayed the same and only allowlist entries changed, and none of those entries had a review record. So I added the human check (r-allow) and REQUIRE_REVIEW=1 (section F). The organizers' grading made the final call.
본선 뒤 고친 것Fixed since the finals
- 허용 목록이 다른 소스의 고전 줄을 덮을 수 있음: 경고·엄격 설정 실패·항목 정리로 막음(기본 설정 판정은 그대로)An allowlist could cover classical lines in other code: now a warning, a strict-mode failure and entry cleanup stop it (the default verdict stays the same)
- 시험 파일 기준이 스캐너마다 다름: 한 규칙으로 맞춤Each scanner had its own test-file rule: now they share one
- 본 소스 패키지 이름(com/example 등)이 시험 경로로 잡힘: src/main 아래는 시험으로 보지 않고, 예제·목업류 폴더는 트리 맨 위만 봄Main-source package names (com/example and the like) were read as test paths: nothing under src/main counts as a test now, and example or mock folders count only at the top of the tree
- 고친 판에서 지운 파일을 가리킨 허용 항목이 원본 줄을 가림: 안 쓰인 항목으로 세어 엄격 설정에서 실패An allowlist entry pointing at a file deleted in the fixed tree could hide original lines: it now counts as an unused entry and fails strict mode
- 증적의 새 칸을 지워 옛 증적처럼 보이게 하는 위조: 증적 확인에서 실패Forged evidence with the new fields deleted, to pass as the old format: the evidence check now fails it
- 11월 교차 리뷰에서 찾은 우회 X01~X10(legacy 이름·주석 뒤에 숨긴 키 생성, src/main 아래 vendor·build 이름 패키지, 트리 밖을 가리키는 링크 등): 규칙 빈틈과 함께 0.2.0 규칙 묶음 2에서 막고 새 변이 시험 25건(m12~m29b)으로 고정Bypasses X01 to X10 from the November review (key generation hidden behind a legacy name or comment, packages named vendor or build under src/main, links that point out of the tree and more): closed in ruleset 2 of 0.2.0 together with the rule gaps, and pinned by 25 new mutation cases (m12 to m29b)
범위: 공개 예제와 저장소 안 시험 고정물만 씁니다. 숫자는 공개 뒤 깨끗한 사본을 macOS(arm64)에서 다시 돌린 값입니다. CBOM 스캐너 자체 단언은 166/166개 통과(실패 0, 건너뜀 0)입니다. 같은 시험을 GitHub Actions가 ubuntu·macOS와 Python 3.9~3.15에서 돌립니다(G절 CI 탭). CI에서 OpenSSL 3.5 미만은 ubuntu-24.04(Python 3.9, OpenSSL 3.0.13) 하나라, 여기서만 스캐너의 ML-KEM·ML-DSA 단언 4개를 허용된 건너뜀으로 두고 TLS 교차 확인을 '교차 확인 불가'로 적습니다.Scope: the public examples and the fixtures in this repository only. The numbers come from a clean copy rerun after release on macOS (arm64). The CBOM scanner's own assertions: 166 of 166 passed (0 failed, 0 skipped). GitHub Actions runs the same tests on ubuntu and macOS with Python 3.9 to 3.15 (CI tab in section G). The only CI job below OpenSSL 3.5 is ubuntu-24.04 (Python 3.9, OpenSSL 3.0.13); there alone the four ML-KEM and ML-DSA scanner assertions are allowed skips and the TLS cross-check is recorded as not possible.
E · 대응표: KISA AI 보안 매뉴얼과 PQC 기준Mappings: KISA AI security manual and PQC standards
PQC 도구를 AI 보안 매뉴얼에 맞춰 보는 까닭: 전환은 AI 에이전트가 하고 이 도구는 에이전트가 낸 결과를 받아들이기 전에 앞단에서 확인합니다. 그래서 에이전트가 판정을 속이거나 통제를 벗어나는 위협이 이 도구의 일과 겹칩니다.Why a PQC tool maps to an AI security manual: an AI agent does the migration, and this tool checks the agent's result before anyone accepts it. Threats where an agent games the verdict or slips out of control overlap with this tool's job.
과학기술정보통신부·KISA 「AI 보안 위협 대응 매뉴얼」(2026. 7)이 꼽은 위협마다 PQ-Proof 검증 도구와 PQ-Proof Agent가 어떻게 대응하는지 정리한 표입니다. 이 표는 대응을 정리한 것일 뿐 판정 결과가 아닙니다. 과학기술정보통신부·KISA가 검토하거나 승인하지도 않았습니다. 행마다 요약만 보이고 '자세히'를 누르면 남은 일과 근거가 펼쳐집니다. 검증 도구 근거의 함수 줄 번호(L)는 이 페이지와 같은 판의 코드에서 생성기가 찾아 넣었고 PQ-Proof Agent 근거는 다른 저장소라 파일과 함수 이름까지 적었습니다.For each threat in the 「AI Security Threat Mitigation Manual」 (Ministry of Science and ICT and KISA, July 2026), how the PQ-Proof check and PQ-Proof Agent respond. It records responses only; it is not a verdict on compliance. The Ministry of Science and ICT and KISA have not reviewed or endorsed it. Each row shows a summary; "More" opens what is still to do and the evidence. For the verifier, the generator looked up each function's line (L) in the code of the same version as this page; PQ-Proof Agent evidence lives in another repository and names files and functions only.
| ID | 위협Threat | 검증 도구Check | 에이전트Agent | 대응Response | 근거Evidence |
|---|
PQC 기준 대응PQC standards mapping
국내외 PQC 공개 문서의 항목마다 PQ-Proof가 무엇을 확인하는지 정리했습니다. 원본은 공개 저장소의 mappings/이고, 근거로 적은 함수·규칙 이름이 코드에 없으면 시험이 실패합니다. 제품이 그 문서를 충족한다는 뜻이 아니며 발행처가 검토하지 않았습니다. KISA 양자내성암호 전환 가이드는 아직 발간되지 않아 빈 표로 두고, 발간되면 같은 꼴로 항목을 채웁니다.For each item of public PQC documents, what PQ-Proof checks. The source is mappings/ in the repository, and a test fails when a function or rule named as evidence is missing from the code. It does not say that a product meets the document, and the publishers have not reviewed it. The KISA PQC migration guide is not published yet, so its table is empty until it is.
| ID | 항목Item | 상태Status | 대응Response | 근거Evidence |
|---|
F · 허용 목록과 사람 확인Allowlist and human review REQUIRE_REVIEW=1
전환 전 데이터를 읽기만 하는 복호 경로처럼 일부러 남기는 기존 공개키 줄이 있습니다. 이런 줄은 사유와 함께 허용 목록(ALLOW=notes/unconverted.json)에 적습니다. 도구는 그 줄을 허용으로 세고 사유를 증적에 옮겨 적습니다. 허용 범위 안에서 새 키·서명·암호문을 만드는 줄은 검토 필요로 갑니다.Some classical lines stay on purpose, for example a read-only path that decrypts records sealed before the migration. List them with a reason in an allowlist (ALLOW=notes/unconverted.json). The tool counts those lines as allowed and copies each reason into the evidence. A listed line that creates new keys, signatures or ciphertext goes to "needs review" instead.
사람이 사유를 읽습니다A person reads the reasons
도구는 사유가 맞는지 모릅니다. 사람이 읽고 reviewed_by(이름·계정)와 reviewed_at(ISO 8601)을 적습니다.The tool cannot tell whether a reason is true. A person reads each one and records reviewed_by (name or account) and reviewed_at (ISO 8601).
맨 위에 한 번 적으면 digest도One pair at the top needs a digest
목록 맨 위에 적을 때는 실행이 찍어 주는 16자 reviewed_digest를 옮겨 적습니다.A pair at the top of the file also needs reviewed_digest, the 16-character hash each run prints.
확인 뒤 고치면 다시 확인 전Edits after review reset it
에이전트가 항목을 더하거나 고치면 digest가 맞지 않아, 맨 위 칸을 물려받던 항목이 모두 확인 전으로 돌아갑니다.If an agent adds or edits an entry, the digest stops matching and every entry under the top pair counts as not reviewed again.
증적과 --verify에 남습니다It lands in the evidence
두 칸은 receipt.json과 증적 해시에 들어가고 --verify가 함께 남긴 허용 목록 사본과 맞춰 봅니다.Both fields go into receipt.json and its hash, and --verify checks them against the saved copy of the allowlist.
{
"reviewed_by": "j.kim",
"reviewed_at": "2026-11-18T10:30:00+09:00",
"reviewed_digest": "ad6b261a210da44d",
"unconverted": [
{"where": "src/main/java/x/Box.java:11-15",
"why": "reads records sealed before the migration, writes nothing",
"kind": "fallback"},
{"where": "tools/export.py:40-52",
"why": "exports old signatures for the archive",
"kind": "kept",
"reviewed_by": "s.lee", "reviewed_at": "2026-11-17"}
]
}
두 칸은 누군가 입력한 기록일 뿐, 누가 입력했는지는 도구가 모릅니다. 허용 목록을 쓰는 에이전트가 칸과 digest를 채울 수도 있으니 이 단계는 사람에게 두고 실무 검토는 REQUIRE_REVIEW=1로 돌리세요.The fields record what someone typed; the tool cannot tell who typed it. An agent that writes the allowlist can fill them and compute the digest too, so keep this step with a person and run real reviews with REQUIRE_REVIEW=1.
G · 빠른 시작과 명령Quick start and commands MIT
Python 3.9 이상(표준 라이브러리만), bash 3.2 이상, OpenSSL이 있으면 됩니다. TLS 교차 확인은 OpenSSL 3.5 이상, TLS 탐침을 빌드할 때만 Go 1.27 이상이 필요합니다.You need Python 3.9 or later (standard library only), bash 3.2 or later and OpenSSL. The TLS cross-check wants OpenSSL 3.5 or later, and Go 1.27 or later is only needed to build the TLS probe.
# 받아서 예제로 돌려 보기(인터넷은 받을 때만 씀)get it and try the examples (the network is used only to clone) git clone https://github.com/g1mn/pqproof && cd pqproof bash prove.sh examples/classic examples/pqc # 내 서비스: 전환 전 폴더(또는 zip)와 전환 후 폴더your service: the tree (or zip) before and after the migration REQUIRE_REVIEW=1 ALLOW=notes/unconverted.json bash prove.sh orig/ fixed/ # 전환 뒤 한 트리만 정기 점검(원본 없음, 0.2.0부터)guard one tree after the migration (no original, from 0.2.0) bash prove.sh --check fixed/ # 판정 없이 첫 현황 조사(inventory.json, 0.2.0부터)first survey with no verdict (inventory.json, from 0.2.0) bash prove.sh --inventory orig/ # KpqC 구현을 참조판 KAT와 대조(0.3.0부터): 문제지, 내 하네스의 답안, 판정(KpqC impl 탭)check a KpqC implementation against reference KATs (from 0.3.0): question sheet, your harness's answers, judge (KpqC impl tab) bash prove.sh --impl prompt --param smaug-t/mode3 -o prompt.json FAIL_ON_REVIEW=1 bash prove.sh --impl judge answers.json
# 1. 문제지(KAT 발췌로 만든 문항, prompt_sha256)1. question sheet (items from the KAT excerpts, prompt_sha256) pqproof impl prompt --param smaug-t/mode3 --param ntruplus/768 -o prompt.json # 2. 내 하네스가 답안을 씀(예제 하네스는 NIST API 공유 라이브러리를 ctypes로 부름)2. your harness writes the answers (the example harness loads NIST API shared libraries through ctypes) h=$(python3 -c 'import os, pqproof; print(os.path.join(os.path.dirname(pqproof.__file__), "_tool", "examples", "impl", "kpqc_harness.py"))') python3 -I "$h" prompt.json answers.json --lib smaug-t/mode3=./libsmaugt-mode3.so --lib ntruplus/768=./libntruplus768.so # 3. 판정(CI에서는 FAIL_ON_REVIEW=1: 옛 판과만 일치하면 종료 5)3. judge (in CI, FAIL_ON_REVIEW=1: a match with an old version only exits 5) FAIL_ON_REVIEW=1 pqproof impl judge answers.json pqproof impl judge PQCkemKAT_smaugt_mode3.rsp # PQCgenKAT .rsp 전체도 됨a whole PQCgenKAT .rsp works too pqproof impl judge answers.json --pq-verify "--audit-kem ./libmlkem768.so ML-KEM-768" # 선택: NIST 감사(i-nist)optional: NIST audit (i-nist)
$ pqproof impl prompt --param smaug-t/mode3 -o prompt.json $ python3 -I "$h" prompt.json answers.json --lib smaug-t/mode3=./1.2.0/libsmaugt-mode3.dylib kpqc_harness: 20 answers for 20 items -> answers.json $ pqproof impl judge answers.json == PQ-Proof 0.5.0 구현 검증(KpqC KAT 대조) (2026-11-21 20:47:36 KST) [arm64] … 판정 기준: PROFILE=kpqc · 받아 줄 판 smaug-t/mode3@1.2.0 · 문제지 20문항 [i-kpqc] 통과 smaug-t/mode3 통과: 1.2.0 일치(문항 10/10) [i-nist] 해당 없음 --pq-verify 를 주지 않았다(NIST 구현 감사를 하지 않음) smaug-t/mode3: 1.2.0(받아 줌) 10/10 · 1.1.1 5/10 첫 불일치 smaug-t/mode3@1.1.1#0:derand pk 자기 점검: 통과(정답 답안 통과, 한 바이트 바꾼 답안 실패) VERDICT=PASS receipt_id=f646c772d666… 검사 2개: i-kpqc 통과 · i-nist 해당 없음 (통과로 세는 것은 '통과'뿐, 해당 없음은 판정을 바꾸지 않는다) · 도구 0.5.0 · 규칙 묶음 6 · 증적 형식 4 … 검증 증적 다시 확인: ok (20개 검사) # 옛 판 1.1.1로 빌드한 구현이면an implementation built from the old version 1.1.1 $ python3 -I "$h" prompt.json answers-111.json --lib smaug-t/mode3=./1.1.1/libsmaugt-mode3.dylib kpqc_harness: 20 answers for 20 items -> answers-111.json $ FAIL_ON_REVIEW=1 pqproof impl judge answers-111.json … [i-kpqc] 검토 필요 smaug-t/mode3 검토 필요: 옛 판 1.1.1 일치(문항 10/10): 받아 줄 판(1.2.0)이 아니다(…) [i-nist] 해당 없음 --pq-verify 를 주지 않았다(NIST 구현 감사를 하지 않음) smaug-t/mode3: 1.2.0(받아 줌) 5/10 첫 불일치 smaug-t/mode3@1.2.0#0:derand pk · 1.1.1 10/10 … VERDICT=PASS (needs review: i-kpqc) receipt_id=fd9be540c801… … $ echo $? 5
지원 환경Where it runs
| 시스템System | 두 트리 판정Judge two trees | pqproof impl | --verify · sarif |
|---|---|---|---|
| Linux · macOS | yes bash, OpenSSL(TLS 교차 확인은 3.5 이상)bash, OpenSSL (3.5 or later for the TLS cross-check) | yes | yes |
| Windows | WSL WSL 안에서(바로 돌리면 종료 2와 안내)inside WSL (a direct run exits 2 with a note) | yes Python만으로(pq-verify는 macOS·Linux에서만)Python alone (pq-verify by itself runs on macOS and Linux) | yes Python만으로Python alone |
명령Commands
pqproof check). 전환 뒤 기존 알고리즘이 다시 들어오지 않게 막는 정기 점검용입니다. 두 트리를 대조하는 검사는 해당 없음으로 남으므로 TLS 약화(b-weakening)와 검증 제거(r-review)는 보지 않습니다. 전환 PR에는 두 트리 실행을 그대로 두세요.Judges one tree as it is now, with no original (pqproof check), as a guard that keeps classical algorithms from coming back after the migration. The two-tree checks stay not applicable, so it does not look at TLS weakening (b-weakening) or removed verification (r-review). Keep the two-tree run on migration pull requests.pqproof inventory). 결과는 inventory-out-<시각>/inventory.json입니다. 전환을 시작하기 전 첫 현황 조사용입니다.Counts the CBOM, the classical lines in the nine families and the PQC name lines, with no verdict (pqproof inventory). The result is inventory-out-<time>/inventory.json, for a first survey before a migration starts.pqproof impl, 0.3.0부터). 문제지 → 내 하네스의 답안 → 판마다 KAT 대조. 구현은 빌드하지도 실행하지도 않습니다.KpqC implementation check (pqproof impl, from 0.3.0). Question sheet → your harness's answers → a KAT match per version. It never builds or runs the implementation.tls_probe를 Go 표준 라이브러리로 빌드합니다. 아무것도 내려받지 않습니다.Builds the tls_probe TLS probe from the Go standard library. Downloads nothing.PROFILE이 정합니다.What the migrated tree must have: post-quantum key exchange, post-quantum signatures, hybrid TLS, a post-quantum TLS certificate. PROFILE decides what counts.impl_accept가 정합니다(0.3.0).Algorithm profile (from 0.2.0). The default, nist-cat3, counts ML-KEM-768 or 1024 and ML-DSA-65, 87 or SLH-DSA 192 or 256 (0.4.0); cnsa2 counts only ML-KEM-1024 and ML-DSA-87, and b-tls offers SecP384r1MLKEM1024 alone; kpqc also counts the Korean KpqC algorithms. No profile lets a classical line pass. In the implementation check, impl_accept in the kpqc profile says which versions are accepted (0.3.0).bash prove.sh --help.Key exchange only; require old clients to be refused. Full list: bash prove.sh --help.pip으로 설치하면 bash prove.sh 대신 콘솔 명령 pqproof를 씁니다. 같은 파일을 돌리고 인자도 같습니다(pqproof orig/ fixed/, pqproof --verify <out>). 필요한 프로그램 점검은 pqproof doctor, SARIF 출력은 pqproof sarif <out>, 한 트리 점검은 pqproof check <tree>, 현황 조사는 pqproof inventory <tree>입니다. 원본 폴더 이름이 check나 inventory이면 ./check처럼 적습니다. KpqC 구현 검증은 pqproof impl prompt|judge입니다(0.3.0).After a pip install, use the console command pqproof in place of bash prove.sh. It runs the same files with the same arguments (pqproof orig/ fixed/, pqproof --verify <out>). pqproof doctor checks the programs it needs, pqproof sarif <out> writes SARIF, pqproof check <tree> judges one tree and pqproof inventory <tree> takes a survey. An original folder named check or inventory goes in as ./check. The KpqC implementation check is pqproof impl prompt|judge (0.3.0).
H · 한계와 남은 위험Limits and open risks 먼저 읽기read first
통과는 이 규칙으로 찾은 것이 없다는 뜻이지 규칙이 옳거나 빠짐없다는 보장은 아닙니다. 알려진 한계를 그대로 적습니다.A pass means these rules found nothing. It does not show that the rules are right or complete. These are the known limits.
REQUIRE_REVIEW=1이면 실패합니다.Lines an entry covers leave the count. The tool cannot tell whether a reason is true or whether the named person read it. A migration agent can widen the allowlist instead of fixing code to get a pass, and that happened in my own finals work (section D). An entry that covers no line in the fixed tree, including one that points at a deleted file, only warns by default and fails with REQUIRE_REVIEW=1.test/·tests/·testdata/는 어느 깊이에서나, examples/·fixtures/·mocks/ 같은 폴더는 트리 맨 위에 있을 때만 시험으로 셉니다. src/main/ 아래는 시험으로 보지 않습니다. 0.2.0부터 .test.tsx, Django tests.py, __mocks__, *_spec.rb 같은 프레임워크 시험 파일도 시험으로 세고, 주석은 언어별로 읽습니다. 운영 코드가 시험 경로에 있으면 c-classic이 따로 보여 주는 시험 경로 줄을 읽으세요.Regular expressions plus some variable tracking. Java, Go, Python, Node and nginx get the most coverage; other languages get what cbom-scan.sh and residue.sh can see. test/, tests/ and testdata/ count as tests at any depth, and folders like examples/, fixtures/ and mocks/ only at the top of the tree. Nothing under src/main/ counts as a test. From 0.2.0, framework test files such as .test.tsx, Django tests.py, __mocks__ and *_spec.rb count as tests too, and comments are read per language. If production code sits in a test path, read the test-path lines c-classic lists.구현 검증의 한계Limits of the implementation check
.rsp 전체를 권합니다.Without derand answers a signature set passes on its verify answers alone (twenty true or false values for five records, half on a signature with one changed byte). The KATs are public, so such answers can be written with no implementation. A KEM set passes on decaps answers alone. Give derand answers or a full .rsp.--verify를 통과합니다(receipt_id는 달라짐). 믿을 경로로 받은 receipt_id와 비교합니다. --verify는 감사를 다시 돌리거나 라이브러리를 다시 해시하지 않습니다.A folder with every copy and hash rewritten passes --verify (with another receipt_id). Compare receipt_id with one you got through a channel you trust. --verify does not rerun the audit or rehash the library.실무 검토는 REQUIRE_REVIEW=1로 돌리고 허용 목록 확인은 사람이 하기를 권합니다. 정책 값과 호스트 설정은 실행 중인 서비스에서 따로 확인하세요. 구현 검증은 derand 답이나 .rsp 전체로 돌리고 CI에서는 FAIL_ON_REVIEW=1을 켭니다.For real reviews, run with REQUIRE_REVIEW=1 and keep the allowlist review with a person. Check policy values and host settings on the running service separately. Run the implementation check with derand answers or a full .rsp, and set FAIL_ON_REVIEW=1 in CI.
I · 버전과 유지보수Versions and maintenance SemVer · 0.5.0
판정이 언제, 왜 바뀌었는지 나중에도 따라갈 수 있게 버전을 관리합니다. 첫 공개는 0.1.0이었고 지금 판은 0.5.0(규칙 묶음 6, 증적 형식 4)입니다. 버전은 패키지의 __version__ 한 곳에서만 정합니다.Versioning lets you tell later when and why a verdict changed. The first release was 0.1.0; this one is 0.5.0 (ruleset 6, evidence format 4). The version is set in one place, the package's __version__.
릴리스와 판정 영향Releases and verdict impact
- 스캐너 원본 출력(
artifacts/)에도 비밀 값을 가립니다. 전에는residue-*.txt가 소스 줄을 그대로 옮겼고, CBOM 발췌는secret_key값·AWS 접근 키·이름 없는 토큰을 놓쳤으며,ssh-keygen -N암호는 표에서도 남았습니다. 이제 두 셸 스캐너가 같은 가림 함수 하나를 쓰고, 표·SARIF와 같은 값을 가립니다. 입력 사본in/(zip 입력)만 원문입니다.Secret values are hidden in the scanner output underartifacts/too. Before,residue-*.txtquoted source lines as they were, the CBOM excerpts missed asecret_keyvalue, AWS access key IDs and bare tokens, and anssh-keygen -Npassphrase stayed even in the tables. Now both shell scanners share one mask that hides the same values as the tables and SARIF. Only the input copyin/of a zip input keeps the original. - PQ-Proof가 공개한 증적(사이트, 예제, golden 증적)에는 실제 비밀 값이 없습니다. 0.5.0 전에 비밀이 든 코드로 만든 증적 폴더를 넘겼다면
artifacts/residue-*.txt와artifacts/cbom-*/를 확인하고, 찾은 값은 바꾸세요.The evidence PQ-Proof published (the site, the examples, the golden evidence) holds no real secret. If you shared an evidence folder made before 0.5.0 from code with secrets, checkartifacts/residue-*.txtandartifacts/cbom-*/and rotate what you find. - 보안 공지: GHSA-6jq9-vjc7-xwm2(심각도 낮음, CVSS 3.3, 0.4.1 이하에 해당).Security advisory: GHSA-6jq9-vjc7-xwm2 (low, CVSS 3.3, affects 0.4.1 and earlier).
- golden 41건은 판정·상태·개수가 그대로입니다. 판정이 바뀔 수 있는 곳은 1MiB를 넘는 파일 하나뿐입니다. PQ-Proof가 그 줄을 직접 못 읽어 residue 발췌를 쓰는데, 그 발췌가 이제 가려지기 때문입니다.The 41 golden cases keep every verdict, status and count. A verdict can move only for a file over 1 MiB, where PQ-Proof cannot read the line itself and uses the residue excerpt, which is now masked.
- 주석이 규칙 묶음 이름을 바꾸지 않습니다. 규칙 묶음 5부터 주석을 뺀 해시를 함께 적고, 주석만 고친 판은 같은 이름의 별칭으로 받습니다.
--verify는 예전처럼 파일 해시로 다시 계산하고, 규칙 묶음 1~4 증적도 그대로 검증됩니다.Comments no longer rename a ruleset. From ruleset 5 the record keeps the hash without comments, and an edit that changes only comments is an alias of the same name.--verifystill recomputes from the file hashes, and evidence from rulesets 1 to 4 verifies as before. - 주석 정리: 변경 기록과 겹치는 이력, 낡은 숫자, 코드를 되풀이하는 줄을 지웠습니다. '이 파일과 같아야 한다'는 주석은 그것을 지키는 시험으로 옮기고, 실패 메시지가 무엇을 함께 고칠지 알려 줍니다. 린트 규칙 다섯을 더했습니다.Comment cleanup: history that repeats the changelog, stale numbers and lines that restate the code are gone. "Must match" notes moved into the tests that enforce them, whose failure messages say what to change together. Five lint rules were added.
- 스캐너 원본 출력의 비밀 값 가림이 표·SARIF보다 좁은 곳 셋(
secret_key값, AWS 접근 키, 이름 없는 GitHub 토큰)을 시험으로 고정했습니다. 다음 규칙 묶음에서 고칩니다.Three places where the scanner's raw output hides less than the tables and SARIF (asecret_keyvalue, an AWS access key ID, a bare GitHub token) are pinned by a test until a later ruleset fixes them.
- FIPS 205 SLH-DSA: 192·256 파라미터 세트를 기대 서명으로 셉니다(nist-cat3·kpqc, 규칙 E-SLHDSA). 보안 등급 1인 SLH-DSA 128은 보안레벨 3 미만으로 막습니다. CBOM 스캐너가 SLH-DSA의 DSA를 기존 DSA로 읽던 것도 고쳤습니다.FIPS 205 SLH-DSA: the 192 and 256 parameter sets count as an expected signature (nist-cat3 and kpqc, rule E-SLHDSA), and SLH-DSA 128, category 1, is blocked as below category 3. The CBOM scanner no longer reads the DSA in SLH-DSA as classical DSA.
- 0.3.0의 golden 트리 39건은 판정, 검사 상태, 개수가 그대로이고 새 개수 E-SLHDSA 0만 더해졌습니다. 새 변이 사례 둘(192 통과, 128 실패)이 바뀌는 곳을 보입니다.The 39 golden tree cases of 0.3.0 keep every verdict, check status and count and gain only a new count, E-SLHDSA 0. Two new mutation cases (192 passes, 128 fails) show what moves.
- PQC 기준 대응표
mappings/(NIST IR 8547, 2026 시범전환 공모안내서, 발간 전 KISA 가이드용 빈 표)와 로드맵, 첫 기여 안내를 더했습니다(E절).PQC standards mappings inmappings/(NIST IR 8547, the 2026 Korean pilot migration call, and an empty table for the KISA guide until it is published), a roadmap and a first-contribution guide (section E).
- 새 명령
pqproof impl: KpqC 구현(SMAUG-T·NTRU+·HAETAE·AIMer)의 답안을 고정한 참조판 KAT와 대조해 어느 판과 일치하는지 적습니다(검사 i-kpqc). pq-verify는 따로 설치하는 도구이고,--pq-verify를 주면 그 NIST PQC 라이브러리 감사도 같은 증적에 담깁니다(검사 i-nist).New commandpqproof impl: it compares the answers of a KpqC implementation (SMAUG-T, NTRU+, HAETAE, AIMer) with pinned reference KAT versions and names the version they match (check i-kpqc). With--pq-verify, the NIST PQC library audit by pq-verify, a tool you install yourself, goes into the same evidence (check i-nist). - 0.2.0의 golden 트리 39건은 판정, 검사 상태, 개수가 그대로입니다. 규칙 묶음 3은 KAT 목록·발췌와 구현 검증 모듈을 더해 파일 14개를 덮습니다.The 39 golden tree cases of 0.2.0 keep every verdict, check status and count. Ruleset 3 adds the KAT list, its excerpts and the implementation check module, so its hash covers fourteen files.
- 11월 교차 리뷰에서 찾은 우회 X01~X10과 규칙 빈틈(X11, X18~X28 등)을 막았습니다. 새 golden 19건은 우회나 오탐을 하나씩 심은 경우이고 0.1.1은 그 모두에서 판정이나 검사 상태가 다릅니다.Closes the bypasses X01 to X10 from the November review and the rule gaps (X11, X18 to X28 and more). Nineteen new golden cases each plant one bypass or false positive, and 0.1.1 gives a different verdict or check status on every one.
- 0.1.1의 golden 트리 14건은 판정과 검사 상태가 그대로이고 개수만 네 곳에서 바뀝니다. 예를 들어 꼬리
#주석을 코드로 세지 않아 예제의 E-MLKEM768이 3에서 2로 줄고, PQC 값으로 확인된 a-cbom '확인' 행이 정보로 바뀌어 4에서 0이 됩니다.The 14 golden tree cases of 0.1.1 keep their verdicts and check statuses; counts move in four places. For example, a trailing#comment no longer counts as code, so E-MLKEM768 in the example drops from 3 to 2, and a-cbom "check" rows traced to a post-quantum value become informational (4 to 0). - 새 명령 check·inventory, 새 설정 PROFILE·FAIL_ON_REVIEW·REQUIRE_RESOLVED·EXPECT_FROM·REVIEW_MAX_AGE_DAYS·MAX_FILE_MIB, 종료 코드 4·5, 출력 폴더의 README.txt가 생겼습니다. 판정 규칙이
pqlite/rules.py로 옮겨 가 규칙 묶음 해시가 파일 11개를 덮습니다.New commands check and inventory, new settings PROFILE, FAIL_ON_REVIEW, REQUIRE_RESOLVED, EXPECT_FROM, REVIEW_MAX_AGE_DAYS and MAX_FILE_MIB, exit codes 4 and 5, and a README.txt in the output folder. The verdict rules moved topqlite/rules.py, and the ruleset hash now covers eleven files.
- 11월 리뷰의 수정·시험·CI·문서입니다. 규칙 파일은 바뀌지 않았고 golden 트리 14건의 판정, 검사 상태, 개수가 0.1.0과 같습니다.Fixes, tests, CI and documentation from the November review. No rule file changed, and the 14 golden tree cases keep every verdict, check status and count of 0.1.0.
- 원래 올바른 판정이 없던 두 곳만 종료 코드가 바뀌었습니다. 이름이 겹치는 zip은 입력 오류(2)이고, 없는 폴더에
--verify를 하면 1 대신 2로 끝납니다.Exit codes moved in two places that never had a sound verdict: a zip with clashing entry names is an input error (2), and--verifyon a missing folder exits 2 instead of 1.
- 본선에서 쓴 판을 공개용으로 정리한 첫 릴리스입니다. 본선 뒤 고친 것은 D절에 있습니다.The first release, cleaned up for the public from the version used in the finals. The fixes since the finals are listed in section D.
receipt.json에 도구 버전, 규칙 묶음 이름과 해시, 증적 형식 버전을 적습니다. 규칙 묶음 6의 해시는 스캐너 패턴, 시험 경로, residue 규칙에 판정 규칙(pqlite/rules.py), TLS 대상 판정, 건너뛸 폴더 목록, 알고리즘 프로필, KpqC 참조판 KAT 목록·발췌와 구현 검증 모듈(pqlite/impl.py)까지 파일 14개를 덮습니다. 규칙 묶음 5부터는 주석을 뺀 해시도 함께 적어, 주석만 고친 판은 같은 이름의 별칭으로 받습니다(판정 규칙이 그대로면 이름도 그대로). 몇 년 뒤에 증적을 열어도 어느 규칙으로 판정했는지 알 수 있습니다.receipt.json records the tool version, the ruleset name and hash, and the evidence format version. The ruleset 6 hash covers fourteen files: scanner patterns, test paths and residue rules, plus the verdict rules (pqlite/rules.py), the TLS target verdict, the skipped-folder list, the algorithm profiles, the KpqC reference KAT list with its excerpts and the implementation check module (pqlite/impl.py). From ruleset 5 the record also keeps the hash without comments, so an edit that changes only comments is an alias of the same name (same rules, same name). Years later, the evidence still tells you which rules made the verdict.--verify는 증적 형식 1·2·3·4를 모두 읽고, 증적이 이름 붙인 규칙 묶음의 파일로 해시를 다시 계산합니다. 0.1.0 이전 공개본(형식 1), 0.1.0·0.1.1(형식 2), 0.2.0(형식 3), 0.3.0 구현 검증(형식 4)이 남긴 증적을 시험 고정물로 둡니다(D절). 형식을 바꾸면 형식 버전을 올리고 옛 판 읽기는 그대로 둡니다.--verify reads evidence formats 1 to 4, and recomputes the ruleset hash from the files of the ruleset each receipt names. Evidence from the pre-0.1.0 public copies (format 1), 0.1.0 and 0.1.1 (format 2), 0.2.0 (format 3) and the 0.3.0 implementation check (format 4) stays in the tests as fixtures (section D). A format change bumps the format version, and old formats stay readable.release.yml이 CI 전체를 먼저 돌린 뒤 sdist·wheel, tls_probe 4종(0.1.1부터 Intel Mac 포함), SHA256SUMS를 만듭니다. GitHub artifact attestation과 PyPI Trusted Publishing 증명, 도구 자신의 SBOM(CycloneDX)과 그 증명을 붙입니다. PyPI 배포에는 저장해 둔 토큰을 쓰지 않습니다. 0.2.0부터 패키지에 탐침 SHA256SUMS가 들어가 TLS 실행이 릴리스 빌드 탐침을 썼는지 증적에 적습니다. 받은 자산은 gh attestation verify <파일> --repo g1mn/pqproof로 확인합니다.Pushing a vX.Y.Z tag makes release.yml run the whole CI first, then build the sdist and wheel, four tls_probe binaries (Intel Mac added in 0.1.1) and SHA256SUMS. It attaches GitHub artifact attestations, the PyPI Trusted Publishing attestation, and an SBOM (CycloneDX) of the tool with its own attestation. Publishing to PyPI uses no stored token. From 0.2.0 the package carries the probe SHA256SUMS, and a TLS run records whether it used the release probe build. Check a downloaded asset with gh attestation verify <file> --repo g1mn/pqproof.J · 출처Sources
7b7803f 커밋(MIT)에서 가져왔고 그 파일 첫 줄에 적어 두었습니다.This repository. Some files come from g1mn/pq-proof at commit 7b7803f (MIT); those files say so in their first line.pqproof impl judge --pq-verify로 그 감사 결과를 같은 증적에 담습니다(i-nist).pq-verify by bigDSanalyst checks that a PQC implementation computes what the standard says. PQ-Proof checks that the service has been fully migrated. They look at different layers and complement each other. From 0.3.0, pqproof impl judge --pq-verify puts its audit into the same evidence (i-nist).| 판Version | 저장소와 커밋Repository and commit | 라이선스License | 공식 SHA-256Official SHA-256 | KAT 발췌KAT excerpts |
|---|---|---|---|---|
| SMAUG-T reference implementation 1.1.1 | CryptoLabInc/SMAUG-T @bbc463c | MIT | 일치matches | 발췌excerpts |
| SMAUG-T reference implementation 1.2.0 | CryptoLabInc/SMAUG-T @ae71979 | MIT | 일치matches | 발췌excerpts |
| HAETAE reference implementation 1.1.2 | CryptoLabInc/HAETAE @743c31d | MIT | 일치matches | 발췌excerpts |
| HAETAE reference implementation 1.2.0 | 공식 페이지의 내려받기 파일download linked from the official page | MIT | 일치matches | 발췌excerpts |
| NTRU+ reference implementation (KpqC final, files dated 2026-01-21) | ntruplus/reference @7166f57 | MIT | 공식 값 없음none published | 발췌excerpts |
| AIMer reference implementation V3.0 (AIM3) | samsungsds-opensource/AIMer @734cc76 | MIT | 공식 값 없음none published | 발췌excerpts |
| AIMer reference implementation, KpqC final package of 2026-01-30 (AIM2) | samsungsds-opensource/AIMer @e47c497 | MIT | 공식 값 없음none published | 발췌excerpts |
| Bouncy Castle test data, AIMer KAT files ('Round 2' implementation) | bcgit/bc-test-data @ee3d9c1 | 라이선스 없음no license | 공식 값 없음none published | 다이제스트만digests only |
scan/kat/NOTICE에 있습니다. Bouncy Castle 시험 자료는 라이선스 파일이 없어 다이제스트만 둡니다.The KAT excerpts (the first five records of each version) follow the MIT license of each reference implementation, and the NIST PQCgenKAT and rng.c notices are in scan/kat/NOTICE. The Bouncy Castle test data has no license file, so only digests are kept.K · 자주 묻는 질문FAQ
TLS_TARGETS를 주면 그 주소에만 접속합니다. 받은 소스는 읽기만 하고 실행하지 않습니다. 구현 검증에서 --pq-verify를 직접 켜면 pq-verify는 감사할 라이브러리를 불러 실행합니다. 다만 출력에 입력·도구·출력 폴더의 절대 경로가 적히니, 출력 폴더를 남에게 넘기기 전에 확인하세요.It uses no internet, servers or paid APIs; with TLS_TARGETS it connects to those addresses only. It reads the code without running it. If you turn on --pq-verify in the implementation check, pq-verify loads and runs the library it audits. The output does name absolute paths of the inputs, tools and output folder, so check them before you hand the folder to someone.pqproof impl judge --pq-verify로 pq-verify 감사 결과를 같은 증적에 담을 수 있습니다(pq-verify는 따로 설치).pq-verify checks that a PQC implementation computes correctly against the standard. PQ-Proof checks that the service code was fully migrated and that any classical public-key code left has a recorded reason. Different layers, so they work well together. From 0.3.0, pqproof impl judge --pq-verify puts a pq-verify audit into the same evidence (pq-verify checks the library; you install it yourself).7b7803f 커밋에서 가져왔습니다.g1mn/pq-proof is PQ-Proof Agent, entered in Vultr Agent Rush: an AI agent that runs migrations. This repository is the offline verdict tool used in the PQC Transition Hackathon finals. Some files come from that repository at commit 7b7803f.TLS_TARGETS를 주지 않으면 미판정으로 끝납니다. 클라이언트 쪽 TLS만 있으면 사람이 확인하도록 표시합니다.With no TLS signal, b-tls is not applicable. With a TLS signal and no TLS_TARGETS, the run is undecided. When a service only has client-side TLS, the tool flags it for a person to check.VERDICT=...)과 --verify 결과는 영어입니다. 파일과 칸 이름은 receipt.json, receipt_id처럼 receipt를 그대로 씁니다.Check lines and code comments are in Korean, as they were in the finals. The verdict line (VERDICT=...) and --verify results are in English. File and field names keep "receipt", as in receipt.json and receipt_id.pqproof check <tree>(bash prove.sh --check)는 한 트리의 지금 상태를 판정해 전환 뒤 기존 알고리즘이 다시 들어오는 것을 막습니다. 다만 check 모드는 두 트리를 대조하는 검사를 하지 않으므로 TLS 약화(b-weakening)와 검증 제거(r-review)를 보지 않습니다. 전환 PR에는 두 트리 실행을 계속 쓰세요. 판정 없이 현황만 세려면 pqproof inventory <tree>가 inventory.json을 남깁니다.From 0.2.0, yes. pqproof check <tree> (bash prove.sh --check) judges one tree as it is now, to keep classical algorithms from coming back after the migration. Check mode runs none of the two-tree checks, so it does not look at TLS weakening (b-weakening) or removed verification (r-review); keep the two-tree run on migration pull requests. To count what is there with no verdict, pqproof inventory <tree> writes inventory.json.--verify는 증적 형식 1·2·3·4를 모두 읽고 확인합니다. 증적에는 판정한 규칙 묶음 이름과 해시가 들어 있어 어느 규칙으로 판정했는지 남습니다. 0.4.x 증적은 0.5.0으로 다시 돌려도 판정이 같습니다. 0.5.0의 판정 영향은 1MiB를 넘는 파일의 가린 발췌 한 경우뿐입니다. 0.3.0 증적(형식 4)과 0.2.0 증적(형식 3)은 트리에 SLH-DSA 이름이 없으면 판정이 같습니다(0.4.0의 판정 영향은 SLH-DSA뿐). 0.1.x 증적은 0.2.0부터 판정이 달라질 수 있습니다(I절, 판정 영향 있음).The 0.5.0 --verify reads and checks evidence formats 1 to 4. Each receipt names the ruleset and its hash, so it still says which rules judged it. Evidence from 0.4.x gets the same verdict when run again with 0.5.0; its only verdict impact is the masked excerpt of a file over 1 MiB. Evidence from 0.3.0 (format 4) and 0.2.0 (format 3) gets the same verdict unless the trees name SLH-DSA (the only verdict impact of 0.4.0). Evidence from 0.1.x can get a different verdict from 0.2.0 on (section I, verdict impact yes).impl_accept가 정하고 기본은 최신판(latest)입니다. 옛 판과 일치한 답은 틀린 답이 아닙니다. 프로젝트가 따를 판을 PQ-Proof가 모르므로 판 이름을 적고 사람에게 넘깁니다. 그 판도 받으려면 impl_accept에 <세트>@<판>을 더합니다. 그 뒤 증적은 규칙 묶음 6+modified로 적히고 --verify도 같은 프로필로 합니다.The accepted versions come from impl_accept in the kpqc profile, latest by default. A match with an old version is not a wrong answer: PQ-Proof cannot know which version your project follows, so it names the version and leaves it to a person. To accept that version too, add <set>@<version> to impl_accept; receipts after that name ruleset 6+modified, and --verify needs the same profile.aim2-2026-01은 2026-01-30 KpqC 최종 배포판(AIM2)이고, 3.0(AIM3)은 그 뒤 팀이 GitHub에 올린 참조(커밋 734cc76)입니다. pk·sk·서명이 모두 다르고 서명 크기도 바뀌었습니다(128f 기준 5888 → 6944바이트). 목록은 팀이 낸 가장 새 참조를 최신으로 두므로 최종 배포판 구현은 기본이 검토 필요입니다. 국내 표준화가 어느 판을 고를지는 적지 않습니다.aim2-2026-01 is the KpqC final package of 2026-01-30 (AIM2); 3.0 (AIM3) is the reference the team put on GitHub afterwards (commit 734cc76). pk, sk and the signature all differ, and the signature size changed (5888 to 6944 bytes for 128f). The list marks the newest reference the team published as latest, so an implementation of the final package needs review by default. Which version Korean standardization adopts is not recorded here.VERDICT 줄만 읽는 CI는 FAIL_ON_REVIEW=1로 돌리고 5를 멈춤으로 봅니다. 구현 검증에서는 옛 판과만 일치한 구현이 이 경우입니다(D절 끝까지 시험 k3b)."Needs review" does not change the verdict, so the exit code is 0. A CI job that reads only the exit code or the VERDICT line should run with FAIL_ON_REVIEW=1 and treat 5 as a stop. In the implementation check, an implementation that matches only an old version is that case (end-to-end case k3b in section D).--pq-verify를 줄 때만 그 도구를 부릅니다. 주지 않으면 i-nist는 해당 없음입니다. 켰는데 실행 파일이 없으면 미판정입니다(셀프 시험 S11d). pq-verify는 판과 휠 해시로 고정해 설치합니다(guide/impl.md).No. PQ-Proof depends on no other tool at run time and calls pq-verify only when you pass --pq-verify; without it, i-nist is not applicable. With it and no executable, the run is undecided (self-test S11d). Install pq-verify by pinned version and wheel hash (guide/impl.md).mappings/kisa-pqc-guide.json)에 항목마다 원문을 인용해 충족·부분·공백을 적고, PQ-Proof가 메울 수 있는 공백은 새 판으로 냅니다. 같은 꼴의 표가 국가정보원·국가보안기술연구소의 「국가·공공기관 양자내성암호 전환 가이드북」 초안(2026-11-16 공개), NIST IR 8547, 2026 시범전환 공모안내서를 비롯한 10개 문서에 대해 이미 있습니다. 로드맵은 저장소의 ROADMAP.md에 있습니다.The guide is not published yet, and this site does not guess its contents. When it comes out, the empty table in section E, PQC standards mapping (mappings/kisa-pqc-guide.json), gets one row per guide item, quoting the text and marking covered, partial or gap, and a release closes the gaps PQ-Proof can close. Tables of the same shape already exist for ten documents, among them the draft PQC migration guidebook for national and public institutions from the National Intelligence Service and the National Security Research Institute (posted 2026-11-16), NIST IR 8547 and the 2026 Korean pilot migration call. The roadmap is ROADMAP.md in the repository.| PQ-Proof, pqproof | 도구, 그리고 Python 패키지와 그 명령 |
| 원본, 전환본 | 전환 전과 후의 트리 |
| 검사, 판정 | 두 트리 검사 8개(a-cbom, c-classic, b-weakening …)와 구현 검증 2개(i-kpqc, i-nist), 그리고 이들이 내는 판정 하나 |
| 막는 위치 | 전환본에서 사유 없이 남은, 양자 컴퓨터로 깨지는 공개키 사용 |
| 허용 목록 | 일부러 남기는 기존 공개키 줄의 목록(사유와 확인한 사람) |
| 검증 증적, 증적 해시 | 출력 폴더, 그리고 RFC 8785 꼴 receipt.json의 SHA-256인 receipt_id |
| 규칙 묶음 | 판정을 정하는 규칙 파일의 묶음. 그 해시가 모든 증적에 들어감 |
| PQ-Proof, pqproof | the tool; the Python package and its command |
| original, converted | the tree before and after the migration |
| check, verdict | eight checks for two trees (a-cbom, c-classic, b-weakening …), two in the implementation check (i-kpqc, i-nist), and the one verdict they give |
| blocking location | a quantum-breakable public-key use left in the converted tree with no recorded reason |
| allowlist | the classical lines kept on purpose, each with a reason and a reviewer |
| evidence, evidence hash | the output folder, and receipt_id, the SHA-256 of receipt.json in RFC 8785 form |
| ruleset | the rule files that decide verdicts; their hash is in every receipt |