USO DE IRONSECUREDOC

Cómo asegurar la API de PDF en Docker usando C#

Publicado en 14 de enero, 2025
Compartir:

Introducción

El PDF seguroAPIes la potencia que permite a los desarrolladores integrar seguridad en los PDFs y utilizarlos dentro de sus flujos de trabajo y aplicaciones. En contraste, hay una creciente necesidad de proteger los datos sensibles. Los PDFs seguros ofrecen las herramientas necesarias: marcas de agua, protección por contraseña, encriptación y firmas digitales, para prevenir compromisos o filtraciones de datos. En ese sentido, estas API tienen la capacidad de permitir el guardado y compartición de PDFs de manera que se garantice la seguridad contra el acceso, modificación y distribución ilegal. Entre las principales formas en que una organización puede protegerdocumentos digitalesutilizada ya sea por la organización o por un usuario individual, la API de PDF segura toma protagonismo.

¿Qué es un documento PDF?

El formato de documento PDF es un tipo de formato de archivo de documento adoptado ampliamente a nivel mundial para la presentación e intercambio de documentos de manera confiable entre diversos dispositivos y plataformas. EnPDFs, desarrollados por Adobe a principios de la década de 1990, aseguran que el formato, las fuentes, las imágenes y el diseño que aparecen en un documento se mantengan, haciendo que los documentos de salida sean idénticos en apariencia independientemente del dispositivo, navegador o hardware utilizado para verlos.

Otros pueden incluir texto, configuraciones de imagen, hipervínculos e inserción de formularios para interacción habilitada, características de seguridad como permisos de documentos, tales como cifrado, contraseñas y firmas digitales. Son independientes de la plataforma y se pueden ver en casi cualquier dispositivo usando lectores de PDF como Adobe Acrobat o a través de navegadores web.

También es perfecto para compartir, copiar y archivar, ya que no permite que se realicen ediciones accidentales ni cambios en la apariencia. Los PDF se utilizan ampliamente en todo, desde documentos oficiales y contratos hasta eBooks, manuales y todo tipo de contenido copiado, lo que los hace convertibles y confiables tanto para usos profesionales como personales.

¿Qué es Docker?

Dockeres una plataforma de código abierto que, al aprovechar la contenerización, permite la fácil creación, implementación y gestión de una aplicación. La contenedorización es una metodología que empaqueta una aplicación y sus dependencias en una unidad única y autónoma que funcionará de manera predecible en cualquier entorno. Son portátiles, ligeros y muy fáciles de gestionar.

Imagen rota Añadir desde Pixabay, seleccionar de tus archivos o arrastrar y soltar una imagen aquí.

Características de Docker

Portabilidad: El contenedor se ejecuta en todas las plataformas sin modificación. Ya sea que las máquinas de desarrollo sean servidores de puesta en escena o entornos de producción, simplemente funcionan.

Aislamiento: Cada contenedor se ejecuta de manera aislada; por lo tanto, las aplicaciones con sus dependencias no interfieren entre sí.

Eficiencia: Los contenedores comparten el núcleo del sistema anfitrión; por lo tanto, son livianos en comparación con las máquinas virtuales.

Despliegue fácil: Docker hace que el despliegue de aplicaciones sea muy rápido y requiere una configuración mínima para ello, lo que permite la integración y entrega continua de aplicaciones, también conocida como la tubería CI/CD.

Componentes de Docker

Docker Engine: Esto actúa como la columna vertebral detrás de Docker; responsable de construir, ejecutar y gestionar contenedores.

Imágenes de Docker: Estos son los archivos de plantilla de salida de solo lectura que pueden ser utilizados en la creación de contenedores. Consiste en el código de una aplicación, entornos de ejecución y dependencias de la aplicación.

Contenedor Docker: La instancia de tiempo de ejecución de una imagen de Docker.

Docker Hub: El almacenamiento en la nube para publicar y compartir imágenes Docker.

Docker está ganando impulso y forma parte del ciclo moderno de DevOps porque garantiza previsibilidad y velocidad en cada punto de contacto en el despliegue de aplicaciones.

¿Qué es IronSecureDoc?

