Skip to main content

Configura PDF Service 2.0

Prerequisites

Configura l’applicazione Go>Sign Mobile

L’applicazione Ascertia Go>Sign Mobile ti consente di autorizzare in modo sicuro e approvare la firma dei documenti nell’Unione Europea (UE) e in Svizzera (CH).

Nota

Puoi configurare solo un dispositivo per utente.

  1. Scarica l’applicazione Ascertia Go>Sign Mobile sul tuo dispositivo mobile.

  2. Seleziona l’icona Impostazioni.

  3. Seleziona Scansiona codice QR per scansionare il codice QR nell’e-mail o modifica manualmente il server predefinito in:

    CH

    https://ch.signingportal.com/adss/service/ras

    Firma digitale EU

    https://www.signingportal.com/adss/service/ras

    eSeal UE

    https://nl.signingportal.com/adss/service/ras

  4. Seleziona Salva.

  5. Torna alla schermata principale e aggiungi l’ID utente fornito nell’e-mail:

  6. Riceverai password univoci (OTP) tramite email e sms.

  7. Inserisci entrambi gli OTP nella schermata di registrazione dispositivo Go>Sign Mobile.

  8. Seleziona Verifica.

Quando firmi un documento, ti verrà chiesto di confermare la tua identità in Go>Sign Mobile.

Scaricare catena certificato

La catena dei certificati che scarichi contiene i valori della catena dei certificati, del certificato intermedio e radice. Per configurare Postman dovrai richiedere questi valori.

  1. Accedi a DigiCert ONE con le tue credenziali da firmatario.

  2. In DigiCert ONE, nel menu Manager (in alto a destra), seleziona Document Trust.

  3. Nel menu DigiCert​​®​​ Document Trust Manager, seleziona Credenziali > Tutte le credenziali.

  4. Seleziona il soprannome delle credenziali con cui desideri firmare.

  5. Nella pagina dei dettagli credenziale, naviga fino a Dettagli certificato.

  6. Seleziona Scaricare catena certificato per scaricare la catena dei certificati, il certificato intermedio e la radice.

  7. Apri la catena dei certificati scaricata in un editor di testo come Notepad++ e salva il file.

Configura Postman

Configura il tuo account Postman per il test e gestisci le richieste API DigiCert​​®​​ Document Trust Manager.

1. Scarica raccolta Postman

Scarica raccolta Postman per DigiCert​​®​​ Document Trust Manager con PDF Service 2.0.

2. Importa file PDF Service 2.0 in Postman

Per importare i file in Postman, segui questa procedura:

  1. Apri Postman.

  2. Nella finestra Postman, seleziona Collections (Raccolte) (menu a sinistra) > Import (Importa).

  3. Trascina i file delle raccolte scaricati e decompressi nella finestra Postman per importarli.

  4. Seleziona Environments (Ambienti) (menu a sinistra) > Import (Importa).

  5. Trascina i file degli ambienti scaricati e decompressi nella finestra Postman per importarli.

3. Configura ambiente Postman

Nota

Per configurare l’ambiente Postman ti serviranno il certificato credenziali, la catena dei certificati e il foglio dati Document Trust Manager precedentemente scaricati.

  1. Nella finestra Postman, seleziona Environment (Ambiente) (menu a sinistra) > PDF Service 2.0 Environment (Ambiente PDF Service 2.0).

  2. Imposta i valori variabili dal foglio dati.

    Inserisci i valori dalla sezione Accesso nel foglio dati nella colonna Valore attuale corrispondente come mostrato di seguito:

    Variabile

    Valore corrente

    Note

    base_dcone_url

    URL servizio

    Rimuovi “/documentmanager” dall’URL

    client_id

    ID cliente

    client_secret

    ClientSecret

    oauth2_url

    URL servizio

    Includi “/documentmanager” nell’URL

  3. Imposta valori della catena dei certificati.

    Inserisci i valori dalla catena dei certificati scaricata nella colonna Valore attuale corrispondente come mostrato di seguito:

    Variabile

    Valore corrente

    cert_chain1

    Catena dei certificati

    cert_chain2

    Certificato intermedio

    cert_chain3

    Radice

  4. Seleziona l’icona Salve (Salva) (in alto a destra).

URL data e ora

Gli URL dell'autorità di data/ora che utilizzerai per firmare i documenti nella fase di richiamo API documento di registro sono:

Per l’uso con i certificati svizzeri

http://ts.quovadisglobal.com/ch

Per l’uso con i certificati UE

http://ts.quovadisglobal.com/eu

Docker

  1. Download and install Docker.

  2. Open Docker.

  3. Download and save the Docker Image from the TGZ file.

  4. Open the folder where Docker Image is saved, then open command prompt.

  5. Stop and remove any running containers of Content Signing Service, if already installed:

    • If running in a single container:

      ```bash
      docker stop content-signing-service
      docker rm content-signing-service
```

    • If running in multiple containers (use the old docker-compose file used for scaling):

      ```bash
     docker compose -f docker-compose.yml down
```

    • Run commands:

      ```bash
    docker load --input './content-signing-service.tar.gz'
```

  6. To persist the data of the database and logs, create docker volume by running the commands:

    ```bash
  docker volume create --name=content-signing-service-data
  docker volume create --name=content-signing-service-logs
```

  7. Give mandatory Environment Variables:

    • API_KEY: API KEY for validating the license.

    • DTM_BASE_URL: Document Trust Manager base URL.

  8. Run Content Signing Service

    To run Content Signing Service:

    ```bash
  docker run -d -e API_KEY=<<API_KEY>> -e DTM_BASE_URL=<<DTM_BASE_URL>> -v content-signing-service-data:/app/db -v content-signing-service-logs:/app/logs -p 8080:8080 --name content-signing-service 
```

  9. Customize Docker as per your requirements:

    1. Custom port number

      Default service port is 8080. To modify the port number:

      ```bash
  docker run -d -e API_KEY=<<API_KEY>> -e DTM_BASE_URL=<<DTM_BASE_URL>> -p <<DESIRED_PORT_NUMBER>>:8080 --name content-signing-service content-signing-service 
```

    2. Database

      Data is stored temporarily by default. To make data persistent, write the database file to docker volume by running command:

      ```bash
    docker volume create --name=content-signing-service-data
    docker run -d -e API_KEY=<<API_KEY>> -e DTM_BASE_URL=<<DTM_BASE_URL>> -v content-signing-service-data:/app/db --name content-signing-service content-signing-service 
```

    3. Logs

      Logs are stored temporarily. To make logs persistent, use docker volume by running command:

      ```bash
  docker volume create --name=content-signing-service-logs
  docker run -d -e API_KEY=<<API_KEY>> -e DTM_BASE_URL=<<DTM_BASE_URL>> -v content-signing-service-logs:/app/logs --name content-signing-service content-signing-service 
```

      Log levels are set to *`INFO`* by default. To modify, update the environment variable by running command:

      ```bash
  docker run -d -e API_KEY=<<API_KEY>> -e DTM_BASE_URL=<<DTM_BASE_URL>> -e root_log_level=<<DESIRED_LOG_LEVEL>> -e app_log_level=<<DESIRED_LOG_LEVEL>> --name content-signing-service content-signing-service 
```

What's next

In questa sezione: