Alojamiento en Windows

Chaknith Bin
Chaknith Bin
20 de julio, 2024
Actualizado 28 de octubre, 2024
Compartir:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronSecureDoc en DockerIronSecureDoc es un contenedor Docker diseñado para ofrecerle una potente manipulación de PDF detrás de una sencilla API REST, sin la molestia y la sobrecarga de los servicios SaaS en línea. Esta guía le guiará a través de los pasos para alojar IronSecureDoc en su máquina, incluyendo la configuración de variables de entorno y un ejemplo básico de uso de la API REST. Para la API completa, vea nuestra Referencia de la API REST

docker pull ironsoftwareofficial/ironsecuredoc:latest

Requisitos previos

Guía paso a paso

1. Instalar Docker Desktop

Si aún no ha instalado Docker Desktop, siga estos pasos:

  1. Vaya a la página de descarga de Docker Desktop.

  2. Descargue el instalador de Docker Desktop para Windows.

  3. Ejecute el instalador y siga las instrucciones que aparecen en pantalla.

  4. Tras la instalación, inicie Docker Desktop y asegúrese de que se está ejecutando.

2. Extraiga la imagen Docker "IronSecureDoc

Abra un símbolo del sistema y extraiga la última imagen de IronSecureDoc de Docker Hub:

docker pull ironsoftwareofficial/ironsecuredoc:latest

3. Ejecutar el contenedor sin certificado

Ejecute el contenedor Docker con las variables de entorno necesarias: Swagger UI en el navegador

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

Aplicar una clave de prueba o de licencia para eliminar las marcas de agua

Consejos
Reemplace <IRONSECUREDOC_LICENSE_KEY> con su clave de licencia real de IronSecureDoc.] De lo contrario, se aplicará una marca de agua a las características de la empresa. Swagger UI en el navegador

4. Acceder al contenedor

Una vez que el contenedor está en funcionamiento, puede acceder a IronSecureDoc abriendo un navegador web y navegando a:


http://localhost:8080/swagger/index.html

Swagger UI en el navegadorDebería ver la interfaz IronSecureDoc, indicando que su contenedor se está ejecutando correctamente.

5. Ejecutar el contenedor IronSecureDoc con certificado

Si necesita ejecutar el contenedor con un certificado, siga estos pasos para generar el certificado y configurar la máquina local:

  1. Generar Certificado:
   dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER>
   dotnet dev-certs https --trust

Reemplace <CREDENTIAL_PLACEHOLDER> con una contraseña.

  1. Ejecuta el contenedor de Docker:
   docker container run -d -p 8081:8081 -p 8080:8080    -e HTTP_PORTS=8080 -e HTTPS_PORTS=8081    -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY>    -e ENVIRONMENT=Production    -v %USERPROFILE%\.aspnet\https:/https:ro    -e CERTIFICATE_PATH=%USERPROFILE%\.aspnet\https\ironsecuredoc.pfx    -e CERTIFICATE_PASSWORD=<CERTIFICATE_PASSWORD>    ironsoftwareofficial/ironsecuredoc:latest

Reemplace <IRONSECUREDOC_LICENSE_KEY> y <CERTIFICATE_PASSWORD> con su clave de licencia de IronSecureDoc y la contraseña de certificado respectivas.

6. Gestión del contenedor

Puede gestionar su contenedor en ejecución mediante comandos Docker. Aquí tienes algunos comandos útiles:

  • Detener el contenedor:
  docker stop ironsecuredoc
  • Iniciar el contenedor:
  docker start ironsecuredoc
  • Eliminar el contenedor:
  docker rm -f ironsecuredoc

Variables de entorno

El contenedor puede configurarse utilizando las siguientes variables de entorno:

  • PDF_MAX_SIZE_MB (Por defecto: 30): Establece el tamaño máximo permitido para los archivos PDF subidos en Megabytes.
  • REQUEST_TIMEOUT_SECONDS (Predeterminado: 5): Establece la duración del tiempo de espera en segundos para las solicitudes API. Un valor de -1 permite que las peticiones se ejecuten indefinidamente.
  • ALLOWED_ORIGINS: Configura el Intercambio de Recursos de Origen Cruzado (CORS) especificando las URL de origen permitidas. Separe varias URL con comas. Utilice * o all para permitir solicitudes de cualquier origen.
  • HTTP_PORTS: Define los puertos HTTP que expone el contenedor. Esto debería coincidir con el mapeo de puertos utilizando el indicador -p (por ejemplo, 8080). Separe varios puertos con un punto y coma (;).
  • HTTPS_PORTS: Define los puertos HTTPS que expone el contenedor. Esto debería coincidir con el mapeo de puertos usando la opción -p (por ejemplo, 8081). Separe varios puertos con un punto y coma (;).
  • IronSecureDoc_LicenseKey (Requerido): Establece la clave de licencia de IronSecureDoc. Importante: No comparta este valor públicamente.

Ejemplo básico: Redactar texto en un documento

Para la lista completa de puntos finales de la API, consulte la Referencia de la API REST completa.

Redactar texto

curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text'   -H 'accept: */*'   -H 'Content-Type: multipart/form-data'   -F 'pdf_file=@/path/to/your/document.pdf;type=application/pdf'   -F 'words_to_redact="sensitiveWord"'   -F 'draw_black_box=true'   -F 'match_whole_word=true'   -F 'match_case=true'

Reemplace /path/to/your/document.pdf con la ruta real del documento que desea redactar y sensitiveWord con la palabra que desea redactar.

Redactar expresión regular

curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-regular-expression'   -H 'accept: */*'   -H 'Content-Type: multipart/form-data'   -F 'pdf_file=@/path/to/your/document.pdf;type=application/pdf'   -F 'regular_expression="[0-9]"'   -F 'draw_black_box=true'

Sustituye /path/to/your/document.pdf por la ruta real del documento que deseas redactar y [0-9] por la expresión regular que deseas coincidir y redactar.

Conclusión

Ha alojado correctamente IronSecureDoc en su equipo y lo ha configurado con las variables de entorno necesarias. También aprendió a interactuar con la API REST de IronSecureDoc utilizando cURL para operaciones básicas y avanzadas. Para obtener más detalles sobre la configuración y uso, consulte la Referencia de REST API completa.

Chaknith Bin
Ingeniero de software
Chaknith trabaja en IronXL e IronBarcode. Tiene una gran experiencia en C# y .NET, ayudando a mejorar el software y a apoyar a los clientes. Sus conocimientos de las interacciones con los usuarios contribuyen a mejorar los productos, la documentación y la experiencia general.