Muốn ký hồ sơ trên dịch vụ công Kho bạc, máy tính cần ba lớp phần mềm chạy cùng lúc: phần mềm USB Token của nhà cung cấp chứng thư, Chương trình ký số KBNN và trình duyệt được cấu hình để trang web gọi được chương trình này. Bài này hướng dẫn cài đặt ký số Kho bạc đúng bộ cho chứng thư Viettel-CA và tự kiểm tra trước khi ký thật.
Trên trang đăng nhập dvc.vst.mof.gov.vn, mở mục Phần mềm và tài liệu hướng dẫn, tải bộ cài ở mục dành cho chứng thư số công cộng (tệp SignatureAppXp_Setup_2.0.rar, KBNN đăng ngày 26/10/2023), giải nén và cài bằng tài khoản quản trị Windows. Chương trình chạy ở khay hệ thống, thư mục cài là C:\Program Files\KbnnSignature. Dùng Firefox bản mới, chỉnh tham số security.mixed_content.block_active_content thành false theo tài liệu của KBNN, rồi ký thử với một hồ sơ chưa gấp.
Ba lớp phần mềm cần có
Driver và Token Manager của Viettel-CA giúp Windows nhận Token và đọc chứng thư. Chọn bộ cài theo bài tải phần mềm Viettel-CA.
Do KBNN cung cấp, cho phép người dùng ký số bộ hồ sơ và chứng từ thanh toán khi giao dịch với Kho bạc.
Tài liệu xử lý vướng mắc của KBNN nêu việc không dùng Firefox, hoặc chưa chỉnh tham số, là một nguyên nhân của lỗi ký số.
Công cụ ký số của cổng thuế, BHXH hay hóa đơn là phần mềm riêng, không thay được Chương trình ký số KBNN. Ngược lại, chương trình của KBNN cũng không thay phần mềm Token: thiếu một trong ba lớp là nút Ký số không hoạt động.
Tải đúng bộ cài của KBNN
Trang đăng nhập dịch vụ công có mục Phần mềm và tài liệu hướng dẫn. Các mục trên trang này dành cho các đối tượng khác nhau:
| Mục trên trang | Dành cho | Người dùng Viettel-CA |
|---|---|---|
| 1.1 và 1.2. Tài liệu hướng dẫn | Đơn vị đã tham gia và đơn vị đăng ký mới | Nên đọc |
| 2.1 và 2.2. Bộ cài cho hệ điều hành 32 bit, 64 bit | Chứng thư số do Ban Cơ yếu Chính phủ cấp | Không dùng |
| 3. Bộ cài cho chứng thư số công cộng | Chứng thư của tổ chức cung cấp dịch vụ công cộng như Viettel-CA; tệp SignatureAppXp_Setup_2.0.rar | Dùng mục này |
| 4. Tài liệu hướng dẫn sử dụng phiên bản 4.0 | Mọi người dùng | Tham khảo thao tác |
Bộ cài là tệp nén .rar nên cần phần mềm giải nén. Chỉ tải từ trang của KBNN: ngày 03/9/2026, KBNN đã ra Thông báo 6098/TB-KBNN cảnh báo các trang, nhóm mạng xã hội mạo danh KBNN, giả mạo giao diện dịch vụ công và dụ cài ứng dụng không rõ nguồn gốc.
Cài và kiểm tra chương trình đang chạy
Chuẩn bị
Đăng nhập Windows bằng tài khoản có quyền quản trị (máy cơ quan thì nhờ bộ phận IT), đóng trình duyệt, cắm USB Token và kiểm tra Token Manager đã thấy chứng thư.
Cài đặt
Giải nén tệp vừa tải, chạy tệp cài đặt và làm theo các bước trên màn hình. Nếu máy đã có bản cũ, KBNN từng hướng dẫn chạy bộ cài mới đè lên phần mềm ký số hiện tại. Cài xong, khởi động lại máy.
Kiểm tra chương trình đang chạy
Chương trình thường khởi động cùng Windows và có biểu tượng ở khay hệ thống, góc phải thanh tác vụ. Không thấy biểu tượng thì mở thư mục C:\Program Files\KbnnSignature và nhấn đúp tệp .exe để bật chương trình.
Đổi máy tính hoặc cài lại Windows thì phải cài lại đủ cả ba lớp; thứ tự cài phần mềm Token có trong bài đổi máy tính, cài lại USB Token.
Cấu hình Firefox theo tài liệu KBNN
- Cập nhật Firefox: mở menu, vào Trợ giúp (Help), chọn Giới thiệu về Firefox (About Firefox) để Firefox tự tải bản mới, bấm khởi động lại.
- Gõ about:config vào thanh địa chỉ, bấm nút chấp nhận rủi ro để vào trang tham số.
- Gõ từ khóa mixed vào ô tìm kiếm, tìm tham số security.mixed_content.block_active_content.
- Nhấn đúp để giá trị chuyển từ true sang false, đóng tab.
- Nếu máy chạy chậm khi dùng hệ thống, xóa lịch sử duyệt web, cookie và dữ liệu trang trong phần Quyền riêng tư và bảo mật rồi mở lại Firefox.
Tham số này nới một lớp chặn nội dung không mã hóa trên trang có mã hóa và áp dụng cho mọi trang web mở bằng Firefox đó. Không đổi thêm tham số khác, không dùng Firefox này để mở trang lạ, và cập nhật Firefox thường xuyên.
Kiểm tra chứng thư và chuỗi CA Viettel-CA
- Mở Token Manager, xem chứng thư của đúng người, còn hạn; ghi lại serial theo bài xem thông tin chứng thư số Viettel-CA.
- Mở chi tiết chứng thư, tab Certification Path hiển thị đủ chuỗi tới chứng thư gốc quốc gia là máy đã tin cậy chuỗi CA.
- Chứng thư CA của Viettel-CA đang có hiệu lực và đã hết hạn được Trung tâm Chứng thực điện tử quốc gia công bố tại rootca.gov.vn, mục Thông tin các CA công cộng, Viettel-CA.
- Máy còn nhiều chứng thư CA Viettel-CA cũ có thể làm chương trình của KBNN chọn sai, gây lỗi OCSP; cách xử lý ở bài lỗi OCSP khi ký Kho bạc bằng Viettel-CA.
- Khi ký chỉ cắm Token của người đang ký, xem thêm dùng nhiều USB Token trên một máy.
Ký thử và đọc kết quả
Lần ký đầu tiên sau khi cài, hãy làm với một hồ sơ thật nhưng chưa gấp, ví dụ bước lấy serial khi đăng ký hoặc phê duyệt một hồ sơ nhỏ. Cài đặt đã thông khi bấm Ký số hoặc Lấy thông tin số serial thì hộp chọn chứng thư hiện ra và Token hỏi mật khẩu. Nếu xuất hiện thông báo lỗi, đối chiếu bảng sau:
| Thông báo đầu tiên gặp | Lớp đang lỗi | Đọc tiếp |
|---|---|---|
| “Phần mềm ký số chưa được bật” | Chương trình ký số KBNN hoặc Firefox | Lỗi phần mềm ký số chưa được bật |
| “Hệ thống không tìm thấy thông tin chứng thư số” | USB Token hoặc serial chưa đăng ký | Lỗi không tìm thấy chứng thư số |
| “Kích hoạt CTS không thành công”, “Array index out of range” | Chuỗi chứng thư CA | Lỗi kích hoạt chứng thư số |
| Lỗi OCSP [KBNN-2002] | Chứng thư CA Viettel-CA trên máy | Lỗi OCSP khi ký Kho bạc |
Thông báo khác xem trong bảng lỗi dịch vụ công Kho bạc; lộ trình đầy đủ có trong hướng dẫn toàn tập dịch vụ công Kho bạc.
Câu hỏi thường gặp
Chương trình ký số KBNN tải ở đâu?
Trên trang đăng nhập dvc.vst.mof.gov.vn, mục Phần mềm và tài liệu hướng dẫn. Bộ cài cũng được KBNN đăng ở mục Thông tin chung về DVC trên Cổng thông tin điện tử vst.mof.gov.vn. Không tải từ nhóm mạng xã hội hay đường link lạ.
Chứng thư số Viettel-CA dùng bộ cài nào của KBNN?
Dùng mục 3, bộ cài dành cho chứng thư số công cộng, tệp SignatureAppXp_Setup_2.0.rar. Các mục 2.1 và 2.2 dành cho chứng thư số do Ban Cơ yếu Chính phủ cấp.
Có dùng Chrome hoặc Edge để ký trên dịch vụ công Kho bạc được không?
Tài liệu xử lý vướng mắc của KBNN nêu việc không vào hệ thống bằng Firefox, hoặc Firefox chưa cấu hình đúng, là một nguyên nhân của lỗi phần mềm ký số chưa được bật. Để ổn định, hãy dùng Firefox bản mới đã cấu hình theo hướng dẫn của KBNN.
Mỗi lần bật máy có phải mở lại Chương trình ký số KBNN không?
Thường thì không, vì chương trình khởi động cùng Windows. Nếu khay hệ thống không có biểu tượng của chương trình, mở thư mục KbnnSignature trong Program Files và chạy tệp .exe.
Cài xong có cần gỡ phần mềm Token của Viettel-CA không?
Không. Phần mềm Token giúp máy đọc chứng thư, còn Chương trình ký số KBNN dùng chứng thư đó để ký trên hệ thống; cần cả hai cùng hoạt động.
Cần hỗ trợ cài đặt ký số cho dịch vụ công Kho bạc?
Đội hỗ trợ viettel-ca.com giúp kiểm tra phần mềm Token, chuỗi chứng thư Viettel-CA và máy ký. Chuẩn bị phiên bản Windows, Firefox và ảnh lỗi; không gửi mã PIN hay mật khẩu.
Nguồn đối chiếu: Dịch vụ công KBNN: phần mềm và tài liệu hướng dẫn; KBNN: bộ cài đặt cho máy trạm truy cập dịch vụ công (26/10/2023); KBNN: tài liệu hướng dẫn sử dụng, xử lý vướng mắc dịch vụ công; Trung tâm Chứng thực điện tử quốc gia: chứng thư CA công cộng; KBNN: cảnh giác hành vi giả mạo trên mạng xã hội. Thông tin có thể thay đổi; ưu tiên hướng dẫn hiện hành của cơ quan/nhà cung cấp tại thời điểm thao tác. Cập nhật: 28/09/2026.