IronSecureDoces una utilidad avanzada para la gestión y seguridad de documentos, que cuenta con un cifrado robusto, firma digital y manipulación avanzada de PDF. Proporcionando a empresas y desarrolladores tanto la confidencialidad como la integridad de documentos con un acceso fluido, esta solución facilita el procesamiento de PDFs. También se puede utilizar como una API de PDF agresiva cuando se aplican sus características que permiten a los desarrolladores generar, cargar, manipular y proteger archivos y documentos PDF de forma programática.

Cómo asegurar la API de PDF en Docker usando C#: Figura 2 - IronSecureDoc: El servidor de seguridad y cumplimiento de PDF

Aparte de eso, IronSecureDoc es una API de PDF que permite la creación de PDFs a partir de cualquier entrada de datos añadiendo y editando contenido mediante parámetros como texto, imágenes y metadatos. Esto también incluye la capacidad de fusionar varios PDFs, dividir documentos e incluso anotar con comentarios, resaltados o marcas de agua.

Entre sus características de seguridad se encuentran la protección por contraseña, el cifrado AES y los controles de acceso basados en certificados que protegen toda la información y los datos sensibles. Además de esto, permite la firma digital para la autenticación de documentos y la no repudio, una característica muy importante en industrias como la financiera, médica y legal. También tiene funcionalidad de registro de auditoría para permitir el seguimiento de todas las actividades realizadas en los documentos para mejorar el cumplimiento y la responsabilidad.

IronSecureDoc como una API de PDF

IronSecureDoc también puede proporcionar una API operativa en un archivo PDF para lograr lo siguiente:

  • Generación de PDF: Por lo tanto, creará un documento PDF a partir de datos sin procesar, texto o cualquier otro formato de archivo.
  • Cifrado de PDF: Para proteger de manera segura contra el uso no autorizado mediante algoritmos de cifrado fuertes, como el Estándar de Cifrado Avanzado.
  • Desencriptación de PDF: Desencripta el PDF cifrado con claves/credenciales autorizadas.
  • Firma de documentos: Firma digitalmente el documento PDF para asegurar su autenticidad e integridad.
  • Edición de PDF: Edita texto, imágenes o metadatos en PDFs ya procesados.
  • Compartición de Documentos: Comparte PDF de forma segura con control de acceso integrado.

Características de IronSecureDoc

Cifrado avanzado:

  • Utilice algoritmos de cifrado de datos estándar de la industria como AES-256 al proteger documentos contra accesos no autorizados.
  • Establecer la contraseña de apertura del documento(contraseñas de usuario)y la contraseña del propietario para el documento PDF.

    Firmas Digitales:

  • Utilice firmas digitales en PDFs para garantizar la autenticidad de los documentos.
  • Asegurar la no repudio y la inviolabilidad de los PDFs.

    Control de acceso:

  • Control de permisos que se puede configurar para el acceso a ciertos datos a nivel de usuario o grupo.
  • Control de permisos de PDF para ver, editar, imprimir y copiar.

    Registro de Auditoría:

  • Además, todas las acciones realizadas con documentos deben ser monitoreadas, y se debe obtener un historial detallado para diferentes fines de cumplimiento y supervisión.

    Manipulación de PDF:

  • Combinar varios documentos PDF o dividir documentos grandes en otros más pequeños.
  • Anotar PDF agregando comentarios, resaltados o marcas de agua.
  • Realice la extracción de datos con sus capacidades de extracción de texto.

    **Soporte multiplataforma

  • Fácil integración a través de API con .NET, Java y otros entornos.
  • Uso en múltiples plataformas como contenedores Docker.

    Escalabilidad y Rendimiento:

  • Optimizado para soportar altos volúmenes de documentos dentro de un entorno empresarial.
  • Proporciona las velocidades de procesamiento más rápidas incluso para operaciones complejas.

    Integración de API:

  • Proporciona una API bien documentada que está completamente integrada con sus aplicaciones personalizadas. También ofrece llamadas API RESTful para implementaciones basadas en la web.

Instalar y ejecutar IronSecureDoc

Extraer el Imagen de Docker IronSecureDocdel repositorio de GitHub a continuación ejecutando este comando en el Símbolo del sistema o en una ventana de terminal abierta.

docker pull ironsoftwareofficial/ironsecuredoc
docker pull ironsoftwareofficial/ironsecuredoc
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'docker pull ironsoftwareofficial/ironsecuredoc
VB   C#

Cómo asegurar la API de PDF en Docker usando C#: Figura 3

