Tìm kiếm Nâng cao
Kết quả Tìm kiếm
Tìm thấy 270 kết quả
5.2. Hướng dẫn Triển khai Signing Web Service (Server)
Ứng dụng Web Service được tối ưu để hoạt động trong Docker Container, cung cấp khả năng khởi tạo nhanh và độc lập môi trường. Cách 1: Chạy trực tiếp qua Docker Compose (Khuyến nghị) Hệ thống đã cung cấp sẵn file docker-compose.yml. Khi gọi lệnh docker-compos...
5.3. Đóng gói & Cài đặt Signing Desktop App (Client)
Client App được tối ưu hóa đặc biệt. Thay vì phải yêu cầu hàng trăm nhân sự dùng máy tính văn phòng tự tải JDK/JRE về để chạy lệnh java -jar, ứng dụng Desktop được nhúng (bundle) thẳng JRE (Custom JRE) vào bên trong thông qua công cụ jlink và jpackage. Nó biến...
Chương 6: Cấu hình Hệ thống (System Configuration)
Để hệ thống hoạt động chính xác với hạ tầng của đối tác/khách hàng, Signing Service Tân Cảng cung cấp các file cấu hình tách biệt hoàn toàn khỏi mã nguồn. Chương này giải thích các file cấu hình quan trọng nhất trên hệ thống.
6.1. Cấu hình Web Service (application.yml)
Mọi thông số kết nối trọng yếu của API Server được đặt trong thư mục src/main/resources/application.yml (khi lập trình) hoặc ghi đè bằng Environment Variables (khi chạy Docker). 1. Kết nối Cơ sở dữ liệu (MSSQL Server) Hệ thống sử dụng SQL Server để lưu thông...
6.2. Cấu hình Máy trạm Desktop ( token-config.json )
Do USB Token (SmartCard) đến từ rất nhiều định dạng nhà cung cấp khác nhau (Viettel, VNPT, FPT, BKAV, HILO), mỗi hãng lại dùng một file Driver .dll (trên Windows) riêng biệt. Ứng dụng signing-desktop quản lý cấu hình các Token này thông qua file token-config....
6.3. Cấu hình giao tiếp EJBCA Server
Các cấu hình giao tiếp mã hóa (Keystore / Truststore) để kết nối an toàn với máy chủ cấp phát EJBCA thông qua Rest/SOAP API (nếu có yêu cầu Mutual-TLS) thường nằm trong các tham số Custom Properties tự định nghĩa. ejbca: client: base-url: "https://ca-...
Chương 7: Hướng dẫn dành cho Lập trình viên (Developer Guide)
Chương này cung cấp những kiến thức và quy ước cần thiết nhất cho một lập trình viên (Developer) mới tham gia vào dự án, để có thể nhanh chóng làm quen, build source code và debug lỗi hệ thống Signing Service Tân Cảng.
7.1. Cấu trúc Quản lý Dependency (Parent POM)
Toàn bộ dự án đi theo mô hình Maven Multi-Module, được kiểm soát chặt chẽ bởi file pom.xml nằm ở gốc dự án (Root Directory). Đây là nơi khai báo dependencyManagement. Lý do của kiến trúc này: Đảm bảo toàn bộ 5 module con (signing-core, signing-web-serv...
7.2. Hướng dẫn Môi trường & Build Source
Hướng dẫn cài đặt môi trường Môi trường phát triển hệ điều hành Windows - Cài đặt IntelliJ IDEA ( Link cài đặt Intellij IDEA ) - Hoặc cài đặt Visual Studio Code ( Link cài đặt Visual Studio Code ) - Cài đặt JDK-17 ( Link c...
7.3. Cách Debug (Kiểm thử) các Tính năng Phức tạp
Gỡ chặn CORS khi gọi từ môi trường Frontend (Local Web Proxy) Vì Desktop App chạy ở cổng localhost:6868 nhưng Frontend Portlet lại chạy trên tên miền của hệ thống E-Office (Ví dụ https://portal.tancang.com.vn), nên mặc định trình duyệt như Chrome/Edge sẽ chặn...
Chương 8: Vận hành & Xử lý sự cố thường gặp (Troubleshooting)
Quá trình vận hành Signing Service Tân Cảng trải qua sự đóng góp của nhiều luồng kết nối phân tán. Chương này liệt kê các lỗi phổ biến mà quản trị viên, chuyên viên hỗ trợ (Support/IT) thường gặp và cách check log bắt bệnh chính xác.
8.1. Lỗi Không nhận USB Token trên Desktop App
Luồng chạy ứng dụng Desktop phụ thuộc sát sao vào độ ổn định phần cứng máy tính và Driver hãng. Hiện tượng: Ứng dụng Desktop chạy, nhưng khi gọi lệnh ký thì pop-up báo "Không tìm thấy thiết bị Token" hoặc văng lỗi PKCS11Exception. Cách xử lý: Rút ra cắm lạ...
8.2. Lỗi Chuyển đổi Khống Format (File Conversion Issues)
Một trong những vấn đề đau đầu nhất là khi người dùng Upload một file không chính thống nhưng "vô tình hoặc cố ý" bị đổi sai định dạng đuôi file. Hiện tượng: Quăng lỗi UnsupportedFileFormatException khi đang thực thi bộ chuyển đổi Aspose.Words (ví dụ: Chu...
8.3. Lỗi Request OTP & Authentication (HTTP 400/401)
Dự án áp dụng logic ký bảo mật qua Session OTP sinh tự động. Lỗi thường phát sinh tại API /api/sign/request-otp và API ký. Hiện tượng: Web/Portal trả về thông điệp lỗi HTTP status 400 Bad Request, hoặc "Phiên ký không hợp lệ". Cách khắc phục: Khi gọi /api/...
8.4. Lỗi độ trễ Redis Cache (EJBCA Lookup Error)
Hiện tượng: Tài liệu ký bị pending quá lâu, timeout, hoặc hệ thống báo "Người dùng không tồn tại". Cách xử lý: Hệ thống dùng Redis để quản lý cache hàm endEntityExists(). IT cần kiểm tra xem Container kyso-redis có đang sống và đáp trả lệnh ping không (doc...
TÀI LIỆU BÀN GIAO KỸ THUẬT DỰ ÁN LGSP SERVICE
Hệ thống trục liên thổng của tỉnhNền tảng: WSO2 Micro Integrator 4.4.0
CHƯƠNG I: TỔNG QUAN VÀ THIẾT KẾ HỆ THỐNG LGSP
Sơ bộ hệ thống LGSP
TRANG 1: Bối cảnh dự án và Tầm nhìn tích hợp
1.1. Hiện trạng và Thách thức Trong kỷ nguyên số, các cơ quan nhà nước tại địa phương thường vận hành các hệ thống phần mềm độc lập (Silos). Điều này dẫn đến việc dữ liệu bị chia cắt, không đồng bộ và gây khó khăn cho người dân khi thực hiện thủ tục hành chín...