Firmar PDF con hash en la primera ejecución de solicitudes a la API
Para firmar un hash, ejecute las solicitudes a la API que figuran a continuación:
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.
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.
Recibirá una firma válida en el cuerpo del mensaje para incrustar en el documento.
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.
Recibirá su documento con la firma incrustada.
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.
Abra el PDF en Adobe Acrobat Reader para verificar la validez de la firma.
Nota
Los PDF creados en el entorno de demostración de DigiCert ONE mostrarán una firma inválida, ya que el certificado utilizado es un certificado de demostración y no de confianza. Sin embargo, puede clasificar el certificado raíz como confiable en Adobe Acrobat Reader para que se muestre un símbolo de verificación verde.