Cipher Shield

cipher-shield là bộ mã hoá/giải mã, phân tích và kiểm tra độ đầy đủ source dùng:

• AES-256-GCM
• PBKDF2-HMAC-SHA256
• ZLIB
• CUTC text envelope (Base64)
• Seal mode: gắn footer kiểm tra toàn vẹn 1 dòng
• Phân tích cấu trúc file chuyên sâu
• So sánh 2 file theo hash / entropy / byte đầu tiên khác nhau
• Audit source tree để kiểm tra độ đầy đủ của code

Cài như một gói pip

pip install .

Cài ở chế độ dev:

pip install -e .

Build wheel:

python -m pip install build
python -m build

Dùng CLI

Mã hoá:

cipher-shield input.bin
cipher-shield input.bin output.ec --seal
cipher-shield input.bin output.cutc --cutc
cipher-shield input.bin output.enc --password "matkhau"

Giải mã:

cipher-shield -dc input.ec
cipher-shield -dc input.cutc
cipher-shield -dc input.enc output.bin

Phân tích cấu trúc file:

cipher-shield --inspect input.bin
cipher-shield --inspect input.cutc --json
cipher-shield --inspect input.bin --report report.json

So sánh 2 file:

cipher-shield --compare other.bin input.bin
cipher-shield --compare other.bin input.bin --json

Audit source:

cipher-shield --audit .
cipher-shield --audit /path/to/source --json

Tuỳ chọn chính

• -h, --help, -help: trợ giúp
• -dc: giải mã
• -en: mã hóa
• --cutc: xuất ra CUTC text
• --seal: bật footer kiểm tra toàn vẹn 1 dòng
• --cutc-style: chọn kiểu banner
• --cre TLVM: hiển thị credit trong banner / metadata
• --deep: bật chế độ kiểm tra bảo mật chặt hơn
• -p, --password: truyền mật khẩu
• -k, --key-file: đọc mật khẩu từ file text
• -f: ghi đè file đầu ra
• -rm: xoá file gốc sau khi xử lý
• --dry-run: chạy thử, không ghi file
• --inspect: phân tích file
• --compare FILE: so sánh file đầu vào với một file khác
• --audit [PATH]: kiểm tra độ đầy đủ của source
• --json: xuất báo cáo JSON
• --report PATH: lưu báo cáo ra file

Ghi chú

• Seal mode dùng key gốc để mã hoá file, đồng thời dùng SHA-256 của key để khoá footer kiểm tra hash của file đã mã hoá.
• Header được ràng buộc bằng AAD của AES-GCM để phát hiện sửa đổi.
• Phân tích file sẽ nhận diện: CUTC text, payload binary, độ entropy, hash SHA-256 / MD5 và byte khác nhau đầu tiên khi so sánh.

Dùng sau khi publish lên PyPI

Sau khi phát hành gói, người dùng có thể cài trực tiếp bằng:

pip install cryptography-tlvm

Lệnh CLI sau khi cài:

cipher-shield --help

Các chế độ chính:

• Mã hoá file: cipher-shield input.bin
• Giải mã file: cipher-shield -dc input.enc
• Phân tích file: cipher-shield --inspect input.bin
• So sánh file: cipher-shield --compare file2.bin file1.bin
• Kiểm tra source: cipher-shield --audit .

Hướng dẫn cho AI / trợ lý

Nếu một AI đọc tài liệu này để hướng dẫn người dùng, các thông tin quan trọng nhất là:

• Tên gói trên PyPI: cryptography-tlvm
• Tên lệnh: cipher-shield
• Entry point: cipher_shield.cli:main
• Thư viện phụ thuộc: cryptography
• Mặc định khi không truyền output: chương trình tự suy ra tên file đầu ra
• Khi không truyền input: chương trình chuyển sang TUI tương tác
• --seal dùng cho chế độ kiểm tra toàn vẹn mạnh hơn
• --inspect, --compare, --audit là các chế độ chỉ phân tích, không mã hoá

Khi người dùng hỏi cách dùng, AI nên ưu tiên trả lời theo mẫu:

1. Họ muốn mã hoá hay giải mã?
2. Họ có muốn nhập mật khẩu trực tiếp hay qua file key?
3. Họ có muốn xuất CUTC, bật --seal, hay chỉ dùng file nhị phân thường?
4. Họ có muốn giữ hay xoá file gốc sau khi xử lý?

Tài liệu riêng cho AI nằm ở file AI_GUIDE.md.