Phase 5 Iteration 2: chữ ký số PKCS#7/PAdES + redact tỉa ký tự + lưu tối ưu
Engine — chữ ký số (sign.rs MỚI): - generate_self_signed_id: Digital ID tự ký RSA-2048 + X.509 (rcgen), ghi PEM - sign_pdf: đúng cơ chế Adobe — lopdf dựng sig dict (/SubFilter adbe.pkcs7.detached) + Widget field + AcroForm/SigFlags, ByteRange/Contents placeholder; serialize → vá ByteRange theo offset thật → SHA-256 trên 2 đoạn → CMS SignedData detached (crate cms, signed attrs messageDigest+contentType, RSA-SHA256) nhét DER vào Contents - verify_signatures: parse ByteRange/Contents, băm lại, kiểm chữ ký RSA trên signed attrs + messageDigest khớp + phủ toàn bộ file → phát hiện GIẢ MẠO - Bài học: cắt DER về đúng độ dài (bỏ padding hex '0'); bỏ qua /Contents của trang (tham chiếu), chỉ nhận /Contents <hex> của chữ ký Engine — redact tỉa theo KÝ TỰ (redact.rs): - Text chạm một phần: page_char_boxes xác định ký tự trong vùng, GIỮ các đoạn ngoài vùng, dựng lại đúng vị trí/baseline/màu (font nhúng gốc → cùng họ → mặc định). Guard: text xoay/không đọc được font → xoá nguyên (an toàn) - qpdf::optimize_save: --object-streams=generate + nén, dọn object rác Tauri + UI: - Commands: sig_create_id, sig_sign, sig_verify, security_optimize, pick_any_file, pick_save_pem - Thanh Bảo mật thêm: Tạo Digital ID, Ký số (dialog + tự kiểm tra sau khi ký), Kiểm tra chữ ký (modal bảng trạng thái + lý do), Lưu tối ưu Test (7 mới → 62/62 engine xanh ngoài 2 fixture qpdf Linux): - sign_then_verify_is_valid; tampering_after_signing_is_detected (phát hiện sửa sau khi ký); verify_reports_none_for_unsigned - redact tỉa ký tự: cụm mật biến mất, phần cùng dòng ngoài vùng vẫn còn - optimize_save không phình + giữ nội dung Deps: rsa, sha2, cms, x509-cert, rcgen, pkcs8, der, spki, const-oid. Docs: 15 mục 6 (iter 2 + giới hạn), 16 (S13–S19), README, roadmap (Phase 5 HOÀN TẤT), 14 (kế tiếp: Phase 6 Form). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HgnbPwSoRGNH7LHsDUmRpk
This commit is contained in:
+63
-12
@@ -1,8 +1,9 @@
|
||||
# 15 — Tổng kết Phase 5 (Bảo mật) · Iteration 1
|
||||
# 15 — Tổng kết Phase 5 (Bảo mật) · Iteration 1 + 2
|
||||
|
||||
> Trạng thái: **mã hoá + permissions, gỡ mật khẩu, redaction THẬT, xoá
|
||||
> metadata — hoàn tất, có test kiểm chứng nội dung thật sự biến mất.**
|
||||
> Chữ ký số (PAdES) là Iteration 2 — kế hoạch ở mục 5.
|
||||
> Trạng thái: **HOÀN TẤT Phase 5.** Iter 1: mã hoá + permissions, gỡ mật khẩu,
|
||||
> redaction THẬT, xoá metadata. Iter 2: **chữ ký số PKCS#7/PAdES (ký + xác
|
||||
> thực + phát hiện giả mạo), redaction tỉa theo KÝ TỰ, lưu tối ưu.**
|
||||
> 62/62 test engine xanh (ngoài 2 fixture qpdf Linux). Chi tiết iter 2 ở mục 6.
|
||||
|
||||
## 1. Khảo sát Foxit (chuẩn nghiệm thu)
|
||||
- **Protect › Password Protect**: user/owner password, AES-256, tick quyền
|
||||
@@ -70,11 +71,61 @@
|
||||
- Chưa xoá "hidden information" dạng attachment/script/comment ẩn — gộp
|
||||
vào Iteration 2.
|
||||
|
||||
## 5. Iteration 2 (kế tiếp của Phase 5) — Chữ ký số PAdES + Lưu tối ưu
|
||||
1. **Ký số**: tạo chữ ký PAdES-B (CMS/PKCS#7 qua crate `cms`/`rsa`/`p256`),
|
||||
ghi `/ByteRange` + placeholder `/Contents`, incremental update để không
|
||||
phá chữ ký cũ; xác thực bằng Acrobat làm DoD. Đọc chứng chỉ PFX/PKCS#12.
|
||||
2. **Xác thực chữ ký** khi mở (hiện trạng thái valid/invalid).
|
||||
3. **Lưu tối ưu** (từ docs/14 mục 3.3): subset font nhúng theo glyph dùng
|
||||
thật + `qpdf --object-streams=generate` dọn object rác sau edit.
|
||||
4. Redact tỉa theo ký tự (mục 4) + quét "hidden info" còn lại.
|
||||
## 5. (Đã thực hiện — xem mục 6.) Kế hoạch iteration 2 ban đầu
|
||||
|
||||
## 6. Iteration 2 — Chữ ký số + redact ký tự + lưu tối ưu (ĐÃ LÀM)
|
||||
|
||||
### 6.1 Chữ ký số PKCS#7/PAdES (`sign.rs`)
|
||||
- **`generate_self_signed_id(cn, out.pem)`**: tạo Digital ID tự ký RSA-2048 +
|
||||
X.509 (rcgen), ghi PEM bundle (cert + private key) — người dùng ký thử ngay
|
||||
không cần CA; có PFX/PEM thật thì nạp thẳng.
|
||||
- **`sign_pdf(input, id.pem, reason, name, output)`** đúng cơ chế Adobe:
|
||||
1. Chuẩn hoá qua qpdf → lopdf dựng signature dict
|
||||
(`/Type/Sig /SubFilter/adbe.pkcs7.detached`) với `/ByteRange` +
|
||||
`/Contents` placeholder, field chữ ký (Widget vô hình) + AcroForm/SigFlags.
|
||||
2. Serialize → định vị offset thật, vá `/ByteRange` (phần hex `<...>` của
|
||||
Contents bị loại khỏi digest, 2 dấu `<` `>` vẫn nằm trong vùng ký).
|
||||
3. SHA-256 trên 2 đoạn ByteRange → **CMS SignedData detached** (crate `cms`,
|
||||
signed attrs gồm messageDigest + contentType, ký RSA-SHA256) → nhét DER
|
||||
vào Contents.
|
||||
- **`verify_signatures(input)`**: với mỗi chữ ký — parse ByteRange/Contents,
|
||||
băm lại, kiểm (a) chữ ký RSA hợp lệ trên signed attrs, (b) messageDigest
|
||||
khớp digest file, (c) chữ ký phủ TOÀN BỘ file. `is_valid()` = cả 3 đạt.
|
||||
- Bài học: hex Contents có padding '0' → phải cắt DER về đúng độ dài (đọc
|
||||
length trường DER) trước khi parse; `/Contents` của TRANG (tham chiếu
|
||||
`N 0 R`) phải bỏ qua, chỉ nhận `/Contents <hex>` của chữ ký.
|
||||
|
||||
### 6.2 Redaction tỉa theo KÝ TỰ (`redact.rs`)
|
||||
- Text object bị vùng redact chạm MỘT PHẦN: dùng `page_char_boxes` (Phase 1)
|
||||
xác định ký tự nào nằm trong vùng, **giữ các đoạn ký tự ngoài vùng**, dựng
|
||||
lại đúng vị trí/baseline/màu (font: nhúng gốc → cùng họ → mặc định).
|
||||
- Guard an toàn: text XOAY/nghiêng (matrix b,c ≠ 0) hoặc không đọc được font →
|
||||
xoá NGUYÊN object (thà thừa còn hơn sót). Ảnh vẫn bôi đen pixel như iter 1.
|
||||
|
||||
### 6.3 Lưu tối ưu (`qpdf::optimize_save`)
|
||||
- `qpdf --object-streams=generate --compress-streams=y`: nén + dọn object mồ
|
||||
côi (rác sau edit/redact — object đã tách khỏi trang nhưng còn trong file).
|
||||
|
||||
### 6.4 UI + Tauri
|
||||
- Thanh Bảo mật thêm: **🪪 Tạo Digital ID**, **✍️ Ký số** (dialog tên/lý do/
|
||||
chọn .pem → tự kiểm tra sau khi ký), **🔎 Kiểm tra chữ ký** (modal bảng
|
||||
trạng thái hợp lệ/không + lý do), **📦 Lưu tối ưu**.
|
||||
- Commands: `sig_create_id`, `sig_sign`, `sig_verify`, `security_optimize`,
|
||||
`pick_any_file`, `pick_save_pem`.
|
||||
|
||||
### 6.5 Test iteration 2 (7 mới → tổng 62/62)
|
||||
- `sign_then_verify_is_valid` — tạo ID → ký → xác thực hợp lệ, đúng tên người ký.
|
||||
- `tampering_after_signing_is_detected` — lật 1 byte vùng đã ký → chữ ký KHÔNG
|
||||
hợp lệ (chứng minh phát hiện giả mạo, cốt lõi của chữ ký số).
|
||||
- `verify_reports_none_for_unsigned` — file chưa ký: 0 chữ ký.
|
||||
- `redact_removes_text_content_for_real` (nâng): chuỗi mật biến mất nhưng
|
||||
phần cùng dòng ngoài vùng **vẫn còn** (tỉa theo ký tự).
|
||||
- `optimize_save_keeps_content_and_not_larger`.
|
||||
|
||||
### 6.6 Giới hạn còn lại (v-sau, không chặn dùng)
|
||||
- Chữ ký tự ký (self-signed) → Acrobat báo "hợp lệ nhưng chưa tin cậy chuỗi
|
||||
CA"; cần cài cert vào Trusted hoặc dùng CA thật. Cơ chế byte-range/CMS đã
|
||||
chuẩn để Acrobat xác thực toán học.
|
||||
- Chưa timestamp (PAdES-T) và LTV; chưa đọc PFX/PKCS#12 (mới PEM).
|
||||
- Ký nhiều lần giữ chữ ký cũ (multi-sig incremental) chưa làm — mới ký lần đầu.
|
||||
- Redact ký tự: đoạn XOAY vẫn xoá cả object (an toàn).
|
||||
|
||||
Reference in New Issue
Block a user