Alternativas de Docker Compose para Stirling PDF utilizando IronSecureDoc

La configuración de IronSecureDoc es directa, gracias a su despliegue basado en Docker. Esto permite a los desarrolladores integrar rápidamente sus características de seguridad sin lidiar con instalaciones complejas.

Paso 1: Extraiga la imagen Docker de IronSecureDoc

Para comenzar, extrae la imagen Docker más reciente de IronSecureDoc:

docker pull ironsoftwareofficial/ironsecuredoc:latest

docker pull ironsoftwareofficial/ironsecuredoc:latest

Paso 2: Ejecute el contenedor IronSecureDoc

Una vez que la imagen se descargue, ejecuta el contenedor con las variables de entorno necesarias:

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

Reemplaza <IRONSECUREDOC_LICENSE_KEY> con tu clave de licencia válida. Esto asegura que el servicio funcione con toda su funcionalidad.

Paso 3: Acceda a los puntos finales de la API

Una vez que el contenedor esté activo y funcionando, puedes explorar los endpoints de la API usando Swagger:

• Swagger UI (Puerto 8080): http://localhost:8080/swagger/index.html

Con esta configuración, puedes comenzar a integrar las características avanzadas de seguridad de IronSecureDoc en tu aplicación.

StirlingPDF es una herramienta de código abierto para el procesamiento de PDFs que se puede desplegar rápidamente usando Docker. La configuración es simple y permite aprovechar sus características de seguridad y manipulación de documentos de inmediato.

Paso 1: Extraiga la imagen Docker de StirlingPDF

Primero, descarga la imagen Docker más reciente de StirlingPDF ejecutando:

docker pull casjaysdevdocker/stirlingpdf:latest

docker pull casjaysdevdocker/stirlingpdf:latest

O búscala en Docker Desktop:

Paso 2: Ejecute el contenedor StirlingPDF

Una vez que la imagen esté disponible, puedes iniciar un nuevo contenedor. En la interfaz de Docker, configura los parámetros de la siguiente manera:

• Nombre del Contenedor: StirlingPDF
• Puerto del Host: 8090

Alternativamente, puedes ejecutarlo vía CLI:

docker run --rm -p 8090:8080 casjaysdevdocker/stirlingpdf:latest

docker run --rm -p 8090:8080 casjaysdevdocker/stirlingpdf:latest

Paso 3: Acceder a la API

Una vez que el contenedor esté ejecutándose, accede a la interfaz Swagger UI de StirlingPDF para explorar los endpoints disponibles de la API:

http://localhost:8090/swagger-ui/index.html#/

Con esta configuración, puedes empezar a utilizar las características de seguridad del documento de StirlingPDF.

Redactar texto

Cuando se trata de manejar información confidencial, una de las características de seguridad más importantes es la redacción, la posibilidad de eliminar contenido sensible de documentos PDF de forma permanente. IronSecureDoc sobresale en esta tarea, proporcionando un endpoint de API sencillo y eficiente para redactar rápidamente palabras o frases específicas.

• Redacción de Texto Flexible: Los usuarios pueden especificar palabras o frases exactas para la redacción. El API soporta la coincidencia de palabra completa o parcial, configurable a través de parámetros de consulta.

• Control de Sensibilidad de Mayúsculas: Permite alternar la coincidencia que distingue entre mayúsculas y minúsculas, dando un control preciso sobre el comportamiento de redacción.

• Redacción Visual: El texto seleccionado puede ser oscurecido visualmente con un cuadro negro distintivo, indicando claramente las áreas redactadas dentro del PDF.

Para ilustrar esto, considera un documento PDF que contiene la frase "Dummy":

Usando el API directo de IronSecureDoc, los desarrolladores pueden emitir fácilmente un comando para redactar el texto sensible.

Aquí tienes un ejemplo práctico usando Curl:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/redact-text?draw_black_box=true&match_whole_word=false&words_to_redact=Dummy&match_case=false&save_as_pdfa=false&save_as_pdfua=false' \
  -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/redact-text?draw_black_box=true&match_whole_word=false&words_to_redact=Dummy&match_case=false&save_as_pdfa=false&save_as_pdfua=false' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

