PDF Signer Server (Tutorial para desarrolladores)

Introducción

Las firmas digitales se encuentran entre loscriptográfico técnicas que garanticen el origen, la integridad y la no reproducción de los documentos digitales. En la mayoría de los casos, es bastante diferente de las formas convencionales de firma manuscrita, en las que las técnicas avanzadas de cifrado aseguran el documento y verifican la identidad del firmante. Aplicada a un PDF, la firma digital crea un "sello" electrónico, parecido a un certificado que identifica un documento como inalterado desde que se firmó. 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 mantener un registro inmutable de los cambios junto con el documento, además de identificar a la parte firmante. En este artículo, vamos a crear un servidor PDF Signer con la ayuda de IronSecureDoc.

Cómo utilizar el servidor PDF Signer

1. Instale la imagen Docker de IronSecureDoc.

2. Ejecute la imagen docker con un puerto y una clave de licencia específicos.

3. Inicialice el cliente IronSecureDoc con la aplicación .NET.

4. Obtenga la URL y pásela al Cliente IronSecureDoc mientras crea el objeto.

5. Pase el parámetro requerido a la API de cliente de IronSecureDoc.

6. Obtenga los documentos PDF procesados y guárdelos en la ubicación.

¿Qué es IronSecureDoc?

IronSoftwareIronSecureDoc es la solución omnipotente para la seguridad de los documentos. De este modo se evitaría la filtración de información sensible a través de los distintos formatos de los documentos. Admite métodos de cifrado de última generación para proteger los documentos de accesos no autorizados, de modo que solo los lectores o editores designados tengan el mandato de verlos o modificarlos. También es compatible con la firma digital, que identifica a un creador de documentos como autorizado y garantiza que su contenido no ha sido manipulado desde la firma.

Además, permite compartir y mantener documentos de forma segura con control sobre cómo se distribuyen y con quién se comparten. IronSecureDoc incorpora estas funciones para ayudar a las organizaciones y a los particulares a mantener el cumplimiento de la protección de datos y evitar las violaciones de datos. La relevancia de esta interfaz muy fácil de usar, con un conjunto de características de seguridad, hace que sea un software muy relevante para cualquier empresa dispuesta a ofrecer un mayor nivel de seguridad a la hora de compartir documentos.

Características de IronSecureDoc

IronSecureDoc está provisto de una plétora de funciones para mejorar la seguridad de los documentos y mantenerlos intactos. Algunas de sus principales características son:

Cifrado avanzado: Esta función ayuda a proteger los documentos contra miradas no autorizadas, asegurando así el secreto de la información mediante algoritmos de cifrado robustos.

Firmas digitales: Esta propiedad atestigua el hecho de que las firmas digitales pueden adjuntarse a cualquier documento para afirmar que es original y que no ha sido alterado desde su firma, pero también quién lo ha firmado.

Compartir de forma segura: Comparta documentos de forma segura y especifique las personas autorizadas para verlos e incluso interactuar con ellos. Detecta los cambios no autorizados o la manipulación de un documento y, por tanto, ayuda a salvaguardar su integridad.

Cumplimiento: Esto hace que las organizaciones cumplan con numerosas regulaciones sobre protección y estándares de la industria al garantizar el manejo y la transmisión seguros de los documentos.

Facilidad de uso: Proporciona un fácil acceso a través de su interfaz fácil de usar en el manejo de las características de seguridad y la configuración del documento.

Rastros de auditoría: Crea rastros del historial de acceso y modificación, permitiendo así la transparencia y la rendición de cuentas.

Instalación de la imagen Docker de IronSecureDoc

Instalar y ejecutar una imagen Docker de IronSecureDoc es fácil. A continuación te explicamos cómo puedes hacerlo:

Instalar Docker

En primer lugar, asegúrese de que Docker está instalado en su sistema. podemos descargar Docker desdeSitio web oficial de Docker y siga las instrucciones de instalación correspondientes a su sistema operativo.

Extraiga la imagen Docker de IronSecureDoc

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

docker pull ironsoftwareofficial/ironsecuredoc

Ejecutar el contenedor Docker

Una vez extraída la imagen, el siguiente comando debería iniciar un nuevo contenedor. Podemos personalizar la bandera -p para la asignación de puertos o la --rm utilizada 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

En el ejemplo siguiente, asigne el puerto 8080 del host a los contenedores y asigne un nombre al contenedor creado en IronSecureDoc. Una vez ejecutado el comando, se mostrará como se indica a continuación.

