Thực hiện chỉ đạo của Thủ tướng Chính phủ tại Chỉ thị số 05/CT-TTg ngày 23/02/2023 về Tiếp tục đẩy mạnh triển khai đề án phát triển ứng dụng dữ liệu về dân cư, định danh và xác thực điện tử phục vụ chuyển đổi số quốc gia giai đoạn 2022 - 2025, tầm nhìn đến năm 2030 tại các bộ, ngành, địa phương năm 2023 và những năm tiếp theo, Bộ Thông tin và Truyền thông (TT&TT) đã xây dựng Hướng dẫn tích hợp tính năng ký số từ xa (chữ ký số trên thiết bị di động thông minh) để thuận tiện cho các đơn vị vận hành cổng dịch vụ công (DVC) trong quá trình tích hợp chữ ký số công cộng theo mô hình ký số từ xa vào các tác vụ của người dân/doanh nghiệp trên cổng (Phụ lục đính kèm theo Công văn này).

Ngoài ra, để thuận lợi hơn trong công tác tích hợp, Bộ TT&TT cũng đã chuẩn bị bảng khảo sát, đánh giá tính sẵn sàng của hệ thống kỹ thuật trong quá trình tích hợp tính năng ký số nói chung và ký số từ xa nói riêng, trân trọng đề nghị Quý đơn vị điền thông tin và gửi về Bộ TT&TT (qua Trung tâm Chứng thực điện tử quốc gia) theo địa chỉ: Tầng 7, 115 Trần Duy Hưng, Phường Trung Hòa, Quận cầu Giấy, Thành phố Hà Nội; bản mềm gửi vào thư điện tử: lnhan@mic.gov.vn trước ngày 10/04/2023.

Trong quá trình triển khai, nếu Quý đơn vị gặp khó khăn vướng mắc hoặc phát sinh vấn đề cần trao đổi, làm rõ, đề nghị liên hệ theo đầu mối: Ông Lê Nam Hàn, Trung tâm Chứng thực điện tử quốc gia, điện thoại: 0963124659, thư điện tử: lnhan@mic.gov.vn.

Trân trọng cảm ơn./.

PHIẾU KHẢO SÁT HIỆN TRẠNG KỸ THUẬT CỦA CỔNG DỊCH VỤ CÔNG

Đầu mối liên hệ: Ông Lê Nam Hàn, Trung tâm Chứng thực điện tử quốc gia, điện thoại: 0963124659, thư điện tử: lnhan@mic.gov.vn.

PHỤ LỤC

(Ban hành kèm theo công văn số 936/BTTTT-NEAC ngày 22 tháng 3 năm 2023 của Bộ Thông tin và Truyền thông)

HƯỚNG DẪN KẾT NỐI CỔNG DỊCH VỤ CÔNG VỚI CỔNG KẾT NỐI DỊCH VỤ CHỨNG THỰC CHỮ KÝ SỐ CÔNG CỘNG

(Phiên bản 1.1)

Mục lục

I. MÔ HÌNH TỔNG QUAN

II. THIẾT LẬP CẤU HÌNH KÝ SỐ

III. QUY TRÌNH KÝ TẬP TIN PDF Ở CỔNG DVC

IV. CẤU HÌNH HỆ THỐNG KHUYẾN NGHỊ

V. MÔ TẢ API

1. Thông tin kết nối chung

Yêu cầu kỹ thuật

Bảng mã trạng thái

2. API lấy danh sách chứng thu của người dùng

3. API ký tài liệu

4. API kiểm tra trạng thái giao dịch

I. MÔ HÌNH TỔNG QUAN

Mô hình kết nối giữa cổng kết nối dịch vụ chứng thực chữ ký số công cộng (sau đây gọi là Cổng eSign) (theo khoản 12 Điều 3 Nghị định 42/2022/NĐ-CP), cổng dịch vụ công (sau đây gọi là cổng DVC) và các Tổ chức cung cấp dịch vụ chứng thực chữ ký số công cộng (sau đây gọi là CA công cộng) được mô tả tại sơ đồ như sau:

Hình 1 Mô hình kết nối ký số từ xa trên Cổng DVC

Để công dân thực hiện ký số khi tham gia thủ tục hành chính, công dân (người dùng của cổng DVC) cần có chữ ký số (có thể đăng ký ở các CA công cộng). Cổng DVC sau đó chỉ cần kết nối với Cổng eSign, Cổng eSign sẽ gửi yêu cầu ký đến CA công cộng mà công dân là thuê bao. CA công cộng tương ứng sẽ xác thực ký với công dân theo hệ thống cung cấp dịch vụ riêng.

