USE HTTPS by Running the Container with a Certificate

Q: 如何為我的應用程序創建 HTTPS 證書？

您可以通過運行命令 dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER> 來創建 HTTPS 證書，這會生成一個用於 ASP.NET Core 的新證書。

Q: 如何確保我的本地計算機信任我的 HTTPS 證書？

要讓您的本地計算機信任您的 HTTPS 證書，請使用命令 dotnet dev-certs https --trust 。此命令會配置您的系統以信任生成的證書。

Q: 運行支援 HTTPS 的 Docker 容器的過程是什麼？

要運行支援 HTTPS 的 Docker 容器，請暴露 HTTP 和 HTTPS 端口，設置必要的環境變量，如 IronSecureDoc_LicenseKey 和 CERTIFICATE_PASSWORD ，並將證書目錄掛載為唯讀。

Q: 如何將證書密碼傳遞給 Docker 容器？

在執行 Docker 運行命令時，使用環境變量 CERTIFICATE_PASSWORD 將證書密碼傳遞給 Docker 容器。

Q: 要將環境配置為 Docker 中的「生產環境」需要哪些步驟？

要將環境配置為 Docker 中的「生產環境」，請在你的 Docker 運行命令中設置環境變量 ENVIRONMENT=Production 。

Q: 如何在 Docker 命令中處理佔位符？

在 Docker 命令中，將佔位符如 <IRONSECUREDOC_LICENSE_KEY> 和 <CERTIFICATE_PASSWORD> 替換為您實際的 IronSecureDoc 授權密鑰和證書密碼，以確保正常功能。

Curtis Chau

更新日期:6月 1, 2025

Translated

View the article in English

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.

常見問題解答

為什麼 HTTPS 對文件安全很重要？

HTTPS 對於文件安全至關重要，因為它會加密傳輸的數據，確保敏感信息在傳輸過程中保持機密並受到保護免受攔截。

如何為我的應用程序創建 HTTPS 證書？

您可以通過運行命令 dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER> 來創建 HTTPS 證書，這會生成一個用於 ASP.NET Core 的新證書。