Servidor de firma de PDF (Tutorial para desarrolladores)

Las firmas digitales están entre las técnicas criptográficas que aseguran la fuente, la integridad y la no replicación de los documentos digitales. En la mayoría de los casos, es bastante diferente de las formas convencionales de firmas manuscritas donde las técnicas de encriptación avanzadas aseguran el documento y verifican la identidad del firmante. Aplicado a un PDF, una firma digital crea un "sello" electrónico, que parece un certificado que identifica un documento como no alterado desde que fue firmado. Este sello detalla un sistema de cifrado que lleva un algoritmo matemático que codifica los datos de la firma en el documento. Las firmas digitales permiten que se mantenga un registro inmutable de cambios con el documento, además de identificar la parte firmante. En este artículo, vamos a crear un servidor de firma de PDF con la ayuda de IronSecureDoc.

Cómo utilizar el servidor de firma de PDF

1. Instala la imagen de docker de IronSecureDoc.
2. Ejecuta la imagen de docker con un puerto específico y una clave de licencia.
3. Inicializa IronSecureDoc Client con una aplicación .NET.
4. Obtén la URL y pásala al IronSecureDoc Client mientras creas el objeto.
5. Pasa el parámetro requerido dentro de la API de IronSecureDoc Client.
6. Obtén los documentos PDF procesados y guárdalos en la ubicación.

¿Qué es IronSecureDoc?

Iron Software IronSecureDoc es la solución omnipotente para la seguridad de los documentos. Esto protegería contra la filtración de información sensible a través de varios formatos de documentos. Soporta métodos de encriptación de última generación para asegurar documentos contra accesos no autorizados, de modo que solo los lectores o editores designados tengan el mandato de verlos o modificarlos. También soporta firmas digitales, identificando a un creador de documentos como autorizado y asegurando que su contenido no sea manipulado desde que se firmó.

Además, proporciona un intercambio seguro de documentos y mantenimiento con control sobre cómo se circulan y con quién se comparte. IronSecureDoc incorpora estas características para ayudar a organizaciones e individuos a mantener el cumplimiento con la protección de datos y prevenir violaciones de datos. La relevancia de esta interfaz muy fácil de usar, con un conjunto de características de seguridad, lo convierte en un software muy relevante para cualquier empresa que desee ofrecer un nivel más alto de seguridad al compartir documentos.

Características de IronSecureDoc

IronSecureDoc viene con una multitud de características para mejorar la seguridad de los documentos y mantenerlos intactos. Algunas de sus características clave incluyen:

Encriptación Avanzada: Esta característica ayuda a proteger documentos contra ojos no autorizados, asegurando así la confidencialidad de la información a través de algoritmos de encriptación robustos y fuertes.

Firmas Digitales: Esta propiedad testifica el hecho de que las firmas digitales pueden adjuntarse a cualquier documento para aseveraciones de que es original y no ha sido alterado desde que se firmó, sino también quién lo ha firmado.

Intercambio Seguro: Comparte documentos de manera segura y especifica a las personas autorizadas para ver e incluso interactuar con ellos. Detecta cambios no autorizados o manipulaciones a un documento, ayudando así a salvaguardar la integridad del documento.

Conformidad: Esto lleva a las organizaciones al cumplimiento con numerosas regulaciones sobre protección y estándares industriales, asegurando el manejo y la transmisión segura de documentos.

Facilidad de Uso: Proporciona fácil acceso a través de su interfaz fácil de usar al manejar funciones de seguridad y configuraciones de documentos.

Registros de Auditoría: Crea registros de historia para acceso y modificación, permitiendo así transparencia y responsabilidad.

Instalar la imagen de Docker IronSecureDoc

Instalar y ejecutar una imagen Docker de IronSecureDoc es fácil. Así es como podrías hacerlo:

Instalar Docker

En primer lugar, asegúrate de que Docker está instalado en tu sistema. Puedes descargar Docker desde el sitio web oficial de Docker y seguir las instrucciones de instalación allí para tu sistema operativo.

Extraiga la imagen Docker de IronSecureDoc

Abre una terminal o un símbolo del sistema y ejecuta este comando para extraer la imagen Docker de IronSecureDoc del repositorio.

docker pull ironsoftwareofficial/ironsecuredoc

docker pull ironsoftwareofficial/ironsecuredoc

Ejecutar el contenedor Docker

Después de haber extraído la imagen, el comando siguiente debería iniciar un nuevo contenedor. Puede personalizar el indicador -p para la asignación de puertos o el --rm utilizado para eliminar uno o más contenedores Docker en ejecución del host Docker.

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

En el ejemplo anterior, mapea el puerto 8080 del host al del contenedor y asigna un nombre al contenedor creado en IronSecureDoc. Una vez que se ejecute el comando, se mostrará como a continuación.