Después de extraer una imagen del contenedor de Docker, tenemos otro comando para iniciar IronSecureDoc, un contenedor operativo.

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
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest
VB   C#

El comando Docker run anterior creará una instancia de contenedor de IronSecureDoc.

Agregar contraseña al documento PDF

La API REST de IronSecureDoc es una interfaz moderna basada en la web que permite a los desarrolladores interactuar de forma segura con las funciones de gestión de documentos y procesamiento de PDF del software. Con la utilización de principios RESTful, este APIproporciona a los usuarios una forma sencilla y estandarizada de integrar las funcionalidades de IronSecureDoc en aplicaciones personalizadas, independientemente del conjunto de tecnologías.

Cómo asegurar la API de PDF en Docker usando C#: Figura 4

También podríamos querer solicitar permisos de contraseña para esta solicitud de encriptación con la contraseña de usuario a un documento publicando en la API de IronSecureDoc de esta manera:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'
curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'curl -X 'POST' \ 'http: -H 'accept: */ *' \ -H 'Content-Type: multipart/form-data' \ -F 'pdf_file=@test.pdf;type=application/pdf'
VB   C#

Esto enviará y descargará automáticamente el archivo de salida del documento, que se almacenará de manera adecuada y segura.

Firmar un documento PDF

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

curl -X POST 'http://localhost:8080/v1/document-services/pdfs/certify' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@Demo.pdf;type=application/pdf' \
  -F 'certificate_file=@DemoSign.pfx;type=application/x-pkcs12' \
  -F 'certificate_password="p4ssw0rd"' \
  -F 'certificate_permissions=1' \
curl -X POST 'http://localhost:8080/v1/document-services/pdfs/certify' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@Demo.pdf;type=application/pdf' \
  -F 'certificate_file=@DemoSign.pfx;type=application/x-pkcs12' \
  -F 'certificate_password="p4ssw0rd"' \
  -F 'certificate_permissions=1' \
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'curl -X POST 'http: -H 'accept: */ *' \ -H 'Content-Type: multipart/form-data' \ -F 'pdf_file=@Demo.pdf;type=application/pdf' \ -F 'certificate_file=@DemoSign.pfx;type=application/x-pkcs12' \ -F 'certificate_password="p4ssw0rd"' \ -F 'certificate_permissions=1' \
VB   C#

El siguiente código enviará un mensaje a la consola primero, indicando que ha comenzado el procesamiento de 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.

Cómo asegurar la API de PDF en Docker usando C#: Figura 5 - Entrada de PDF

Este método intentará de forma asíncrona conectarse al servicio. Si todo va bien, llama al método CertifyAsync para realizar la firma real del documento PDF, pasando las rutas al archivo PDF, el archivo del certificado de firma PDF y la contraseña del certificado. El resultado de eso-es decir, que una matriz de bytes del PDF firmado se guardará en un nuevo archivo llamado certify.pdf.

Cómo asegurar la API de PDF en Docker usando C#: Figura 6 - Salida de PDF

En el archivo procesado anteriormente, el documento PDF ha sido firmado con el certificado digital.

Conclusión

IronSecureDoc REST APIes una solución potente pero flexible para aplicaciones modernas que permite asegurar y gestionar PDFs. Los escenarios clave de uso incluían la encriptación, la firma digital, la modificación de anotaciones de texto y manipulaciones intensivas con PDFs, desde el manejo simple de archivos hasta flujos de trabajo empresariales complejos. Debido a su naturaleza RESTful, se integrará fácilmente con una amplia gama de plataformas y tecnologías, lo que lo convierte en una excelente opción de API segura para PDF.

Fiable y Compatible: Es fiable y compatible, ya que ofrece capacidades de auditoría completas, con alta seguridad. Usando la API REST de IronSecureDoc, la impresión segura y efectiva, el formato PDF y su manejo ahora pueden integrarse fácilmente con aplicaciones creadas por desarrolladores de sistemas web, móviles y corporativos. Para leer más sobre la licencia de IronSecureDoc, haga clic en este enlace.página. Para obtener información sobre los productos de Iron Software, siga este enlace.

< ANTERIOR
Docker Build Push Action (Cómo funciona para desarrolladores)
SIGUIENTE >
Certificación Docker (Cómo funciona para desarrolladores)