인증서 주문 및 검증

이 페이지에서는 SSL 인증서를 선택하고 구매한 뒤 인증서에 사용할 도메인을 제출하고, DNS 또는 HTTP 검증으로 도메인 소유권을 증명하는 방법을 설명합니다.

#인증서 선택

콘솔에서 SSL 인증서 → 인증서 구매 (/ssl/browse)를 엽니다. 페이지 상단에서 발급 채널별로 상품을 필터링할 수 있습니다. 각 상품 카드에는 다음 정보가 표시됩니다.

• 상품 이름과 브랜드(예: Let's Encrypt, ZeroSSL, DigiCert)
• 유형 태그: DV, OV, EV, 와일드카드 또는 멀티 도메인
• 일 단위 유효 기간과 가격

작성 시점의 상품 목록은 다음과 같습니다. 최신 정보는 항상 상품 목록 페이지를 기준으로 합니다.

선택 기준은 다음과 같습니다.

• HTTPS 암호화만 필요한 경우: DV를 선택합니다. 유효 기간이 90 days인 DV 인증서는 정기적으로 갱신해야 합니다.
• 모든 1단계 하위 도메인이 필요한 경우(예: *.example.com): 와일드카드를 선택합니다. 와일드카드 인증서는 DNS로만 검증할 수 있습니다.
• 하나의 인증서로 여러 도메인 이름을 사용하는 경우: 멀티 도메인을 선택합니다.
• 인증서에 조직 신원 정보를 포함하려는 경우: OV 또는 EV를 선택하고 회사 정보를 준비합니다.

#주문 및 결제

1. 상품 카드에서 장바구니에 담기를 클릭하거나 지금 구매를 클릭하여 장바구니(/billing/cart)로 바로 이동합니다. SSL 인증서는 일회성 구매 상품입니다.
2. 장바구니를 검토하고 주문을 완료합니다. 인증서 청구서가 생성되고 내 인증서에 처리 대기 상태의 인증서 주문이 표시됩니다. 아직 연결된 도메인은 없습니다.
3. 결제 → 청구서 (/billing/invoices)에서 청구서 금액을 결제합니다.

#도메인 및 검증 방식 제출

결제 후 주문에 사용할 인증서 도메인과 검증 방식을 제출하면 플랫폼이 CA에 요청을 전송합니다. 현재 이 단계는 콘솔 로그인 토큰으로 인증하는 사용자 API를 통해 수행합니다.

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

매개변수:

성공하면 주문이 검증 대기 상태로 전환되고, 응답의 validation_data에 게시해야 할 정보가 표시됩니다. 언제든지 GET /api/user/ssl/orders/get?id=<order_id>로 다시 조회할 수 있습니다. validation_token 및 validation_value 필드에는 레코드 이름과 값이 들어 있습니다.

#도메인 검증 완료

#DNS 검증(권장)

DNS 제공업체에서 TXT 레코드를 추가합니다.

• Let's Encrypt와 ZeroSSL 같은 DV 인증서는 일반적으로 _acme-challenge 접두사를 사용합니다. 다른 CA는 다른 이름이나 레코드 유형을 사용할 수 있으므로 항상 해당 주문에서 반환된 데이터를 사용하십시오.
• 와일드카드 인증서는 반드시 DNS 검증을 사용해야 합니다.
• 영역이 Yeap Cloud DNS에서 호스팅되는 경우 콘솔에서 레코드를 추가할 수 있습니다. DNS 문서를 참조하십시오.
• DNS 변경 사항이 조회되기까지는 일반적으로 몇 분에서 30분 정도 걸리며, TTL이 길면 더 오래 걸립니다.

#HTTP 검증

웹사이트에 검증 파일을 게시하여 http://<domain>/.well-known/...에서 접근할 수 있도록 합니다. 주문에서 반환된 경로와 내용을 정확히 사용합니다(예: /.well-known/acme-challenge/<token>). 다음 사항을 확인하십시오.

• 도메인이 파일을 호스팅하는 서버로 해석되고 포트 80에 접근할 수 있어야 합니다.
• URL은 파일의 원본 내용을 반환해야 하며 로그인 페이지, 방화벽 또는 재작성 규칙에 가로막히지 않아야 합니다.

#검증 및 발급 확인

레코드가 반영되면 직접 검증을 실행할 수 있습니다.

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

# Refresh the order status from the CA; fetches the certificate if it has been issued
curl -X POST https://api.yeap.cloud/api/user/ssl/orders/refresh-status \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"order_id": 123}'

직접 폴링할 필요는 없습니다. 플랫폼은 CA에 제출된 모든 주문을 일정 간격(약 30분마다)으로 자동 확인합니다. 인증서가 발급되면 자동으로 저장되고 주문이 적용 중 상태로 변경됩니다. 이후 내 인증서에서 다운로드할 수 있습니다.

발급 소요 시간은 유형에 따라 다릅니다. DV 인증서는 일반적으로 검증을 통과한 직후 발급됩니다. OV 및 EV 인증서는 CA의 조직 심사도 필요하며 보통 영업일 기준 며칠이 걸립니다. CA가 제출한 연락처로 연락할 수 있습니다.

#문제 해결

• 검증을 계속 통과하지 못하는 경우: dig TXT _acme-challenge.example.com으로 레코드가 외부에서 조회되는지, 값이 누락 없이 입력되었고 불필요한 따옴표나 공백이 없는지 확인합니다. HTTP 검증의 경우 브라우저 또는 curl로 검증 URL을 열고 응답 본문을 확인합니다.
• 주문이 실패로 표시되는 경우: CA가 요청을 거부한 것입니다(예: 도메인이 발급 정책을 충족하지 못함). 사유는 주문에 저장되며 주문 조회 엔드포인트에서 반환됩니다.
• 오랫동안 진행되지 않는 경우: 주문 ID와 함께 문의하십시오.