# 2.2. Luồng Ký số Local File (Desktop App / USB Token)

Luồng ký Local phục vụ cho nhu cầu nhân sự cá nhân cầm USB Token vật lý (Viettel, VNPT, FPT,...) để ký văn bản phê duyệt trên máy cá nhân.

**Mô tả các bước:**

1. Website/Portal nội bộ của doanh nghiệp tạo lệnh gọi **LocalSignRequest** xuống ứng dụng `Desktop App` đang chạy ngầm trên máy thông qua `http://localhost:6868/api/desktop/...`.
2. **Tọa độ** hoặc hình ảnh chữ ký được truyền theo xuống `DesktopSigningController`.
3. Ứng dụng Desktop App khơi gợi (pop-up) giao diện **UI (TokenProfileDialog/LoadingDialog)** để lấy Danh sách chứng thư số hiện hành đang cắm vào máy.
4. Yêu cầu nhập mã **PIN Token** từ người thao tác.
5. Desktop App liên kết thông qua thư viện `dss-token` tạo một kết nối PKCS#11 trực tiếp vào driver USB để ký file.
6. Ký thành công, Desktop App phản hồi REST API lại cho Website/Portal kết quả để Client upload file đó lên lại Server.

[![image.png](https://docs.lifetex.vn/uploads/images/gallery/2026-03/scaled-1680-/o9gimage.png)](https://docs.lifetex.vn/uploads/images/gallery/2026-03/o9gimage.png)