Usar HTTPS en C# ejecutando el contenedor con un certificado

Curtis Chau
Curtis Chau
Actualizado: 2 de agosto de 2026

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

Ejecute el contenedor IronSecureDoc con un certificado

  1. Generar Certificado:

    # Generates a new HTTPS certificate for use with ASP.NET Core.
    # Saves the certificate at the specified path and protects it with a password.
    dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER>
    
    # Trusts the generated certificate on your local machine.
    dotnet dev-certs https --trust
    SHELL

    Reemplace <CREDENTIAL_PLACEHOLDER> con una contraseña.

  2. Ejecutar el Contenedor de Docker:

    # Runs the IronSecureDoc Docker container with both HTTP and HTTPS ports exposed.
    docker container run -d \
      -p 8081:8081 -p 8080:8080 \ # Maps container ports to host ports for HTTP and HTTPS.
      -e HTTP_PORTS=8080 \ # Sets the HTTP port for the application.
      -e HTTPS_PORTS=8081 \ # Sets the HTTPS port for the application.
      -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> \ # Provides the IronSecureDoc license key.
      -e ENVIRONMENT=Production \ # Configures the environment as Production.
      -v %USERPROFILE%\.aspnet\https:/https:ro \ # Mounts the directory to the container as read-only.
      -e CERTIFICATE_PATH=%USERPROFILE%\.aspnet\https\ironsecuredoc.pfx \ # Specifies the path to the certificate in the container.
      -e CERTIFICATE_PASSWORD=<CERTIFICATE_PASSWORD> \ # Password for the certificate.
      ironsoftwareofficial/ironsecuredoc:latest # Specifies the Docker image to use.
    SHELL

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

Preguntas frecuentes

¿Cómo genero un nuevo certificado HTTPS para IronSecureDoc?

Puede usar el comando dotnet dev-certs https -ep para generar un nuevo certificado HTTPS para usar con ASP.NET Core, guardándolo en la ruta especificada y protegiéndolo con una contraseña.

¿Cómo puedo confiar en el certificado HTTPS generado en mi máquina local?

Para confiar en el certificado generado en su máquina local, utilice el comando dotnet dev-certs https --trust.

¿Qué pasos se requieren para ejecutar el contenedor Docker de IronSecureDoc?

Para ejecutar el contenedor Docker de IronSecureDoc, necesita mapear los puertos del contenedor a los puertos del host para HTTP y HTTPS, establecer las variables de entorno, incluyendo IronSecureDoc_LicenseKey, y montar el directorio para el certificado HTTPS como de solo lectura.

¿Qué variable de entorno se utiliza para establecer el puerto HTTPS para la aplicación IronSecureDoc?

La variable de entorno HTTPS_PORTS se utiliza para establecer el puerto HTTPS para la aplicación IronSecureDoc.

¿Por qué necesito agregar la ruta al certificado HTTPS en el contenedor Docker?

Agregar la ruta al certificado HTTPS en el contenedor Docker, especificado por CERTIFICATE_PATH, asegura que el contenedor pueda acceder al certificado para comunicaciones seguras.

¿Qué debo reemplazar en los comandos de configuración de IronSecureDoc?

En los comandos de configuración, reemplace <CREDENTIAL_PLACEHOLDER>, <IRONSECUREDOC_LICENSE_KEY>, y <CERTIFICATE_PASSWORD> con sus credenciales reales y la información de la contraseña.

¿Qué imagen de Docker debo usar para desplegar IronSecureDoc?

Debes usar la imagen de Docker ironsoftwareofficial/IronSecureDoc:latest para desplegar IronSecureDoc.

¿Cómo configuro el entorno de IronSecureDoc como Producción?

Establece la variable de entorno ENVIRONMENT=Production para configurar la aplicación IronSecureDoc como un entorno de Producción.

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

Leer más

¿Listo para empezar?

Versión:2024.10recién lanzado