Ký số văn bản

📋 Quy trình sử dụng

Tải agent về máy

Tải gói agent phù hợp với hệ điều hành. Giải nén vào thư mục bất kỳ.

Cài đặt lần đầu

Chạy INSTALL-CLIENT.bat (Windows) hoặc INSTALL-CLIENT.sh (Linux). Chỉ làm 1 lần.

Cắm token & chạy agent

Cắm USB token → chạy run-agent.bat (MobiFone) hoặc CHAY-AGENT-VIETTEL.bat (Viettel).

Vào web & ký

Mở trình duyệt → vào trang ký số → Quét driver → PIN → PDF → Ký → Tải về.

⬇ Tải gói agent

Sau khi tải về: giải nén → chạy INSTALL-CLIENT.bat lần đầu → hàng ngày chỉ cần cắm token và chạy run-agent.bat.

🧩

Chrome Extension — Ký số ngay trên trình duyệt

Không cần gõ URL • Click icon là ký • Tự phát hiện PDF trên trang web • Hỗ trợ MobiFone & Viettel

⬇ Tải Extension (.zip) Hướng dẫn cài đặt extension

🪟

Windows

Hỗ trợ Windows 7/8/10/11 (64-bit).
Gồm: agent 64-bit (MobiFone, SafeNet) + agent 32-bit (Viettel).

Yêu cầu:
• Python 3.10+ (64-bit) — tải tại đây
• Tick "Add to PATH" khi cài Python
• Viettel thêm: Python 3.12 (32-bit)

⬇ Tải gói Windows (.zip) 📋 Hướng dẫn cài driver token

🐧

Linux

Hỗ trợ Ubuntu 20+, Debian 10+, CentOS 7+.
Chạy bằng terminal, không cần giao diện đồ họa.

Yêu cầu:
• Python 3.10+ và pip3
• Driver token đã cài (.so file)
• OpenSC: apt install opensc

⬇ Tải gói Linux (.tar.gz) 📋 Hướng dẫn cài driver token

🍎

macOS

Hỗ trợ macOS 11+ (Big Sur trở lên).
Intel và Apple Silicon (M1/M2/M3).

Yêu cầu:
• Python 3.10+ (Homebrew)
• OpenSC: brew install opensc

⬇ Tải gói macOS (.tar.gz) 📋 Hướng dẫn cài driver token

📘 Hướng dẫn chi tiết

🌐 Ký số LAN nội bộ — 1 token, nhiều máy ký

Máy cắm token: chạy run-agent-lan.bat (thay vì run-agent.bat thường) → ghi nhớ IP hiển thị

Máy khác: vào trang ký số → chọn "Mạng LAN nội bộ" → nhập IP máy A → Kết nối → ký bình thường

✓

Không cần cài gì trên máy B, C... Chỉ cần trình duyệt và cùng mạng LAN.

📖 Xem hướng dẫn đầy đủ ký LAN nội bộ

🪟 Windows — MobiFone CA (phổ biến nhất)

Tải cks-agent-windows.zip → giải nén vào C:\cks-agent\

Cài Python 64-bit từ python.org (tick "Add to PATH")

Bấm đúp INSTALL-CLIENT.bat → chờ cài xong (~2 phút)

Cắm USB token MobiFone → bấm đúp run-agent.bat

Mở trình duyệt → vào vienthongdidong.vn/cnxcks/ky/ → Quét driver → Chọn mfca_v1.dll → Nhập PIN → Ký PDF

📶 Windows — Viettel-CA (cần thêm bước)

Làm đủ 5 bước MobiFone ở trên trước

Tải thêm Python 3.12 (32-bit) từ đây — chọn file không có chữ "amd64"

Cắm USB token Viettel → bấm đúp CHAY-AGENT-VIETTEL.bat (lần đầu tự cài thư viện ~5 phút)

Vào web → Quét driver → Chọn Viettel-CA [Viettel 32-bit] → Nhập PIN → Ký

🐧 Linux

Tải cks-agent-linux.tar.gz → tar -xzf cks-agent-linux.tar.gz -C ~/cks-agent

bash ~/cks-agent/INSTALL-CLIENT.sh

Cắm token → bash ~/cks-agent/run-agent.sh

Mở trình duyệt → vào trang ký số

❓ Câu hỏi thường gặp

Web báo "Agent chưa chạy" / "Failed to fetch"? +

Chưa chạy agent trên máy. Cắm token → chạy run-agent.bat (Windows) hoặc bash run-agent.sh (Linux) → cửa sổ đen hiện là OK.

Quét driver không thấy token? +

Driver chưa cài. Xem hướng dẫn cài driver theo từng loại token. Sau khi cài driver → quét lại. Hoặc nhập đường dẫn driver thủ công trong ô phía dưới.

Lỗi đọc chứng thư khi nhập PIN? +

Kiểm tra: (1) Đã chọn đúng driver chưa — MobiFone dùng mfca_v1.dll, Viettel dùng agent 32-bit. (2) PIN đúng chưa — MobiFone mặc định 12345678. Nhập sai 5 lần liên tiếp token bị khóa.

Đang dùng Viettel xong đổi sang MobiFone bị lỗi? +

Bấm nút "↺ Đổi token / driver" ở Bước 2 trong trang ký số → web sẽ reset và quét lại driver. Chọn MobiFone → nhập PIN MobiFone → ký bình thường.

Viettel báo "not a valid Win32 application"? +

Driver Viettel là 32-bit, không chạy với Python 64-bit. Phải dùng CHAY-AGENT-VIETTEL.bat thay vì run-agent.bat. Cần cài thêm Python 3.12 (32-bit).

Dữ liệu văn bản có gửi lên server không? +

Không. Toàn bộ ký số xảy ra trên máy bạn. Server chỉ phục vụ trang web giao diện. PIN và nội dung file không rời khỏi máy.

Sẵn sàng ký số?

Tải agent, cài một lần, dùng mãi mãi.

🖊 Vào ứng dụng ký số ngay

Ký số văn bản PDF từ trình duyệt