Sau khi đã xác thực và kích hoạt ký, CA công cộng sẽ trả kết quả ký về cho Cổng eSign, Cổng eSign sẽ kiểm tra chữ ký và trả kết quả cho Cổng DVC. Đối với công dân tham gia Cổng DVC, giao diện duy nhất là giao diện của Cổng DVC.

Sơ đồ luồng thực hiện ký số từ xa trên Cổng DVC

Hình 2 Sơ đồ luồng thực hiện ký số từ xa trên Cổng DVC

1. Công dân tải tập tin cần ký và ấn ký số

2. Cổng DVC gửi yêu cầu ký số và tập tin cần ký đã được băm cho Cổng eSign

3. Cổng eSign gửi yêu cầu ký số và tập tin cần ký cho CA công cộng

4. CA công cộng gửi yêu cầu xác nhận ký số cho công dân qua ứng dụng di động

5. Công dân xác nhận yêu cầu ký số qua ứng dụng di động

6. CA công cộng thực hiện ký số và trả về chữ ký dưới dạng Base64 cho Cổng eSign

7. Cổng eSign tiến hành kiểm tra chữ ký nhận được từ CA công cộng

8. Cổng eSign trả về chữ ký dạng Base64 cho Cổng DVC

9. Cổng DVC gắn chữ ký vào file

II. THIẾT LẬP CẤU HÌNH KÝ SỐ

Cấu hình ký số sẽ được thiết lập trong trang Thông tin cá nhân của Cổng dịch công như sau:

Hình 3 Giao diện cấu hình ký số

Khi thực hiện ký số lên tập tin PDF theo phương thức ký số từ xa, người dùng cần có tài khoản trên Cổng Dịch vụ công và cung cấp các thông tin qua các bước sau:

1. Người dùng chọn CA công cộng mà mình đang là thuê bao từ danh sách dropdown “Chọn CA”.

2. Người dùng nhập số CMND hoặc số CCCD đã khai báo khi đăng ký với CA công cộng vào phần “Nhập userlD”.

3. Nhấn nút “Lấy Chứng thư số”. Cổng Dịch vụ công lấy Chứng thư số theo API lấy danh sách chứng thư số.

4. Nhấn Lưu.

III. QUY TRÌNH KÝ TẬP TIN PDF Ở CỔNG DVC

Sau khi đã cấu hình ký số thành công cho tài khoản, đối với mỗi tài liệu cần ký, người dùng có thể nhấn vào nút ký như sau:

Hình 4 Giao diện ký số tài liệu

Sau khi người dùng nhấn vào nút ký, hệ thống backend cổng Dịch vụ công sẽ thực hiện thông qua sơ đồ sau:

Hình 5 Quy trình ký số từ tập tin PDF phía Cổng DVC

Bước 1: Chuyển tài liệu cần ký thành tập tin PDF (trong trường hợp tài liệu đó không phải là dạng PDF).

Bước 2: Cổng DVC tạo ra tập tin PDF Temp.

Bước 3: Cổng DVC thực hiện băm tập tin.

Bước 4: Cổng DVC gửi mã băm và các thông tin cần thiết theo API đến máy chủ của CA.

Bước 5: Server CA trả về giá trị chữ ký.

Bước 6: Cổng Dịch vụ công gắn chữ ký.

Bước 7: Cổng Dịch vụ trả tập tin đã ký cho người dùng.

IV. CẤU HÌNH HỆ THỐNG KHUYẾN NGHỊ

V. MÔ TẢ API

1. Thông tin kết nối chung

URL: https://esign.neac.gov.vn/sign_v2

Các dịch vụ cung cấp:

Yêu cầu kỹ thuật

Bảng mã trạng thái

2. API lấy danh sách chứng thư của người dùng

a. Phương thức: POST

b. Đường dẫn: https://esign.neac.gov.vn/sign_v2/get_certificate

c. Đặc tả:

- Tham số đầu vào:

- Ví dụ tham số đầu vào:

- Tham số đầu ra:

- Ví dụ tham số đầu ra:

3. API ký tài liệu

a. Phương thức: POST

b. Đường dẫn: https://esign.neac.gov.vn/sign_v2/sign

c. Đặc tả:

- Tham số đầu vào:

- Ví dụ tham số đầu vào:

- Tham số đầu ra:

- Ví dụ tham số đầu ra:

4. API kiểm tra trạng thái giao dịch

a. Phương thức: POST

b. Đường dẫn: https://esign.neac.gov.vn/sign_v2/get_status

c. Đặc tả

- Tham số đầu vào:

- Ví dụ tham số đầu vào:

- Tham số đầu ra:

- Ví dụ tham số đầu ra: