Thiết lập nhanh

Điều kiện tiên quyết


Yêu cầu hệ thống:

Loại vòm hệ điều hành 64 bit (Windows, Linux hoặc Unix).

Bộ công cụ phát triển Java phiên bản 11/64-bit trở lên.

Yêu cầu dịch vụ (Dưới đây có thể định cấu hình):

Bộ nhớ tối thiểu 512 megabyte.

Thư mục tạm thời không có hạn chế. (Đọc/Ghi).

Yêu cầu kinh doanh:

Người dùng muốn sử dụng dịch vụ này phải có chứng chỉ ký đủ điều kiện, nếu không người dùng sẽ không thể đạt được bước ký tài liệu.

Đối với quá trình triển khai Sản xuất, SP cần được đưa vào danh sách trắng IP của họ ở phía DESC để có thể truy cập URL này 

https://ca-services.desc.gov.ae/adss/tsa 

Trong trường hợp có bất kỳ sự cố SSL nào, vui lòng nhập chứng chỉ gốc và trung gian DESC TSA để giải quyết lỗi. Chứng chỉ cần được nhập bằng Java cacerts. Để có được chứng chỉ, vui lòng liên hệ với nhóm giới thiệu / vận hành.
 

Hướng dẫn chạy dịch vụ:


Tải xuống tệp .jar cùng với các tệp .jks và .pem sẽ được cung cấp từ VNPASS.

SP cần cài đặt chứng chỉ TSA bằng lệnh dưới đây: 

"keytool -importcert -file {file path} -keystore cacerts -keypass changeit -storepass changeit -noprompt -alias tsa_Staging"


Xin lưu ý rằng chứng chỉ TSA cần được cài đặt trong cacerts java cho cả hai môi trường (dàn dựng và sản xuất).

Thực hiện lệnh dưới đây sau khi xác minh rằng bạn đã cài đặt thành công Java 11+ (bạn có thể kiểm tra bằng cách thực hiện lệnh "java -version" trong cửa sổ đầu cuối), các giá trị màu đỏ theo giá trị môi trường của bạn:

Khởi tạo lệnh khởi tạo Jar (các tham số cần thay đổi theo môi trường): 

java -Dtmp.dir=D:DocumentsStagingOnboardingHashSigningUtilityFiles2UtilityFiles2 -DtrustStore.path=D:DocumentsStagingOnboardingHashSigningUtilityFiles2UtilityFiles2tsa-staging-tx-dev.jks -DparentCert.path=D:DocumentsStagingOnboardingHashSigningUtilityFiles2UtilityFiles2parentCertificate-stg.pem -Dtx/mp-rest/url=
https://stg-id.uaepass.ae
 -Dtx2/mp-rest/url=
https://stg-apis.uaepass.ae
 -Dtx.clientId=(SP specific client id) -Dtx.apiKey=(base64 endoded client id and secret) -Dtx.tokenRedirectUrlV2=
http://localhost:8089/v2/signature/token
 -Dtx.signIndenRedirectUrlV2=
http://localhost:8089/v2/signature/sign-identity
 -Dmax.allowed.file.size=52428800 -Dmax.allowed.files.count=10 -Dquarkus.http.port=8089 -Dquarkus.profile=staging -Xms512m -Xmx1G -jar digital-signature.jar


Danh sách các phần tử trong lệnh trên:
 
Yếu tố Sự miêu tả

Dtmp.dir (bắt buộc)

Đây là bất kỳ vị trí tạm thời nào có quyền truy cập đọc / ghi để lưu trữ tệp trong quá trình xử lý tạm thời cục bộ trong môi trường của máy khách.

Điều này sẽ được làm sạch tự động bởi tiện ích

DtrustStore.path (bắt buộc)

thư mục của tệp .jks (kho khóa chứa chứng chỉ theo môi trường) Tệp sẽ được cung cấp bởi nhóm Giới thiệu VN PASS

DparentCert.path (bắt buộc)

thư mục của tệp .pem (được sử dụng để lưu trữ chứng chỉ SSL và các khóa riêng được liên kết của chúng theo môi trường)Tệp sẽ được cung cấp bởi nhóm Giới thiệu VN PASS

Dquarkus.profile (bắt buộc)

Môi trường mục tiêu của VN PASS (dàn dựng hoặc sản xuất)

Dtx.clientId (bắt buộc)

Client_id (do nhóm Giới thiệu đưa ra và được bao gồm tự động) - Được sử dụng theo môi trường

-Dtx / mp-rest / url (bắt buộc)

URL cơ sở của VN PASS url miền tùy thuộc vào môi trường, tức là staging = https://stg-id.uaepass.ae , production = https://id.uaepass.ae

-Dtx2 / mp-rest / url (bắt buộc)

-Dtx2 / mp-rest / url (bắt buộc) --- Ký URL phụ trợ tùy thuộc vào môi trường, tức là dàn dựng = https://stg-apis.uaepass.ae, https://apis.uaepass.ae sản xuất

Dtx.apiKey (bắt buộc)

Cơ sở 64 giá trị được mã hóa của id khách hàng và bí mật máy khách (do nhóm Giới thiệu đưa ra và được bao gồm tự động) - Được sử dụng theo môi trường

Dtx.signIndenRedirectUrlV2

url sẽ được chuyển hướng sau khi signIdentites và id giao dịch được tạo

Dtx.tokenRedirectUrlV2

URL sẽ được chuyển hướng sau khi mã thông báo được tạo

Dquarkus.http.port(bắt buộc)

theo yêu cầu SP, nó có thể được thay đổi

Dmax.allowed.file.size (bắt buộc)

Kích thước tệp được phép tối đa

Dmax.allowed.files.count (bắt buộc)

Số lượng tệp tối đa được phép là 10


Vui lòng tìm ảnh chụp nhanh bên dưới của các vị trí thư mục bên dưới để tham khảo:

Vị trí thư mục nơi tệp digital-signature.jar được đặt:


Vị trí thư mục nơi đặt tệp .jks và .pem:

Was this helpful?

Thank you!

Hotline Hotline