Đến bước ký số để nộp E-HSDT mà bấm mở VNeGP Client Agent thì chương trình không lên, hoặc Agent đã chạy nhưng trang web vẫn báo “chưa phát hiện chương trình ký số” — đó chính là lúc VNeGP Client Agent không hoạt động theo đúng nghĩa. Đây là sự cố gấp: đang thao tác dở trên Hệ thống mạng đấu thầu quốc gia, sát giờ đóng thầu mà công cụ ký số lại “đứng”. Bài này không hướng dẫn cài lại từ đầu (nếu cần cài mới, xem bài cài đặt VNeGP Client Agent) mà đi thẳng vào chẩn đoán theo từng triệu chứng: bạn gặp biểu hiện nào thì đọc đúng mục đó để xem nguyên nhân khả dĩ và cách xử lý. Bài nằm trong trung tâm hỗ trợ đấu thầu qua mạng; muốn nhìn rộng hơn, tham khảo tổng hợp lỗi thường gặp khi đấu thầu qua mạng.
Chẩn đoán nhanh: bạn đang ở triệu chứng nào?
VNeGP Client Agent là chương trình chạy nền, làm cầu nối giữa trình duyệt và chứng thư số (USB token) để ký. Vì nằm giữa nhiều lớp — Windows, trình duyệt, tường lửa, token — nên khi “không hoạt động”, biểu hiện rất khác nhau. Hãy xác định đúng triệu chứng theo bảng sau rồi nhảy tới mục tương ứng.
| Triệu chứng bạn thấy | Hướng nghi ngờ đầu tiên |
|---|---|
| Bấm mở Agent nhưng không có gì xảy ra | Chưa cài / bản cài hỏng / thiếu quyền |
| Agent bật lên rồi tự tắt sau vài giây | Xung đột bản cài, bị antivirus dừng tiến trình |
| Trang báo chưa nhận / chưa khởi động chương trình ký số | Agent chưa chạy hoặc trình duyệt chưa nối được |
| Trình duyệt không kết nối được tới Agent | Firewall, VPN/proxy, tiện ích chặn cổng nội bộ |
| Agent chạy nhưng bấm ký không lên chọn chứng thư | Token, driver, chứng thư số |
| Máy có nhiều biểu tượng / phiên bản Agent | Nhiều bản cài chồng nhau |
| Vừa cập nhật Windows/antivirus thì Agent hỏng | Firewall/antivirus chặn |
| Máy công ty, tài khoản Windows bị hạn chế | Sai quyền người dùng |
Mẹo chung trước khi đi sâu: phần lớn trục trặc được giải quyết chỉ bằng ba việc — mở Agent trước khi vào trang ký số, khởi động lại máy một lần, và chạy Agent bằng quyền quản trị viên. Nếu chưa đủ, mới đi theo từng triệu chứng.
Nhóm 1 — Agent không khởi động được
Agent không mở được
Triệu chứng: nhấp đúp biểu tượng VNeGP Client Agent nhưng không thấy cửa sổ nào, cũng không thấy biểu tượng Agent ở khay hệ thống (góc phải thanh taskbar).
Nguyên nhân khả dĩ: Agent chưa cài hoặc bộ cài trước bị lỗi; file chương trình hỏng, bị antivirus cách ly; thiếu thành phần nền mà bản Agent yêu cầu; lối tắt trỏ sai đường dẫn.
Cách khắc phục:
- Vào Control Panel > Programs (hoặc Settings > Apps) xem Agent đã cài chưa; nếu không có nghĩa là chưa cài.
- Nhấp chuột phải, chọn Run as administrator để loại trừ lỗi thiếu quyền.
- Khởi động lại máy một lần rồi mở lại.
- Vẫn không được: gỡ hẳn rồi cài lại sạch theo hướng dẫn cài đặt VNeGP Client Agent.
Agent mở rồi tự tắt
Triệu chứng: chương trình có bật lên (thoáng thấy biểu tượng ở khay) nhưng vài giây sau tự biến mất; mở lại vẫn lặp lại.
Nguyên nhân khả dĩ: một bản Agent khác đang chạy chiếm cổng nội bộ; antivirus hoặc Windows Defender kết thúc tiến trình ngay khi khởi chạy; bản cài lỗi, thiếu file khi chạy.
Cách khắc phục:
- Mở Task Manager (Ctrl+Shift+Esc), kết thúc hết tiến trình Agent rồi mở lại đúng một lần.
- Tạm dừng antivirus để kiểm chứng: nếu tắt xong Agent chạy ổn thì nguyên nhân ở phần mềm bảo mật (xem mục firewall/antivirus).
- Nếu máy có nhiều bản Agent, xử lý theo mục “Có nhiều bản cài” trước.
- Vẫn tự tắt thì gỡ và cài lại từ bộ cài mới nhất.
Nhóm 2 — Agent chạy nhưng không kết nối
Hệ thống không nhận Agent
Triệu chứng: Agent đã chạy (thấy biểu tượng ở khay) nhưng trang web vẫn báo chưa phát hiện / chưa khởi động chương trình ký số khi bạn bấm thao tác cần ký.
Nguyên nhân khả dĩ: mở trang ký số trước, mở Agent sau nên trang chưa “bắt” được Agent; bộ nhớ đệm trình duyệt giữ trạng thái cũ; dùng trình duyệt không được khuyến nghị hoặc chế độ ẩn danh chặn kết nối nội bộ; một tiện ích/extension can thiệp.
Cách khắc phục:
- Đóng trang, bảo đảm biểu tượng Agent đang sáng ở khay, sau đó mở lại trang và làm mới bằng Ctrl+F5.
- Xóa cache hoặc mở cửa sổ mới; tránh chế độ ẩn danh khi ký số.
- Chuyển sang trình duyệt được khuyến nghị; tạm tắt các extension không cần thiết.
- Vẫn không nhận thì vấn đề ở lớp kết nối — xem mục kế tiếp.
Trình duyệt không kết nối được Agent
Triệu chứng: trang báo lỗi kết nối tới chương trình ký số (thường là kết nối tới cổng nội bộ trên chính máy bạn) hoặc “quay vòng” mãi không xong dù Agent đang chạy.
Nguyên nhân khả dĩ: tường lửa chặn cổng nội bộ Agent dùng; VPN/proxy hoặc phần mềm mạng công ty chặn kết nối tới địa chỉ nội bộ (localhost); chứng chỉ nội bộ của Agent chưa được trình duyệt chấp nhận; extension chặn kịch bản.
Cách khắc phục:
- Tạm tắt VPN/proxy rồi thử lại; máy công ty thì hỏi IT về việc cho phép kết nối localhost.
- Cho phép Agent đi qua tường lửa (xem mục firewall/antivirus).
- Chấp nhận chứng chỉ nội bộ của Agent khi trình duyệt hỏi, thay vì đóng cảnh báo.
- Tắt lần lượt các extension để tìm cái đang chặn. Nên rà lại cấu hình máy tính trước khi nộp E-HSDT để hạn chế lỗi tái diễn.
Nhóm 3 — Kết nối được nhưng ký số vẫn lỗi
Agent chạy nhưng ký số không hoạt động
Triệu chứng: Agent chạy bình thường, trang web cũng nhận Agent, nhưng bấm ký thì không hiện cửa sổ chọn chứng thư, hoặc báo lỗi khi ký, hoặc ký xong mà hệ thống không ghi nhận chữ ký.
Nguyên nhân khả dĩ: chưa cắm USB token hoặc cắm lỏng/qua hub; driver token chưa cài hoặc chưa nhận đúng; chứng thư số hết hạn, chưa hợp lệ hoặc không đúng chứng thư đăng ký với tài khoản; nhập sai PIN hoặc token đang bị ứng dụng khác chiếm.
Cách khắc phục:
- Rút và cắm lại token trực tiếp vào cổng USB trên máy (tránh hub); kiểm tra đèn báo trên token.
- Cài/cập nhật driver token theo nhà cung cấp; kiểm tra token có hiện trong phần mềm quản lý đi kèm không.
- Kiểm tra hạn và tình trạng chứng thư; nhập đúng PIN, tránh sai nhiều lần gây khóa token.
- Nếu Agent và token đều ổn nhưng hệ thống vẫn không ghi nhận chữ ký, đây là nhóm lỗi riêng — xem bài hệ thống đấu thầu không nhận chữ ký số.
Nhóm 4 — Nguyên nhân từ môi trường máy tính
Máy có nhiều bản cài
Triệu chứng: trên máy xuất hiện nhiều biểu tượng Agent, hoặc danh sách chương trình có vài phiên bản/vài công cụ ký số của các nhà cung cấp khác nhau. Đây là nguyên nhân âm thầm gây ra nhiều triệu chứng ở trên (tự tắt, không nhận, tranh cổng).
Nguyên nhân khả dĩ: cài đè nhiều lần mà không gỡ bản cũ; có công cụ ký số của các dịch vụ khác cùng chạy nền, tranh cổng nội bộ; phiên bản cũ chưa được gỡ.
Cách khắc phục:
- Gỡ toàn bộ các bản Agent và công cụ ký số không dùng đến trong Programs.
- Khởi động lại máy để giải phóng tiến trình và cổng đang bị giữ.
- Chỉ cài lại đúng một bản mới nhất theo hướng dẫn cài đặt — không giữ song song nhiều bản.
Firewall hoặc antivirus chặn
Triệu chứng: Agent tự tắt, không kết nối được, hoặc bỗng hỏng ngay sau khi máy cập nhật Windows/antivirus. Đây thường là “thủ phạm ẩn” khi mọi thứ đang chạy tốt bỗng dừng.
Nguyên nhân khả dĩ: tường lửa chặn cổng nội bộ Agent dùng; antivirus cách ly file của Agent vì nhận nhầm là đáng ngờ; bản cập nhật bảo mật đặt lại quy tắc, xóa ngoại lệ đã thêm.
Cách khắc phục:
- Thêm Agent vào danh sách cho phép (allow/exception) của tường lửa Windows và của antivirus.
- Kiểm tra mục cách ly của antivirus, khôi phục file Agent nếu bị đưa vào đó, rồi thêm thư mục cài vào whitelist.
- Sau mỗi lần cập nhật lớn, kiểm tra lại xem ngoại lệ còn được giữ không. Nếu buộc phải tắt tạm bảo mật để kiểm chứng thì bật lại ngay sau đó.
Chạy sai quyền người dùng
Triệu chứng: hay gặp trên máy công ty hoặc máy dùng chung — Agent cài được nhưng không chạy đúng, hoặc chạy ở tài khoản này thì không thấy ở tài khoản kia.
Nguyên nhân khả dĩ: đang đăng nhập bằng tài khoản Windows bị hạn chế quyền trong khi Agent cần quyền cao hơn để mở cổng/ghi cấu hình; UAC chặn chương trình; Agent được cài ở tài khoản Windows này nhưng dùng ở tài khoản khác.
Cách khắc phục:
- Nhấp chuột phải Agent, chọn Run as administrator; nếu cần, đặt thuộc tính chạy với quyền quản trị trong Properties > Compatibility.
- Đăng nhập đúng tài khoản Windows đã cài Agent, hoặc cài lại trên tài khoản đang thao tác.
- Máy công ty thì nhờ IT cấp quyền phù hợp; cân nhắc đặt Agent khởi động cùng Windows để khỏi quên mở trước khi ký.
Vẫn không xử lý được thì làm gì?
Nếu đã đi hết các triệu chứng mà Agent vẫn “đứng”, thường vấn đề nằm ở tổ hợp nhiều lớp (máy công ty siết bảo mật, token lỗi phần cứng, hoặc trục trặc phía hệ thống). Đừng cố thử đi thử lại sát giờ đóng thầu. Hãy ghi lại chính xác thông báo lỗi và bước đang thao tác, đối chiếu thêm với các lỗi nghiệp vụ thường gặp trên Hệ thống mạng đấu thầu quốc gia để loại trừ những lỗi không thuộc về Agent, rồi tìm hỗ trợ có kinh nghiệm.
Cần người xử lý gấp cùng bạn
Nếu doanh nghiệp không có nhân sự kỹ thuật hoặc đang kẹt ngay trước giờ nộp, có thể cân nhắc dịch vụ hỗ trợ đăng ký và thao tác đấu thầu qua mạng để được đồng hành xử lý cấu hình máy, chứng thư số và thao tác trên hệ thống. Phạm vi hỗ trợ là kỹ thuật, tư vấn quy trình và hướng dẫn thao tác theo phạm vi thống nhất; doanh nghiệp/nhà thầu vẫn chịu trách nhiệm về tính chính xác, trung thực và hợp pháp của hồ sơ, thông tin do mình cung cấp theo quy định về đấu thầu qua mạng.
VIỆN NGHIÊN CỨU ĐÀO TẠO BỒI DƯỠNG CÁN BỘ
Hotline: 0904 889 859 (Ms. Hoa)
Email: info@viendaotaocanbo.edu.vn
Câu hỏi thường gặp
Đã mở VNeGP Client Agent nhưng hệ thống vẫn báo chưa nhận, vì sao?
Thường do bạn mở trang ký số trước, mở Agent sau nên trang chưa “bắt” được Agent, hoặc trình duyệt đang giữ trạng thái cũ. Hãy bảo đảm biểu tượng Agent đang sáng ở khay hệ thống rồi làm mới trang bằng Ctrl+F5. Nếu vẫn không nhận, kiểm tra tường lửa, VPN/proxy và các tiện ích trình duyệt vì chúng có thể chặn kết nối tới cổng nội bộ mà Agent dùng. Thử một trình duyệt được khuyến nghị cũng giúp loại trừ nguyên nhân.
Máy có nhiều bản Agent thì có sao không?
Có. Nhiều bản Agent hoặc nhiều công cụ ký số cùng chạy nền dễ tranh nhau cổng nội bộ, khiến Agent tự tắt, không nhận hoặc kết nối chập chờn. Cách xử lý gọn là gỡ toàn bộ các bản không dùng trong danh sách chương trình đã cài, khởi động lại máy để giải phóng tiến trình, rồi chỉ cài lại đúng một bản mới nhất. Không nên giữ song song nhiều phiên bản trên cùng một máy dùng để ký số và nộp E-HSDT.
Agent chạy bình thường nhưng bấm ký không lên cửa sổ chọn chứng thư?
Khi Agent chạy tốt mà thao tác ký vẫn lỗi, nguyên nhân thường ở token và chứng thư số chứ không phải bản thân Agent. Hãy cắm lại USB token trực tiếp vào máy (tránh hub), cài đúng driver theo nhà cung cấp, kiểm tra hạn và tình trạng chứng thư, nhập đúng mã PIN và bảo đảm không có ứng dụng khác đang chiếm token. Nếu token và chứng thư đều hợp lệ mà hệ thống vẫn không ghi nhận chữ ký, đó là nhóm lỗi không nhận chữ ký số cần xử lý theo hướng dẫn riêng.
