UAE PASS
  • UAE PASS
  • Overview
  • Getting Onboarded with UAE PASS
    • Onboarding Process for UAE PASS Service Providers
      • Initiation Phase
      • Development Phase
      • Assessment Phase
      • Go live Phase
  • Quick Start Guide - UAE PASS Staging Environment
    • User Account Types
    • Create Staging UAE PASS Account
    • Upgrade Staging UAE PASS Account
    • Testing Credentials for POC
    • Conduct a POC with UAE PASS Authentication
  • Feature Guides
    • Authentication
      • Web Integration
        • Introduction
        • Pre-Requisites
        • Endpoints
        • 1. Authorization Code
        • 2. Access Token
        • 3. User Information
        • 4. Logout
        • Login Button
        • Authentication Postman Walkthrough
      • Mobile Integration
        • Introduction
        • Pre-Requisites
        • Requirements
        • Guide
          • SDK
          • API
        • SDK Integration
      • Token Validation API
        • Introduction
        • Pre-Requistes
        • Endpoints
        • Integration Steps
          • 1. Verify access token API using Basic Authentication
          • 2. Obtaining Authenticated User Information from the Access Token
        • Validation Decisions
      • User Linking
        • Automatic Linking
        • Manual Linking
        • Corporate Account
    • Digital Signature
      • Digital Signature (Single Document)
        • Signing Guide
          • Endpoints
          • Document Signing Steps
            • 1. Token
            • 2. Create Signer Process
            • 3. Sign Document
            • 4. Obtaining Document
            • 5. LTV Configuration
              • Integration Web Services
              • Postman Collection for LTV
            • 6. Deleting Document
          • Document Signature verification Process
          • Postman Collection for Digital Signature
            • Digital Signature Postman Walkthrough
        • Verification API Integration
          • Web Service Details
          • Postman Collection for Signature Verification API
      • Digital Signature (Multiple Document)
        • Signing Guide
          • Endpoints
          • Document Signing Steps
            • 1. Token
            • 2.Create Documents
            • 3. Create Signer Process
            • 4. Sign Document
            • 5. Obtaining Document
            • 6. LTV Configuration
              • Integration Web Services
              • Postman Collection for LTV
            • 7. Deleting Document
          • Document Signature verification Process
          • Postman Collection for Multiple Document Signing.
    • e-Seal
      • Introduction
      • DESC Process for Dubai Entities
        • Process overview
        • Detailed DESC process description
      • ICA Process for Non-Dubai Entities
        • Onboarding Process
        • Obtaining Credentials and Certificates
      • Integration Web Service
        • PAdES eSeal Signing
        • CAdES eSeal Signing
        • eSeal verification
        • eSeal error codes
      • Postman Collection
    • Hash Signing
      • Introduction
      • Hash Signing (Single Document)
        • Hash Signing (Java SDK Set Up)
          • Quick Setup
          • Hash Signing Process
            • 1. Start the Process
            • 2. Initiate Signing Process
            • 3. Sign PDF Document
          • Endpoints
          • Postman Collection
          • Utility Files
      • Bulk Hash Signing (Multiple Documents)
        • Quick Setup
        • Hash Signing Process
          • 1. Start Signing Process
          • 2. Initiate Signing Process
          • 3. Sign PDF Document
        • Endpoints
        • Postman Collection
  • Web Registration
    • Introduction
    • Steps to create account
    • Endpoints
      • 1. Access Code
      • 2. Access Token
      • 3. User Information
  • Facial Biometric Transactions Confirmation
    • Web Integration
      • Endpoints
      • Integration Steps
        • Obtain Authorization Code
        • Obtain Access Token
        • Obtain User Info
        • Log out User
    • Mobile Integration
      • Mobile Integration Guidelines
  • Guidelines
    • Use-Case Guidelines
      • Standard Authentication Scenarios for Service Provider Use Cases
      • Standard Digital Signature Scenarios for Service Provider Use Cases
      • Standard Implementation Guidelines
    • Design Guidelines
      • UAEPASS Button Guideline
      • Text Message Guidelines
  • Resources
    • Attributes List
    • Sample Apps
    • Staging Apps
    • Assets
  • FAQ
    • Common Integration Issues
  • Versioning
