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

컨테이너를 인증서와 함께 실행해야 하는 경우, 다음 단계를 따라 인증서를 생성하고 로컬 머신을 구성하십시오.

인증서를 사용하여 IronSecureDoc 컨테이너를 실행합니다.

  1. 인증서 생성 :

    # 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

    비밀번호로 <CREDENTIAL_PLACEHOLDER>을(를) 교체하십시오.

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

    <IRONSECUREDOC_LICENSE_KEY><CERTIFICATE_PASSWORD>을 각각 실제 IronSecureDoc 라이선스 키와 인증서 비밀번호로 교체하십시오.

자주 묻는 질문

문서 보안에 HTTPS가 왜 중요한가요?

HTTPS는 전송되는 데이터를 암호화하여 문서 보안에 필수적입니다. 이를 통해 전송 중에 민감한 정보가 기밀로 유지되고 가로챌 위험에서 보호됩니다.

내 애플리케이션에 HTTPS 인증서를 어떻게 생성할 수 있나요?

dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER> 명령을 실행하여 ASP.NET Core에서 사용할 새로운 인증서를 생성하면 됩니다.

내 로컬 기기에서 HTTPS 인증서가 신뢰되도록 하려면 어떻게 해야 하나요?

로컬 기기에서 HTTPS 인증서를 신뢰하려면 dotnet dev-certs https --trust 명령을 사용하세요. 이 명령은 생성된 인증서를 신뢰하도록 시스템을 구성합니다.

HTTPS 지원을 통해 Docker 컨테이너를 실행하는 프로세스는 무엇인가요?

HTTPS 지원으로 Docker 컨테이너를 실행하려면, HTTP와 HTTPS 포트를 모두 노출하고 IronSecureDoc_LicenseKeyCERTIFICATE_PASSWORD와 같은 필요한 환경 변수를 설정하고 인증서 디렉토리를 읽기 전용으로 마운트하세요.

Docker 설정에서 HTTPS에 대해 어떤 포트를 구성해야 하나요?

Docker 설정에서 HTTPS 구성을 위해 포트 8081을 HTTPS에, 포트 8080을 HTTP에 노출하여 컨테이너 포트를 호스트 포트에 매핑하세요.

Docker 컨테이너에 인증서 비밀번호를 어떻게 전달하나요?

Docker 실행 명령을 실행할 때 환경 변수 CERTIFICATE_PASSWORD를 사용하여 Docker 컨테이너에 인증서 비밀번호를 전달합니다.

Docker에서 'Production'으로 환경을 구성하는 데 필요한 단계는 무엇인가요?

Docker에서 'Production'으로 환경을 구성하려면, Docker 실행 명령에서 ENVIRONMENT=Production 환경 변수를 설정하세요.

Docker 명령에서 플레이스홀더는 어떻게 처리해야 하나요?

Docker 명령에서 <IRONSECUREDOC_LICENSE_KEY><CERTIFICATE_PASSWORD>와 같은 플레이스홀더를 실제 IronSecureDoc 라이선스 키 및 인증서 비밀번호로 대체하여 적절한 기능을 보장합니다.

커티스 차우
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?
버전: 2024.10 방금 출시되었습니다
Still Scrolling Icon

아직도 스크롤하고 계신가요?

빠른 증거를 원하시나요?
샘플 실행 PDF가 암호화되는 것을 확인하세요.