Una vez que el comando se ejecuta con éxito, recibirás una respuesta similar a la siguiente:

El PDF resultante demuestra la capacidad de redacción efectiva de IronSecureDoc. El contenido sensible se oscurece permanentemente, asegurando que la información confidencial permanezca segura:

IronSecureDoc también soporta métodos avanzados de redacción, como redacción de contenido usando expresiones regulares o regiones específicas dentro de un PDF:

• /v1/document-services/pdfs/redact-regular-expression
• /v1/document-services/pdfs/redact-region

Esta característica simple pero poderosa asegura que los documentos mantengan la privacidad y cumplan con estrictos estándares de protección de datos.

Certificar documentos

Certificar documentos asegura la autenticidad e integridad de los archivos PDF. IronSecureDoc simplifica este proceso usando un API dedicado. Aquí te presentamos cómo puedes certificar un documento PDF usando Swagger UI:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/certify?certificate_password=P%40ssw0rd123&certificate_permissions=3' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf' \
  -F 'certificate_file=@certificate.p12;type=application/x-pkcs12'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/certify?certificate_password=P%40ssw0rd123&certificate_permissions=3' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf' \
  -F 'certificate_file=@certificate.p12;type=application/x-pkcs12'

Cuando se llama a este API, el PDF se firma con un certificado digital, que bloquea su contenido y prueba su legitimidad. El parámetro certificate_permissions determina qué pueden hacer los destinatarios con el documento después de la certificación, como imprimir o rellenar formularios.

La respuesta del servidor incluye un archivo certificado descargable. Esto proporciona una forma fluida de automatizar el proceso de certificación y asegurar que tus PDFs sean seguros, verificables y cumplan.

Firmar documentos PDF

Junto con la certificación, IronSecureDoc proporciona otra capacidad crucial: firmar digitalmente documentos PDF. A diferencia de la certificación, que bloquea todo el documento, una firma digital agrega verificación sin necesariamente restringir ediciones.

Usando el endpoint /v1/document-services/pdfs/sign en Swagger UI, puedes colocar una imagen de firma visible en una página específica del documento. Incluso puedes personalizar su ubicación y dimensiones ajustando los parámetros signature_image_x, signature_image_y, signature_image_w y signature_image_h.

Además de la colocación de la firma, puedes proporcionar una contraseña de usuario o propietario, aplicar un certificado para una mayor confianza, y opcionalmente convertir el documento a formatos PDF/A o PDF/UA para cumplimiento.

Para firmar un documento:

1. Carga el PDF que deseas firmar.
2. Carga un archivo de certificado digital válido (formato .p12).
3. Carga un archivo de imagen de la firma (PNG o JPEG).
4. Establece las coordenadas y el tamaño de la colocación de la firma.
5. Haz clic en Ejecutar.

Una vez completado, el servidor devolverá un PDF firmado digitalmente listo para distribución. Esta característica es excelente para automatizar flujos de trabajo de aprobación, confirmar la autoría o agregar presencia de marca a documentos oficiales, todo mientras se mantiene la integridad del documento.

Cifrado de archivos PDF

Uno de los pilares más importantes de la seguridad del PDF es el cifrado. Con IronSecureDoc, los desarrolladores pueden cifrar documentos usando contraseñas fuertes para usuarios y propietarios al mismo tiempo que ajustan finamente los ajustes de permisos para el uso del documento. Para realizar esta acción usando Swagger UI, navega al endpoint /v1/document-services/pdfs/encrypt y configura los campos requeridos:

Puedes restringir una variedad de características del documento, tales como:

• Extracción de contenido
• Relleno de formularios
• Anotaciones
• Impresión
• Modificaciones

