USE HTTPS in C# by Running the Container with a Certificate

This article was translated from English: Does it need improvement?
Translated
View the article in English

Se precisar executar o contêiner com um certificado, siga estas etapas para gerar o certificado e configurar a máquina local:

Execute o contêiner IronSecureDoc com um certificado.

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

    Substitua <CREDENTIAL_PLACEHOLDER> por uma senha.

  2. Execute o contêiner 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.
    # 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

    Substitua <IRONSECUREDOC_LICENSE_KEY> e <CERTIFICATE_PASSWORD>, respectivamente, pela chave de licença IronSecureDoc real e pela senha do certificado.

Perguntas frequentes

Por que o HTTPS é importante para a segurança de documentos?

O HTTPS é crucial para a segurança de documentos, pois criptografa os dados transferidos, garantindo que as informações confidenciais permaneçam protegidas contra interceptação durante a transmissão.

Como posso criar um certificado HTTPS para minha aplicação?

Você pode criar um certificado HTTPS executando o comando dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -p , que gera um novo certificado para uso com o ASP.NET Core.

Como posso garantir que meu certificado HTTPS seja confiável em minha máquina local?

Para confiar no seu certificado HTTPS na sua máquina local, use o comando dotnet dev-certs https --trust . Este comando configura o seu sistema para confiar no certificado gerado.

Qual é o processo para executar um contêiner Docker com suporte a HTTPS?

Para executar um contêiner Docker com suporte a HTTPS, exponha as portas HTTP e HTTPS, defina as variáveis de ambiente necessárias, como IronSecureDoc_LicenseKey e CERTIFICATE_PASSWORD , e monte o diretório de certificados como somente leitura.

Quais portas devem ser configuradas para HTTPS em uma instalação do Docker?

Para configurar HTTPS em um ambiente Docker, mapeie as portas do contêiner para as portas do host, expondo a porta 8081 para HTTPS e a porta 8080 para HTTP.

Como faço para passar a senha do certificado para o contêiner Docker?

Ao executar o comando `docker run`, passe a senha do certificado para o contêiner Docker usando a variável de ambiente CERTIFICATE_PASSWORD .

Quais são os passos necessários para configurar o ambiente como 'Produção' no Docker?

Para configurar o ambiente como 'Produção' no Docker, defina a variável de ambiente ENVIRONMENT=Production no seu comando Docker run.

Como os marcadores de posição devem ser tratados nos comandos do Docker?

Nos comandos do Docker, substitua os marcadores de posição como e pela sua chave de licença e senha de certificado reais do IronSecureDoc para que funcionem corretamente.

Curtis Chau
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais
Pronto para começar?
Versão: 2024.10 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas?
executar um exemplo Veja seu PDF ser criptografado.