Skip to main content

Configurar PDF Service 2.0

Prerequisites

Configurar la aplicación Go>Sign Mobile

Con la aplicación Go>Sign Mobile de Ascertia puede autorizar y aprobar de manera segura la firma de documentos en la Unión Europea (UE) y en Suiza (CH).

Nota

Puede configurar únicamente un dispositivo por usuario.

  1. Descargue la aplicación Go>Sign Mobile de Ascertia en su dispositivo móvil.

  2. Seleccione el ícono de Configuración.

  3. Seleccione Escanear código QR para escanear el código QR que figura en su correo electrónico o cambiar manualmente el servidor predeterminado a:

    CH

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

    Firma digital en la UE

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

    Sello electrónico en la UE

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

  4. Seleccione Guardar.

  5. Regrese a la pantalla principal y agregue el id. de usuario proporcionado en su correo electrónico.

  6. Recibirá contraseñas de un solo uso (OTP) por correo electrónico y mensaje de texto.

  7. Ingrese los dos OTP en la pantalla de registro del dispositivo Go>Sign Mobile.

  8. Seleccione Verificar.

Cuando firme un documento, se le pedirá que confirme su identidad en Go>Sign Mobile.

Descargar cadena del certificado

La cadena de certificados que descarga contiene la cadena de certificados, el certificado intermedio y los valores raíz. Necesitará estos valores para configurar Postman.

  1. Inicie sesión en DigiCert ONE con sus credenciales de firmante.

  2. En DigiCert ONE, en el menú Gestor (arriba a la derecha), seleccione Confianza en los documentos.

  3. En el menú de DigiCert​​®​​ Document Trust Manager, seleccione Credenciales > Todas las credenciales.

  4. Seleccione el apodo de la credencial con la que desea firmar.

  5. En la página Detalles de la credencial, diríjase a Detalles del certificado.

  6. Seleccione Descargar cadena de certificados para descargar la cadena del certificado, el certificado intermedio y los valores raíz.

  7. Abra la cadena de certificados descargada en un editor de texto como Notepad++ y guarde el archivo.

Configurar Postman

Configure su cuenta de Postman para probar y gestionar las solicitudes de API de DigiCert​​®​​ Document Trust Manager.

1. Descargar la colección de Postman

Descargue la colección de Postman para DigiCert​​®​​ Document Trust Manager con PDF Service 2.0.

2. Importar archivos de PDF Service 2.0 en Postman.

Para importar archivos en Postman, siga estos pasos:

  1. Abra Postman.

  2. En la ventana de Postman, seleccione Colecciones (menú ubicado a la izquierda) > Importar.

  3. Arrastre los archivos de Colecciones descargados y descomprimidos en la ventana de Postman para importarlos.

  4. Seleccione Entornos (menú ubicado a la izquierda) > Importar.

  5. Arrastre los archivos de Entornos descargados y descomprimidos en la ventana de Postman para importarlos.

3. Configurar el entorno de Postman

Nota

Para configurar su entorno de Postman, necesitará el certificado de credenciales, la cadena de certificados y la ficha técnica del Document Trust Manager que descargó anteriormente.

  1. En la ventana de Postman, seleccione Entornos (menú ubicado a la izquierda) > Entorno de PDF Service 2.0.

  2. Establezca los valores de las variables utilizando la ficha técnica.

    Ingrese los valores desde la sección Acceso en la ficha técnica en la columna de Valor actual correspondiente, como se muestra a continuación:

    Variable

    Valor actual

    Notas

    base_dcone_url

    Servicios URL

    Quitar “/documentmanager” de la URL

    client_id

    Id. del cliente

    client_secret

    ClientSecret

    oauth2_url

    Servicios URL

    Incluir“/documentmanager” en la URL

  3. Establezca los valores de la cadena de certificados.

    Ingrese los valores desde la cadena de certificados descargada en la columna de Valor actual correspondiente, como se muestra a continuación:

    Variable

    Valor actual

    cert_chain1

    Cadena de certificados

    cert_chain2

    Certificado intermedio

    cert_chain3

    Raíz

  4. Seleccione el ícono de Guardar (arriba a la derecha).

URL de la marca de tiempo

Estas son las URL de la autoridad de la marca de tiempo que utilizará para firmar documentos en la etapa de llamada a la API de Registro de documentos:

Para certificados de Suiza

http://ts.quovadisglobal.com/ch

Para certificados de la 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

En esta sección: