설치 및 갱신

인증서가 발급되면 웹 서버나 CDN에 배포하고 만료 전에 갱신해야 합니다. 이 페이지에서는 내 인증서 페이지, 인증서 파일을 받는 방법, 일반적인 배포 방법을 안내합니다.

#내 인증서 페이지

SSL 인증서 → 내 인증서 (/ssl/certificates)를 엽니다. 목록에는 다음 열이 있습니다.

상세에는 기본 도메인, SAN 이름, 발급기관, 일련번호, 발급일 및 만료일, SHA-256 지문이 표시됩니다.

#인증서 파일 받기

• 다운로드: 인증서가 발급되면 표시되며 인증서 자체를 <domain>.crt(PEM) 파일로 다운로드합니다.
• 전체 묶음: API 호출 한 번으로 인증서, 개인 키, CA 중간 인증서 체인을 가져올 수 있습니다(활성 인증서만 해당).

curl -X POST https://api.yeap.cloud/api/user/ssl/orders/download \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"order_id": 123}'

응답 필드 certificate, ca_bundle, private_key에는 각각 PEM 형식의 인증서, CA 중간 인증서 체인, 개인 키가 포함됩니다. 발급된 주문의 경우 /ssl/order/<order_id>의 주문 상세 페이지에도 <domain>.crt, <domain>.key, <domain>-ca-bundle.crt를 저장하는 인증서 다운로드 버튼이 있습니다.

#웹 서버에 배포

대부분의 서버는 사이트 인증서 뒤에 CA 중간 인증서가 이어지는 전체 체인을 사용합니다. 다음 명령으로 결합합니다.

cat example.com.crt example.com-ca-bundle.crt > example.com.fullchain.pem

중간 인증서가 없다면 SSL 도구의 체인 완성 도구로 전체 체인을 구성할 수 있습니다.

#Nginx

server {
    listen 443 ssl;
    http2 on;
    server_name example.com;

    ssl_certificate     /etc/ssl/example.com.fullchain.pem;
    ssl_certificate_key /etc/ssl/example.com.key;
    ssl_protocols       TLSv1.2 TLSv1.3;
}

nginx -t로 구성을 확인한 다음 nginx -s reload를 실행합니다.

#Apache

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile    /etc/ssl/example.com.fullchain.pem
    SSLCertificateKeyFile /etc/ssl/example.com.key
</VirtualHost>

Apache 2.4.8 이상에서는 SSLCertificateFile에 전체 체인 파일을 지정할 수 있습니다.

#PFX/PKCS#12(IIS, Tomcat 등)

파일은 PEM 형식으로 제공됩니다. OpenSSL을 사용하여 로컬에서 변환합니다.

openssl pkcs12 -export -out example.com.pfx \
  -inkey example.com.key -in example.com.crt -certfile example.com-ca-bundle.crt

#Yeap Cloud CDN에 배포

사이트가 Yeap Cloud CDN을 사용하는 경우 CDN 도메인의 SSL 설정 페이지(/cdn/domains/<domain>/ssl)에서 호스트 이름에 사용할 인증서와 개인 키(PEM)를 업로드합니다. CDN에서 호스트 이름의 무료 인증서를 자동으로 발급하고 갱신할 수도 있습니다. CDN 문서를 참고합니다.

#배포 확인

openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null \
  | openssl x509 -noout -subject -issuer -dates

서버에서 제공하는 인증서를 SSL 도구의 인증서 디코더에 붙여넣어 유효성과 SAN 이름을 확인할 수도 있습니다. 서버에서 키 불일치 오류가 발생하면 키 일치 확인 도구로 인증서와 키가 서로 대응하는지 확인합니다.

#갱신

인증서는 만료 전에 갱신해야 합니다. DV 인증서(Let's Encrypt, ZeroSSL)의 유효 기간은 90일이며, 유료 OV/EV 인증서는 일반적으로 1년입니다. 목록에서는 만료일까지 30일 이내인 인증서를 곧 만료되는 것으로 표시합니다.

내 인증서에서 활성 및 만료 인증서에는 갱신 버튼이 표시됩니다. 확인 메시지를 승인하면 원래 주문에 연결된 갱신 주문이 생성됩니다("갱신 주문 생성 완료").

• 무료 DV 인증서: 갱신 주문에 결제가 필요하지 않습니다. 인증서 주문 및 검증에 설명된 대로 도메인을 제출하고 검증을 다시 완료합니다.
• 유료 인증서: 갱신 주문을 진행하려면 먼저 결제해야 합니다. 유료 갱신 완료에 도움이 필요하면 문의하거나, 카탈로그에서 새 인증서를 구매하여 기존 인증서를 교체합니다.

API를 통해 갱신을 시작할 수도 있습니다.

curl -X POST https://api.yeap.cloud/api/user/ssl/certificates/renew \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"order_id": 123}'

갱신된 인증서가 발급되면 서버의 기존 파일을 교체하고 서비스를 다시 로드합니다.

#기존 인증서 업로드

다른 CA에서 인증서를 구매했다면 인증서 업로드를 클릭하고 기본 도메인, 인증서(PEM), 개인 키(PEM), 선택적으로 CA 번들을 입력합니다. 업로드한 인증서는 다른 인증서와 함께 내 인증서에 저장됩니다. 플랫폼에서 형식을 확인하고 발급기관과 만료일을 자동으로 읽습니다.

#인증서 삭제

삭제를 클릭하고 확인합니다. 삭제는 되돌릴 수 없습니다. 업로드한 인증서는 언제든지 삭제할 수 있지만, 구매한 인증서는 활성 상태일 때 삭제할 수 없습니다.

#재발급 및 폐기

개인 키가 유출되었거나 도메인 변경 또는 인증서 폐기가 필요한 경우 주문 ID와 함께 문의하면 CA와 협의하여 처리합니다.