Una vez en marcha, podemos acceder a la lista de API proporcionadas por IronSecureDoc a través del navegador(http://localhost:8080/swagger/index.html) o cualquier conectividad de aplicaciones.

Crear un nuevo proyecto de Visual Studio

Visual Studio permite desarrollar proyectos de consola de forma muy amplia y sencilla. A continuación se indican algunos pasos sencillos que le ayudarán a iniciarse en una aplicación de consola en el entorno de Visual Studio.

Antes de poder utilizar Visual Studio, asegúrate de tenerlo instalado en tu ordenador.

Iniciar un nuevo proyecto:

Tras elegir Archivo, Proyecto, seleccione el menú Nuevo.

Seleccione "Console App" o "Console App(.NET Core)" de la lista de referencias de plantillas de proyectos disponibles a continuación.

Para dar un nombre a su proyecto, rellene el campo "Nombre".

Seleccione la ubicación de su proyecto.

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

¿Qué es IronSoftware.SecureDoc.Client?

IronSoftware.SecureDoc.Client Library se integra fácilmente 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 IronSoftware.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, IronSoftware.SecureDoc.Client tiene las herramientas para realizar todas estas tareas de manera eficiente y segura.

Instalar IronSoftware.SecureDoc.Client

En primer lugar, ejecute la instalación de la biblioteca IronSoftware.SecureDoc.Client, ya que el próximo parche depende de ella. Por último, para completarlo, abra la consola del gestor de paquetes NuGet y ejecute el siguiente comando:

Install-Package IronSoftware.SecureDoc.Client

También podemos buscar el paquete "IronSoftware.SecureDoc.Client" en el gestor de paquetes NuGet. Podemos elegir de la lista de todos los paquetes NuGet relacionados con IronSoftware.SecureDoc.Client cuál hay que descargar.

Crear un ID digital autofirmado

Por lo general, las transacciones comerciales delicadas solicitarán una identificación de una autoridad de certificación, no una autofirmada.

En Adobe Acrobat, haga clic en el menú de hamburguesa(Windows) o menú Acrobat(macOS)a continuación, seleccione Preferencias.

En la lista de categorías de la izquierda, seleccione Firmas. A la derecha, haga clic en Más junto a Identidades y certificados de confianza.

A la izquierda, seleccione ID digitales y, a continuación, haga clic en el botón Añadir ID.

**Añadir una nueva identificación digital

Ahora seleccione la opción Un nuevo ID digital que quiero crear ahora y, a continuación, haga clic en Siguiente.

Crear un nuevo ID digital

Indique dónde desea guardar el ID digital y haga clic en Siguiente.

Nuevo archivo de identificación digital PKCS#12

Guarde la información de Digital ID en un archivo .pfx en Windows y .p12 en macOS. Puede transportar estos archivos a través de sistemas operativos y utilizarlos con Acrobat. Si copias un documento a otro sistema operativo, Acrobat seguirá utilizándolo.

Guarde el ID digital en un almacén común al que también puedan acceder otras aplicaciones de Windows.

PKCS-digital-id

En el campo correspondiente a su identificación digital, escriba su nombre, dirección de correo electrónico y otros datos personales; esto es lo que aparecerá en el cuadro Firma y en el panel Firmas cuando firme o certifique un documento.

Haga lo siguiente Seleccione un elemento de la lista desplegable Algoritmo de clave. Desde el punto de vista de la seguridad, un RSA de 2048 bits es más seguro que un RSA de 1024 bits. Pero RSA de 1024 bits es más compatible con más dispositivos.

En el menú Utilizar ID digital para, puede especificar si desea utilizar el ID digital para Cifrado, Firma digital o ambos.

Haga clic en Siguiente.

**Introduzca sus datos de identidad

Escriba una contraseña para el archivo de ID digital. A medida que escribe, el medidor de seguridad de la contraseña evalúa su contraseña y muestra la seguridad de la contraseña con patrones de colores. Confirme su contraseña.

La ubicación predeterminada indicada en el cuadro Nombre de archivo será donde se guarde el archivo de identificación digital. Haga clic en Examinar y elija otro lugar para guardar. Seleccione "Finalizar"

Introduzca una contraseña para su ID.

Si un archivo de identificación digital comparte el mismo nombre, se le pedirá que lo sustituya. Haga clic en Aceptar para reemplazar, o haga clic en Examinar y seleccione una ubicación diferente para almacenar el archivo.

Ahora se ha creado una identificación. Puede exportar el archivo del certificado para enviarlo a sus contactos y que puedan utilizarlo para verificar su firma.

Firmar un documento PDF con IronSecureDoc

A continuación se muestra el código de ejemplo que nos ayudará a firmar digitalmente el documento PDF con el archivo de certificado.

utilizando IronSecureDoc;

    Console.WriteLine("Proceso de archivo iniciado");

        var client = nuevo IronSecureDocClient("http://localhost:8080");

        si(await client.TryConnectAsync())

        {

            var result = await client.CertifyAsync("Demo.pdf", "DemoSign.pfx", "Su contraseña de certificado aquí");

            Archivo.WriteAllBytes("certify.pdf", resultado);

        }

        Consola.WriteLine("Proceso de archivo completado");

        Consola.ReadKey();

El siguiente código enviará primero 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 de forma asíncrona al servicio. Suponiendo que todo se conecte correctamente, llamará a CertifyAsync para realmentefirmar el documento PDFla traducción debe incluir las rutas del archivo PDF, el archivo del certificado de firma 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.

Finalmente, imprime en la consola que el archivo se ha procesado correctamente y espera a que el usuario introduzca sus datos 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 exista la aplicación.

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

Conclusión

IronSecureDoc es una solución integrada de seguridad de documentos digitales que garantiza el máximo nivel de protección gracias a sus sólidas capacidades de cifrado y certificación. La biblioteca de clientes IronSecureDoc permite a los usuarios añadir fácilmente una firma digital a sus documentos para cumplir las normas de integridad y seguridad. Su API es sencilla, lo que facilita la protección de la información sensible dentro de los documentos.

Por lo tanto, es útil para los desarrolladores que deseen proporcionar una protección avanzada de los documentos en sus aplicaciones de servidor web. Ya sea con fines legales, financieros o incluso empresariales, IronSecureDoc está ahí para ayudar proporcionando las herramientas adecuadas para la protección de datos, la autenticación y las pruebas de manipulación de extremo a extremo a lo largo de todo el ciclo de vida de los documentos. IronSecureDoc ofrece una versión de prueba gratuita. Para saber más sobre los precios, consulte elpágina de precios. Iron Software cuenta con una multiplicidad de bibliotecas, lo que facilita el desarrollo de aplicaciones para muchas plataformas y sistemas operativos, como Windows, Android, MAC y Linux, entre muchos otros.