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

Jeśli musisz uruchomić kontener z certyfikatem, postępuj zgodnie z tymi krokami, aby wygenerować certyfikat i skonfigurować lokalny komputer:

Uruchom kontener IronSecureDoc z certyfikatem

  1. Wygeneruj certyfikat:

    # 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

    Zastąp <CREDENTIAL_PLACEHOLDER> hasłem.

  2. Uruchom kontener 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

    Zastąp <IRONSECUREDOC_LICENSE_KEY> i <CERTIFICATE_PASSWORD> odpowiednio właściwym kluczem licencyjnym IronSecureDoc i hasłem do certyfikatu.

Często Zadawane Pytania

Dlaczego HTTPS jest ważne dla bezpieczeństwa dokumentów?

HTTPS jest kluczowe dla bezpieczeństwa dokumentów, ponieważ szyfruje dane przesyłane, zapewniając, że poufne informacje pozostają tajne i chronione przed przechwyceniem podczas transmisji.

Jak mogę utworzyć certyfikat HTTPS dla mojej aplikacji?

Możesz utworzyć certyfikat HTTPS, uruchamiając komendę dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -p , co generuje nowy certyfikat do użycia z ASP.NET Core.

Jak zapewnić zaufanie do mojego certyfikatu HTTPS na mojej lokalnej maszynie?

Aby zaufać swojemu certyfikatowi HTTPS na lokalnej maszynie, użyj komendy dotnet dev-certs https --trust. Ta komenda konfiguruje system, aby ufał generowanemu certyfikatowi.

Jaki jest proces uruchamiania kontenera Docker z obsługą HTTPS?

Aby uruchomić kontener Docker z obsługą HTTPS, otwórz porty HTTP i HTTPS, ustaw niezbędne zmienne środowiskowe, takie jak IronSecureDoc_LicenseKey i CERTIFICATE_PASSWORD, oraz podłącz katalog certyfikatów w trybie tylko do odczytu.

Które porty należy skonfigurować dla HTTPS w ustawieniach Dockera?

Dla konfiguracji HTTPS w ustawieniach Dockera, przypisz porty kontenera do portów hosta, otwierając port 8081 dla HTTPS i port 8080 dla HTTP.

Jak przekazać hasło do certyfikatu do kontenera Docker?

Przekaż hasło do certyfikatu do kontenera Docker, używając zmiennej środowiskowej CERTIFICATE_PASSWORD podczas wykonywania komendy uruchomienia Dockera.

Jakie kroki są potrzebne, aby skonfigurować środowisko jako 'Produkcja' w Dockerze?

Aby skonfigurować środowisko jako 'Produkcja' w Dockerze, ustaw zmienną środowiskową ENVIRONMENT=Production w swojej komendzie uruchamiania Dockera.

Jak należy obsługiwać zastępniki w komendach Dockera?

W komendach Dockera zastąp zastępniki, takie jak i , swoimi rzeczywistymi kluczami licencyjnymi IronSecureDoc i hasłem do certyfikatu, aby zapewnić właściwe działanie.

Curtis Chau
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej
Gotowy, aby rozpocząć?
Wersja: 2024.10 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu?
uruchom przykład zobacz, jak twój PDF staje się zaszyfrowany.