Firmar varios hashes en Postman con un SAD
Esta guía utiliza el método de autenticación Flujo de credenciales del cliente. Explica qué llamadas a la API deben ejecutarse y cuántas veces es necesario realizar la ejecución para firmar varios hashes con un solo SAD.
Nota
En este método, se necesita precalcular la cantidad de hashes deseados con las llamadas a la API “3 - PDF Service: Registrar un documento” y “4 - PDF Service Crear un hash” antes de ejecutar “6 - DTM: extendTransaction” y “7 - DTM: Firmas CSC SignHash”.
La firma en la respuesta “7 - DTM: Firmas CSC SignHash” corresponde al orden de los hashes enviados en su solicitud de llamada a la API.
Puede ejecutar la llamada a la API “8 - PDF Service: Incrustar firma” hasta 200 veces por ciclo para incrustar las firmas en los documentos.
Para firmar un hash, ejecute las solicitudes a la API que figuran a continuación:
Nota
Este autentificador es válido por una hora, pero DigiCert® puede extenderlo 24 horas más.
En la ventana de Postman, seleccione Colecciones (menú ubicado a la izquierda) > PDF Service 2.0 > Lista de credenciales DTM CSC.
En la ventana de la derecha, cambie a la pestaña Autorizaciones.
Seleccione Obtener un nuevo autentificador de acceso.
En la nueva ventana emergente, seleccione Continuar.
Para aplicar el autentificador de acceso, seleccione Usar autentificador.
Para obtener una lista de las credenciales (certificados) almacenados en su cuenta de DigiCert ONE, haga lo siguiente:
Abra la colección PDFService-2-0-SealSign CADES - Flujo de autentificadores de API - La firma visible funciona.
Seleccione 1 - Lista de credenciales DTM CSC > Enviar.
En el cuerpo del mensaje se muestran los CredentialIDs (certificados) usados de DigiCert ONE.
Para obtener una visión general de las funciones utilizadas en DigiCert ONE, siga estos pasos:
Seleccione 2 - Información sobre las credenciales DTM CSC > Enviar.
Verá las funciones utilizadas en DigiCert ONE.
Para registrar un documento, haga lo siguiente:
Seleccione 3 - PDF Service: Registrar un documento.
Configure el valor de la variable “tsa_url” ingresando la URL de la autoridad de la marca de tiempo que utilizará para firmar documentos.
Seleccione Enviar.
Para modificar la apariencia de la firma, utilice las configuraciones que se indican a continuación:
Configuración | Descripción |
|---|---|
Tipo (opcional) | Según el tipo, puede generar un documento certificado de MDP (detección y prevención de modificaciones de documentos). La opción predeterminada no está certificada y muestra una marca de verificación verde. La opción certificada muestra una cinta con un sello. Ejemplos: NOT_CERTIFIED CERTIFIED_NO_CHANGES_ALLOWED CERTIFIED_FORM_FILLING CERTIFIED_FORM_FILLING_AND_ANNOTATIONS |
preservation_size (opcional) | Especifique el tamaño reservado para incrustar la firma en bytes. El valor debe ser un múltiplo de 1024. (Formato: int32). |
signature_rectangle (opcional) | Defina la posición y el tamaño de la firma digital. La opción predeterminada es una firma invisible. La posición se determina mediante cuatro valores que representan la esquina inferior izquierda (x, y) y las dimensiones (w, h) del rectángulo. Las unidades se expresan en puntos PDF (1 punto = 1/72 pulgadas, A4 = 595 x 842 puntos, carta = 612 x 792 puntos, 1 cm = 28 3465 puntos) y se toma como referencia la esquina inferior izquierda de la página. Si el ancho o la altura de la firma es igual a cero o a un número negativo, esta será invisible, es decir, no se verá en el documento. (Formato: int32). Página: ingrese la página en la que se agregará la firma. x: ingrese el valor x de la esquina inferior izquierda. y: ingrese el valor y de la esquina inferior izquierda. w: ingrese el ancho del rectángulo. h: ingrese la altura del rectángulo. |
signature_text1 (opcional) | Ingrese un texto de firma específico en lugar del estándar. (Por ejemplo: nombre del firmante). |
Motivo (opcional) | Ingrese un motivo. |
Contacto (opcional) | Ingrese un contacto. |
font_text1 (opcional) | Ingrese el nombre de la fuente. |
font_size_text1 (opcional) | Ingrese el tamaño de la fuente del texto de la firma 1. Si no se especifica un atributo, se utilizará el tamaño predeterminado de 16 pt. (Formato: int32). |
signature_text2 (opcional) | Ingrese un texto de firma específico en lugar del estándar. (Por ejemplo: nombre del firmante, motivo o hora de la firma). |
font_text2 (opcional) | Ingrese el nombre de la fuente. |
font_size_text2 (opcional) | Ingrese el tamaño de la fuente del texto de la firma 2. Si no se especifica un atributo, se utilizará el tamaño predeterminado de 8 pt. (Formato: int32). |
signature_fill_color (opcional) | Ingrese el color de fondo en formato RVA. El valor predeterminado es 16761024 (rojo = 192, verde = 192, azul = 255). El valor del color se calcula de la siguiente manera: rojo + verde * 256 + azul * 256 * 256. Para que el rectángulo sea transparente, fije el valor en -1. (Formato: int32). |
signature_stroke_color (opcional) | Ingrese el color del contorno de la firma en formato RVA. El valor predeterminado es 8405056 (rojo = 64, verde = 64, azul = 128). El valor del color se calcula de la siguiente manera: rojo + verde * 256 + azul * 256 * 256. Para que sea transparente, fije el valor en -1. (Formato: int32). |
signature_line_width (opcional) | Ingrese el grosor de la línea que rodea la firma en puntos. (Formato: int32). |
background_image (opcional) | Inserte la imagen que se va a incrustar en el campo de la firma. (Codificada en Base64). (Por ejemplo: “dGVzdA==”). |
Para crear un hash, haga lo siguiente:
Adjunte el documento.
Seleccione 4 - PDF Service: Crear hash > Enviar.
Repita el paso 3. “Registrar un documento” y el paso 4. “Crear un hash” de forma consecutiva hasta alcanzar la cantidad de hashes que desea calcular.
Recibirá los DocumentIDs y sus correspondientes hashes.
Sugerencia
Suba diferentes documentos en PDF después de cada ejecución del paso 3. “Registrar un documento” para calcular hashes y probar con documentos distintos.
Para crear un dato de activación de firma (Signature Activation Data, SAD) y comenzar la autorización utilizando la aplicación Go>Sign Mobile, haga lo siguiente:
Seleccione 5 - DTM: Autorizar la credencial CSC > Enviar.
Diríjase a la aplicación Go>Sign Mobile > Solicitud de autorización > Autorizar.
Recibirá un SAD válido requerido para firmar el hash. Necesitará este dato en el paso “Incrustar firma”.
Nota
En el entorno de demostración de DigiCert ONE, los valores predeterminados para la reautorización utilizando la aplicación Go>Sign Mobile se fijan en “250,000 hashes o 30 días”.
En el entorno de producción de DigiCert ONE, los valores predeterminados para la reautorización utilizando la aplicación Go>Sign Mobile se fijan en “1 millón de hashes o 95 días”.
Para firmar un hash, siga estos pasos:
Seleccione 7 - DTM: Firmas CSC SignHash > Enviar.
Recibe una firma por cada hash enviado.
Para firmar un hash nuevo, siga estos pasos:
Seleccione 8 - PDF Service: Incrustar firma.
Se actualizará automáticamente el SAD generado en el paso Autorizar credencial.
Seleccione Enviar.
Repita este paso nuevamente para cada firma de forma individual en el orden en que las recibió en “4 - PDF Service: Crear un hash”.
Para descargar el PDF y verificar la validez de la firma, siga estos pasos:
Seleccione Guardar como ejemplo (parte inferior derecha) > Guardar respuesta en archivo.