Powered by GitBook
On this page
  • Pre-Requisites
  • Running service instructions:

Was this helpful?

  1. Feature Guides
  2. Hash Signing
  3. Hash Signing (Single Document)
  4. Hash Signing (Java SDK Set Up)

Quick Setup

Pre-Requisites

System Requirements:

  • OS 64-bit arch-type (Windows, Linux or Unix).

  • Java Development Kit version 11/64-bit or later.

Service requirements (Below are configurable):

  • Minimum memory 512 megabytes.

  • Temp. directory with no restrictions. (Read/Write).

Business requirement:

  • User who want to use this service should have qualified signing certificate , otherwise the user will not be able to reach the step of signing a document.

  • For Production deployment process the SP need to be whitelisted their IP at DESC side to be able to access this URL

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

  • In case of any SSL issues please import the DESC TSA root and intermediate certificates to resolve the error. The certificate needs to be imported in Java cacerts. In order to obtain the certificates please reach out to the onboarding/operations team.

Running service instructions:

  • Download .jar file along with .jks and .pem files that will be provided from UAEPASS.

  • SP need to install the TSA certificate using below command:

"keytool -importcert -file {file path} -keystore cacerts -keypass changeit -storepass changeit -noprompt -alias tsa_Staging"
  • Get the TSA Staging certificate from respective onboarding team

  • Please note that the TSA certificate needs to be installed in java cacerts for both the environments (staging and production).

  • Execute the below command after verifying that you have Java 11+ successfully installed (you can check by executing command “java -version” in terminal window), values in red according to your environment values:

Initiate the command to initialize the Jar (parameters to change as per environment):

java -Dtmp.dir=D:\Documents\StagingOnboarding\HashSigning\UtilityFiles2\UtilityFiles2 -DtrustStore.path=D:\Documents\StagingOnboarding\HashSigning\UtilityFiles2\UtilityFiles2\tsa-staging-tx-dev.jks -DparentCert.path=D:\Documents\StagingOnboarding\HashSigning\UtilityFiles2\UtilityFiles2\parentCertificate-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

List of elements in the above command:

Element
Description

Dtmp.dir (mandatory)

This is any temporary location with read/write access to store files during processing temporarily locally in client’s environment.

This will be cleaned automatically by utility

DtrustStore.path(mandatory)

directory of .jks file(keystore which contains certificates as per the environment) File will be provided by UAE PASS Onboarding team

DparentCert.path(mandatory)

directory of .pem file(used to store SSL certificates and their associated private keys as per the environment)File will be provided by UAE PASS Onboarding team

Dquarkus.profile(mandatory)

Target environment of UAE PASS (staging or production)

Dtx.clientId(mandatory)

Client_id (given by Onboarding team and automatically included) - To be used as per the environment

-Dtx/mp-rest/url(mandatory)

-Dtx2/mp-rest/url(mandatory)

Dtx.apiKey(mandatory)

Base 64 encoded value of client id and client secret (given by Onboarding team and automatically included) - To be used as per the environment

Dtx.signIndenRedirectUrlV2

url to be redirected once the signIdentites and transaction id are generated

Dtx.tokenRedirectUrlV2

url to be redirected once the token is generated

Dquarkus.http.port(mandatory)

as per SP requirement it can be changed

Dmax.allowed.file.size(mandatory)

Max allowed file size

Dmax.allowed.files.count(mandatory)

Max allowed file count is 10

Please find below snapshot of folder locations below for reference:

Folder location where digital-signature.jar file is placed:

Folder location where .jks and .pem files are placed:

PreviousHash Signing (Java SDK Set Up)NextHash Signing Process

Last updated 3 months ago

Was this helpful?

UAEPASS Base URL domain url depending on environment i.e. staging= , production=

-Dtx2/mp-rest/url(mandatory)---Signing Backend URL depending on environment i.e. staging = , production

https://stg-id.uaepass.ae
https://id.uaepass.ae
https://stg-apis.uaepass.ae
https://apis.uaepass.ae