3.3. Danh sách Desktop API (Cục bộ localhost:6868)

Để tiện cho Web frontend gửi lệnh ký vào máy trạm, ứng dụng Desktop mở sẵn cổng RESTful trực tiếp trên máy người dùng chứa USB Token. Không yêu cầu phải tải file lên server.

• POST /api/desktop/sign-request (LocalSigningController):
  • Input: LocalSignRequestDTO (Base64 nội dung file, loại USB Token yêu cầu, và danh sách định vị con dấu/chữ ký).
  • Luồng xử lý: API này sẽ gọi Platform.runLater để mở giao diện TokenProfileDialog yêu cầu người sử dụng Token bấm "OK" và điền mã PIN bảo mật.
  • Tích hợp: Framework dùng DSS Token (SmartCard/PKCS#11) để Hash tài liệu, tạo chữ ký CMS/PKCS#7 và trả JSON báo hiệu chữ ký thành công về cho Frontend.