Solo establece todas estas opciones en falso si quieres un documento completamente bloqueado. Aquí tienes el comando CURL equivalente para referencia:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?allow_extracting_content=false&allow_form_filling=false&allow_annotations=false&allow_printing=false&allow_modifications=false&new_user_password=123&new_owner_password=123' \
  -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?allow_extracting_content=false&allow_form_filling=false&allow_annotations=false&allow_printing=false&allow_modifications=false&new_user_password=123&new_owner_password=123' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

Una vez ejecutado, la salida será un archivo PDF completamente cifrado que solicita al usuario que ingrese una contraseña al abrir.

Esta funcionalidad es esencial para proteger registros sensibles, limitar el acceso y asegurar el control del documento incluso después de la distribución. Ya sea para memorándums internos, documentos legales o informes de clientes, IronSecureDoc facilita la implementación de seguridad en documentos sin interrumpir el flujo de desarrollo.

Extraer texto de archivos PDF

¿Necesitas extraer contenido de un archivo PDF? IronSecureDoc ofrece una manera rápida y precisa de extraer texto utilizando el endpoint /v1/document-services/pdfs/extract. Esta característica es especialmente útil cuando deseas automatizar la extracción de contenido de facturas, informes o documentos extensos sin tener que copiar y pegar manualmente. Para extraer texto, dirígete a la interfaz Swagger UI y carga tu archivo usando el formulario proporcionado:

Los parámetros te permiten ingresar contraseñas (si el PDF está protegido) e incluso especificar números de páginas si solo necesitas contenido de páginas seleccionadas. Alternativamente, puedes usar el siguiente comando CURL:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/extract' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@long_text_test.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/extract' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@long_text_test.pdf;type=application/pdf'

Una vez ejecutado, el API devuelve el texto extraído como un cuerpo de respuesta simple:

Esta salida luego puede ser interpretada, almacenada o analizada según sea necesario. Es simple, rápido y no requiere ningún complemento especial ni revisión manual. Ya sea que estés construyendo un flujo de procesamiento de documentos o busques un acceso rápido al contenido de un archivo, esta característica hace el trabajo.

Verificar contraseña del documento

Antes de procesar cualquier PDF seguro, es una buena idea verificar si tu contraseña es válida. IronSecureDoc proporciona un método rápido y confiable para verificar tanto las contraseñas de usuario como las de propietario usando el endpoint /v1/document-services/pdfs/verify-password. Esto es especialmente útil cuando automatizas flujos de trabajo que involucran documentos de terceros o archivos archivados, donde la precisión de la contraseña debe ser confirmada antes de tomar más acciones.

En la interfaz Swagger UI, carga el PDF seguro, luego completa el campo user_password o owner_password relevante, según tu nivel de acceso:

Una vez enviado, el API devolverá un éxito (200 OK) si la contraseña es válida, o un error si no lo es. Este paso ligero de validación puede ahorrar tiempo, prevenir fallos innecesarios y ayudar a optimizar el manejo automatizado de PDFs.

Verificar firmas digitales

Verificar una firma digital es un paso crucial para garantizar que un documento PDF no haya sido alterado desde que fue firmado y que la firma sea válida. IronSecureDoc proporciona esta funcionalidad a través del endpoint /v1/document-services/pdfs/verify-signatures. Este endpoint es especialmente útil cuando los documentos se reciben de fuentes externas o cuando la conformidad y la confianza son esenciales.

En la interfaz de Swagger UI, todo lo que necesitas hacer es cargar el archivo PDF firmado y, si es necesario, ingresar el user_password o owner_password para acceder al archivo:

También puedes ejecutar este proceso usando una solicitud CURL:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/verify-signatures' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test_Signed.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/verify-signatures' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test_Signed.pdf;type=application/pdf'

Después de ejecutar la solicitud, el API devuelve resultados detallados de verificación en formato JSON. Si la firma es intacta y auténtica, devolverá true. Si ha sido alterado o es inválido, verás indicadores detallados de fallo.

Esta característica asegura que cada firma en tu flujo de trabajo PDF sea verificable y segura, un paso esencial para documentos legales, financieros y sensibles a la conformidad.

