USE HTTPS by Running the Container with a Certificate

Q: How can I create an HTTPS certificate for my application?

You can create an HTTPS certificate by running the command dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER> , which generates a new certificate for use with ASP.NET Core.

Q: How should placeholders be handled in Docker commands?

In Docker commands, replace placeholders such as <IRONSECUREDOC_LICENSE_KEY> and <CERTIFICATE_PASSWORD> with your actual IronSecureDoc license key and certificate password for proper functionality.

Chaknith Bin

Updated:June 22, 2025

If you need to run the container with a certificate, follow these steps to generate the certificate and configure the local machine:

Run the IronSecureDoc Container With a Certificate

Generate Certificate:

# 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

# 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

Replace <CREDENTIAL_PLACEHOLDER> with a password.

Run the Docker Container:

# 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.

# 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

Replace <IRONSECUREDOC_LICENSE_KEY> and <CERTIFICATE_PASSWORD> with your actual IronSecureDoc license key and certificate password, respectively.

Frequently Asked Questions

Why is HTTPS important for document security?

HTTPS is crucial for document security as it encrypts the data being transferred, ensuring that sensitive information remains confidential and protected from interception during transmission.

How can I create an HTTPS certificate for my application?

You can create an HTTPS certificate by running the command dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER>, which generates a new certificate for use with ASP.NET Core.

How do I ensure my HTTPS certificate is trusted on my local machine?

To trust your HTTPS certificate on your local machine, use the command dotnet dev-certs https --trust. This command configures your system to trust the generated certificate.

What is the process for running a Docker container with HTTPS support?

To run a Docker container with HTTPS support, expose both HTTP and HTTPS ports, set the necessary environment variables such as IronSecureDoc_LicenseKey and CERTIFICATE_PASSWORD, and mount the certificate directory as read-only.

Which ports should be configured for HTTPS in a Docker setup?

For HTTPS configuration in a Docker setup, map the container ports to host ports by exposing port 8081 for HTTPS and port 8080 for HTTP.

How do I pass the certificate password to the Docker container?

Pass the certificate password to the Docker container using the environment variable CERTIFICATE_PASSWORD when executing the Docker run command.

What steps are necessary to configure the environment as 'Production' in Docker?

To configure the environment as 'Production' in Docker, set the environment variable ENVIRONMENT=Production in your Docker run command.

How should placeholders be handled in Docker commands?

In Docker commands, replace placeholders such as <IRONSECUREDOC_LICENSE_KEY> and <CERTIFICATE_PASSWORD> with your actual IronSecureDoc license key and certificate password for proper functionality.

Chaknith Bin

Chat with engineering team now

Software Engineer

Chaknith works on IronXL and IronBarcode. He has deep expertise in C# and .NET, helping improve the software and support customers. His insights from user interactions contribute to better products, documentation, and overall experience.