🧩 Hướng dẫn cài Chrome Extension

CNX Ký Số · Ký PDF trực tiếp từ icon Chrome

← Quay lại trang chủ
⬇ Bước 1 — Tải Extension
1

Tải file extension về máy

Bấm nút bên dưới để tải file cks-extension.zip về máy:

⬇ Tải CNX Ký Số Extension (.zip)

Sau khi tải về, giải nén file zip vào một thư mục cố định (ví dụ: C:\cks-extension\).
Không xóa thư mục này sau khi cài — Chrome cần nó để extension hoạt động.

⚠ Không đặt trong thư mục Downloads vì có thể bị xóa tự động.
🔧 Bước 2 — Cài vào Chrome
2

Mở trang quản lý Extension

Trên Chrome, vào địa chỉ:

chrome://extensions/

Hoặc: Menu Chrome (⋮) → Extensions → Manage Extensions

3

Bật chế độ Developer

Ở góc trên bên phải trang chrome://extensions/, bật công tắc "Developer mode".

📸 [Hình: Toggle Developer mode góc phải]
4

Load unpacked — Chọn thư mục extension

Bấm nút "Load unpacked" xuất hiện ở góc trái sau khi bật Developer mode.

Chọn thư mục vừa giải nén ở Bước 1 (thư mục chứa file manifest.json).

📸 [Hình: Nút Load unpacked + chọn thư mục]
✓ Nếu thành công: icon KS màu xanh xuất hiện trên thanh Chrome!
✅ Bước 3 — Sử dụng
5

Hàng ngày — Quy trình ký

1. Cắm USB token vào máy

2. Chạy agent: run-agent.bat (MobiFone) hoặc CHAY-AGENT-VIETTEL.bat (Viettel)

3. Nhìn icon KS trên Chrome: ON = agent đang chạy ✓

4. Click icon KS → popup mở ra → làm theo 4 bước trong popup

6

Ký PDF từ trang web đang xem

Khi đang xem trang web có link PDF, extension tự động phát hiện và hiện nút "Ký: tên-file.pdf" ở góc dưới phải màn hình.

Click vào nút đó → PDF tự load vào popup → nhập PIN → ký ngay.

✓ Không cần tải PDF về máy trước — extension làm tự động!
❓ Lưu ý & Xử lý lỗi
!

Badge đỏ "OFF" — Agent chưa chạy

Icon KS hiện badge đỏ OFF → agent chưa khởi động trên máy.
Chạy run-agent.bat rồi đợi vài giây → badge tự chuyển xanh.

!

Cập nhật extension khi có phiên bản mới

1. Tải file cks-extension.zip mới về
2. Giải nén đè lên thư mục cũ
3. Vào chrome://extensions/ → bấm ↺ nút reload trên card CNX Ký Số

⚠ Không cần Remove rồi cài lại — chỉ cần giải nén đè và reload.
!

Extension biến mất sau khi khởi động lại Chrome

Chrome đôi khi hỏi "Disable developer mode extension?" — bấm Cancel / Keep để giữ extension. Nếu bị disable, vào chrome://extensions/ → bật toggle lại.