Redactar PDF

StirlingPDF ofrece una manera sencilla y flexible de redactar contenido de documentos PDF usando su endpoint /api/v1/security/auto-redact. Esta característica es ideal para desarrolladores que desean eliminar palabras o patrones sensibles de PDFs sin necesidad de una configuración avanzada.

En la interfaz de Swagger UI, puedes configurar fácilmente los parámetros de redacción. Cargas un PDF, ingresas la lista de texto a redactar (como "Dummy") y ajustas opciones como:

• useRegex – Redactar basado en expresiones regulares
• wholeWordSearch – Coincidencia solo de palabras completas
• redactColor – Personaliza el color de redacción (por ejemplo, negro #000000)
• customPadding – Añadir espacio alrededor de áreas redactadas
• convertPDFToImage – Convertir la salida en una imagen para protección extra

Una vez que hagas clic en Ejecutar, StirlingPDF procesa el archivo y elimina todo el contenido coincidente según tu configuración.

Validar firmas

Usando el endpoint /api/v1/security/validate-signature, puedes verificar rápidamente la autenticidad de las firmas digitales incrustadas en un archivo PDF. El endpoint soporta tanto la validación de certificados por defecto como personalizados. Todo lo que necesitas hacer es enviar un cuerpo de solicitud que contenga el fileInput (tu PDF en base64 o cadena de archivo) y opcionalmente proporcionar un certFile si deseas validarlo contra un certificado específico.

Esta API responde con una estructura JSON que detalla el estado de verificación.

Firmar archivos PDF con un certificado digital

StirlingPDF te permite firmar digitalmente archivos PDF usando tus certificados con el endpoint /api/v1/security/cert-sign. A través de la interfaz Swagger UI, puedes cargar tu PDF y configurar las opciones de firma digital. Esto es lo que necesitarás:

• fileInput – El archivo PDF que deseas firmar
• certType – El tipo de certificado que estás usando
• privateKeyFile, certFile, p12File, o jksFile – Dependiendo del tipo de certificado
• password – Para el almacenamiento de claves o clave privada

También puedes mejorar la experiencia de firma con:

• showSignature – Mostrar visualmente la firma en el PDF
• reason, location, name – Metadatos para la firma
• pageNumber – La página donde debe aparecer la firma
• showLogo – Si se muestra un logotipo junto con la firma

Una vez que presiones Ejecutar, StirlingPDF procesa la entrada y devuelve un PDF firmado digitalmente.

Agregar protección con contraseña

StirlingPDF te permite bloquear documentos con protección por contraseña usando el endpoint /api/v1/security/add-password. Esta característica te permite definir contraseñas de usuario y propietario, junto con ajustes de permisos personalizados.

Usando la interfaz Swagger UI, así es como lo configuras:

• fileInput – Carga el PDF que deseas proteger
• password – La contraseña del usuario es necesaria para abrir el documento
• ownerPassword – Controla los permisos de edición dentro del archivo
• keyLength – Elige la fuerza de cifrado (por ejemplo, 256 bits)

Más allá de eso, puedes alternar restricciones de documentos, tales como:

• canPrint, canModify, canFillInForm
• canExtractContent, canExtractForAccessibility
• canModifyAnnotations, canAssembleDocument

Cuando hagas clic en Ejecutar, la salida será un PDF protegido por contraseña con permisos exactamente como está configurado.

IronSecureDoc ofrece opciones de licencias a nivel empresarial adaptadas para satisfacer diversos requisitos organizacionales. Los clientes pueden elegir entre una IronSecureDoc Enterprise License independiente o la completa Iron Suite Enterprise License, que incluye IronSecureDoc junto con otros productos.

Licencia empresarial IronSecureDoc

• Precio: USD 14,999
• Características:
  • Servidor PDF Empresarial que soporta sin código o cualquier lenguaje de programación, alojado localmente o en la nube
  • Redacción, firma y cifrado ilimitados de PDF para asegurar tus documentos
  • Soporta entornos desconectados por aire (air-gapped)
  • Se ofrecen paquetes de soporte y actualización con descuento

Licencia empresarial ilimitada de Iron Suite

• Precio: USD 19,995
• Características:
  • Incluye todos los productos de Iron Software: IronPDF, IronOCR, IronXL, IronWord, IronBarcode, y más
  • Desarrolladores ilimitados, ubicaciones y proyectos, incluyendo redistribución OEM
  • Licencia empresarial perpetua a medida
  • Soporta entornos desconectados por aire (air-gapped)
  • Opciones exclusivamente empresariales disponibles
  • Suscripción de soporte y actualizaciones abarca Suite y IronSecureDoc

Soporte y actualizaciones

Iron Software proporciona varias opciones de soporte y actualización de productos para asegurar un servicio ininterrumpido:

• Suscripción Anual: $7,500 por año (se renueva anualmente, cancelar en cualquier momento)
• Paquete de 1 Año: $10,000 (compra única)
• Paquete de 5 Años: $30,000 (compra única)

Estos paquetes ofrecen acceso a actualizaciones continuas de productos, mejoras de características de seguridad y soporte del equipo de ingeniería de Iron Software.

Opciones de evaluación

Para organizaciones interesadas en evaluar IronSecureDoc antes de realizar una compra, está disponible una prueba gratuita. Esta prueba proporciona funcionalidad completa, permitiendo una evaluación exhaustiva en un entorno en vivo sin compromiso financiero inmediato.

Al seleccionar la opción de licencia adecuada, las empresas pueden asegurar una seguridad robusta de documentos adaptada a sus necesidades específicas.

StirlingPDF ofrece un modelo simple, de código abierto:

Nivel gratuito

Disponible bajo la licencia AGPL v3, las funciones básicas son gratuitas de usar y auto-hospedar. Adecuado para desarrolladores o uso interno pequeño.

Licencia empresarial

Hay una licencia comercial disponible para empresas que requieren cumplir sin AGPL o soporte adicional. Los precios son personalizados y requieren ponerse en contacto con su equipo.

IronSecureDoc ofrece un conjunto completo de documentación y recursos de soporte diseñados para facilitar la integración fluida y operación dentro de tu organización.

Documentación extensa

IronSecureDoc proporciona documentación detallada que abarca:

• Guías de Inicio Rápido: Instrucciones paso a paso para hacer funcionar IronSecureDoc en diversos entornos, incluidos servidores locales y plataformas en la nube.
• Referencias de API: Documentación completa de API RESTful, detallando endpoints para tareas como redacción, cifrado y firma digital de PDF.
• Tutoriales y Guías: Guías prácticas que demuestran técnicas de integración con distintos lenguajes de programación y frameworks, mejorando la experiencia del desarrollador.

Soporte dedicado

IronSecureDoc asegura soporte sólido a través de:

• Asistencia de Ingeniería Directa: Acceso a un equipo de ingenieros dedicados a través de chat en vivo, correo electrónico o compartir pantalla, proporcionando respuestas oportunas y conocedoras a consultas técnicas.
• Mejora Continua: Un compromiso con la evolución del producto basado en la retroalimentación de los usuarios, asegurando que IronSecureDoc satisfaga las necesidades dinámicas de sus usuarios.

Este enfoque estructurado de documentación y soporte subraya la dedicación de IronSecureDoc a entregar una experiencia centrada en el usuario, facilitando una implementación eficiente y una utilización continua dentro de los entornos empresariales.

Documentación

StirlingPDF proporciona una documentación completa que cubre guías de instalación para varias plataformas, opciones de configuración avanzada, y una extensa lista de características.

Apoyo

Como un proyecto de código abierto, StirlingPDF depende del soporte impulsado por la comunidad. Los usuarios pueden buscar asistencia a través de plataformas como GitHub y Discord, donde pueden reportar problemas, solicitar características y colaborar con otros usuarios y contribuyentes.