Una vez que se ejecutan, puede acceder a la lista de API proporcionadas por IronSecureDoc a través del navegador (http://localhost:8080/swagger/index.html) o cualquier conexión de aplicación.

Crear un nuevo proyecto de Visual Studio

Visual Studio hace que sea muy ampliamente y fácilmente posible desarrollar proyectos de consola. A continuación hay algunos pasos simples para ayudarte a comenzar con una aplicación de consola en el entorno de Visual Studio.

Antes de que puedas usar Visual Studio, asegúrate de haberlo instalado en tu computadora.

Iniciar un nuevo proyecto:

Después de elegir Archivo, Proyecto, selecciona el menú Nuevo.

Por favor selecciona "Aplicación de Consola" o "Aplicación de Consola (.NET Core)" de la lista de referencias de plantillas de proyecto disponibles a continuación.

Para darle un nombre a tu proyecto, completa el campo "Nombre".

Selecciona la ubicación para tu proyecto.

Haz clic en "Crear" para abrir el proyecto de aplicación de consola.

¿Qué es Iron Software.SecureDoc.Client?

Iron Software.SecureDoc.Client Library es fácil de integrar en sus aplicaciones .NET existentes para aprovechar lo que IronSecureDoc tiene para ofrecer en cifrado, redacción y firma digital de PDF a través de sencillas llamadas REST API. Los desarrolladores pueden asegurar fácilmente los documentos en sus aplicaciones con integridad garantizada utilizando la biblioteca Iron Software.SecureDoc.Client, todas las operaciones se mantienen en el sitio para una alta protección de los datos. Ya sea para redactar información sensible, certificar la firma de documentos o aplicar el cifrado de documentos, Iron Software.SecureDoc.Client cuenta con las herramientas para realizar todas estas tareas de forma eficiente y segura.

Instalar Iron Software.SecureDoc.Client

En primer lugar, ejecute la instalación de la biblioteca Iron Software.SecureDoc.Client, ya que el próximo parche depende de ella. Finalmente, para completar esto, abre la Consola del Administrador de Paquetes NuGet y ejecuta el comando siguiente:

Install-Package Iron Software.SecureDoc.Client

Install-Package Iron Software.SecureDoc.Client

También puede buscar el paquete "Iron Software.SecureDoc.Client" en el gestor de paquetes NuGet. Elija de la lista de todos los paquetes NuGet relacionados con Iron Software.SecureDoc.Client cuál debe descargarse.

Crear una identificación digital autofirmada

Normalmente, las transacciones comerciales sensibles pedirán una ID de una autoridad certificadora, no una autofirmada.

En Adobe Acrobat, haz clic en el menú hamburguesa (Windows) o menú Acrobat (macOS), luego selecciona Preferencias.

En la lista de Categorías a la izquierda, selecciona Firmas. A la derecha, haz clic en Más junto a Identidades y Certificados de Confianza.

A la izquierda, selecciona Identificaciones Digitales, luego haz clic en el botón Agregar ID.

Agregar una nueva ID digital

Ahora selecciona la opción de botón de radio "Una nueva ID digital que quiero crear ahora" y luego haz clic en Siguiente.

Crear una nueva ID digital

Indica dónde guardar la ID digital y luego haz clic en Siguiente.

Nuevo Archivo de ID Digital PKCS#12

Guarda la información de la ID digital en un archivo .pfx en Windows y .p12 en macOS. Puedes transportar estos archivos entre sistemas operativos y usarlos con Acrobat. Si copias un documento a otro sistema operativo, Acrobat continuará usándolo.

Guarda la ID digital en un almacén común donde otras aplicaciones de Windows también puedan acceder a ella.

PKCS-identificación-digital

En el campo de tu ID digital, escribe tu nombre, dirección de correo electrónico y otra información personal; esto es lo que se mostrará dentro del cuadro de Firma y dentro del panel de Firmas cuando firmes o certifiques un documento.

Haz lo siguiente: Selecciona un elemento de la lista desplegable de Algoritmos de Clave. Desde un punto de vista de seguridad, un RSA de 2048 bits es más seguro que un RSA de 1024 bits. Pero un RSA de 1024 bits es más compatible con más dispositivos.

En el menú Usar ID digital Para, puedes especificar si usar la ID digital para Cifrado, Firma Digital, o ambos.

Haz clic en Siguiente.

Ingresa tu información de identidad

Escribe una contraseña para el archivo de la ID digital. A medida que escribes, el medidor de fuerza de contraseña evalúa tu contraseña y muestra la fortaleza de la contraseña con patrones de color. Confirma tu contraseña.

La ubicación predeterminada indicada en el cuadro de Nombre del Archivo será donde se mantenga el archivo de la ID digital. Haz clic en Examinar y elige otro lugar para guardar. Selecciona "Finalizar".

Introduce una contraseña para tu ID.

Si un archivo de ID digital comparte el mismo nombre, se te pedirá que lo reemplaces. Haz clic en Aceptar para reemplazar, o haz clic en Examinar y selecciona una ubicación diferente para almacenar el archivo.

Ahora se ha creado una ID. Puedes exportar el archivo de certificado para enviar a contactos para que puedan usarlo para verificar tu firma.

Firmar un documento PDF con IronSecureDoc

Abajo está el código de ejemplo que nos ayudará a firmar digitalmente el documento PDF con el archivo de certificado.

using IronSecureDoc;

Console.WriteLine("File Process started");

// Initialize the IronSecureDocClient with the URL of the locally hosted service
var client = new IronSecureDocClient("http://localhost:8080");

// Asynchronously attempt to connect to the IronSecureDoc service
if (await client.TryConnectAsync())
{
    // If connection is successful, certify the PDF document using the provided certificate
    var result = await client.CertifyAsync("Demo.pdf", "DemoSign.pfx", "Your certificate password here");
    
    // Save the signed PDF document to a new file
    File.WriteAllBytes("certify.pdf", result);
}

Console.WriteLine("File Process completed");

// Wait for user input before closing the console window, allowing the user to see the completion message
Console.ReadKey();

using IronSecureDoc;

Console.WriteLine("File Process started");

// Initialize the IronSecureDocClient with the URL of the locally hosted service
var client = new IronSecureDocClient("http://localhost:8080");

// Asynchronously attempt to connect to the IronSecureDoc service
if (await client.TryConnectAsync())
{
    // If connection is successful, certify the PDF document using the provided certificate
    var result = await client.CertifyAsync("Demo.pdf", "DemoSign.pfx", "Your certificate password here");
    
    // Save the signed PDF document to a new file
    File.WriteAllBytes("certify.pdf", result);
}

Console.WriteLine("File Process completed");

// Wait for user input before closing the console window, allowing the user to see the completion message
Console.ReadKey();

Imports IronSecureDoc

Console.WriteLine("File Process started")

' Initialize the IronSecureDocClient with the URL of the locally hosted service
Dim client As New IronSecureDocClient("http://localhost:8080")

' Asynchronously attempt to connect to the IronSecureDoc service
If Await client.TryConnectAsync() Then
    ' If connection is successful, certify the PDF document using the provided certificate
    Dim result = Await client.CertifyAsync("Demo.pdf", "DemoSign.pfx", "Your certificate password here")
    
    ' Save the signed PDF document to a new file
    File.WriteAllBytes("certify.pdf", result)
End If

Console.WriteLine("File Process completed")

' Wait for user input before closing the console window, allowing the user to see the completion message
Console.ReadKey()

Imports IronSecureDoc

Console.WriteLine("File Process started")

' Initialize the IronSecureDocClient with the URL of the locally hosted service
Dim client As New IronSecureDocClient("http://localhost:8080")

' Asynchronously attempt to connect to the IronSecureDoc service
If Await client.TryConnectAsync() Then
    ' If connection is successful, certify the PDF document using the provided certificate
    Dim result = Await client.CertifyAsync("Demo.pdf", "DemoSign.pfx", "Your certificate password here")
    
    ' Save the signed PDF document to a new file
    File.WriteAllBytes("certify.pdf", result)
End If

Console.WriteLine("File Process completed")

' Wait for user input before closing the console window, allowing the user to see the completion message
Console.ReadKey()

El siguiente código primero enviará un mensaje a la consola indicando que ha comenzado a procesar archivos. A continuación se confirmará la creación de un IronSecureDocClient utilizando la URL de un servicio IronSecureDoc alojado localmente. A continuación se muestra el archivo PDF de muestra.

A continuación, esta función intentará conectarse al servicio de forma asíncrona. Suponiendo que todo se conecte correctamente, llamará a CertifyAsync para firmar realmente el documento PDF, pasando las rutas del archivo PDF, el archivo del certificado de firma del PDF y la contraseña del certificado. Los resultados, representados como una matriz de bytes del PDF firmado, se guardarán en un nuevo archivo llamado certify.pdf.

Esto finalmente imprime en la consola que el archivo realmente ha sido procesado con éxito, luego espera la entrada del usuario antes de cerrar la ventana de la Consola. Esto mantiene abierta una ventana de consola para mostrar el mensaje de finalización al usuario antes de que la aplicación salga.

En el archivo procesado anterior, el documento PDF ha sido firmado por el certificado digital.

Conclusión

IronSecureDoc es una solución de seguridad documental integrada que asegura el más alto nivel de protección debido a sus robustas capacidades de encriptación y certificación. La biblioteca cliente de IronSecureDoc permite a los usuarios agregar fácilmente una firma digital a sus documentos para los estándares de integridad y seguridad. Tiene una API simple, lo que facilita la protección de información sensible dentro de documentos.

Por lo tanto, es útil para desarrolladores que desean proporcionar protección avanzada de documentos en sus aplicaciones de servidor web. Ya sea para propósitos legales, financieros, o incluso comerciales, IronSecureDoc está ahí para ayudar proporcionando herramientas apropiadas para la protección de datos, autenticación, y evidencia de manipulación de extremo a extremo en todo el ciclo de vida de los documentos. IronSecureDoc ofrece una prueba gratuita. Para saber más sobre los precios, consulte la página de precios. Iron Software tiene una multiplicidad de bibliotecas, por lo tanto, hace más fácil el desarrollo de aplicaciones para muchas plataformas y sistemas operativos, como Windows, Android, MAC y Linux, entre muchos otros.