Certificate Manager 개요

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

Certificate Manager는 연계 서비스(Load Balancer, CDN+ 등)에서 사용할 인증서를 발급, 등록하고 관리할 수 있는 네이버 클라우드 플랫폼의 서비스입니다. 인증서 등록, 삭제 및 조회 기능에 대한 API를 RESTful 형태로 제공하며, API를 호출하려면 API Gateway의 IAM 인증을 완료해야 합니다.

Certificate Manager 공통 설정

Certificate Manager API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

요청

공통 요청 형식을 설명합니다.

API URL

요청 API URL은 다음과 같습니다.

https://certificatemanager.apigw.gov-ntruss.com/api/v1

요청 헤더

헤더에 대한 설명은 다음과 같습니다.

필드 필수 여부 설명
x-ncp-apigw-timestamp Required 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간 (밀리초)
  • API Gateway 서버와 5분 이상 시간차 발생 시 유효하지 않은 요청으로 간주
    		•
    x-ncp-iam-access-key Required 네이버 클라우드 플랫폼에서 발급받은 Access Key
  • Access Key 발급 및 확인: 인증키 생성 참조
  • 서브 계정의 Access Key 발급 및 확인: 서브 계정 생성 참조
    		•
    x-ncp-apigw-signature-v2 Required 네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명
  • Secret Key 발급 및 확인: 인증키 생성 참조
  • 서명 생성: 시그니처 생성 참조
    		•
    Accept Required 응답 데이터의 형식
  • application/json
    		•

    응답

    공통 응답 형식을 설명합니다.

    응답 상태 코드

    응답 상태 코드에 대한 설명은 다음과 같습니다.

    HTTP 상태 코드 코드 메시지 설명
    200 1002 Unable to load certificate. Expecting PEM format file. PEM 형식이 유효하지 않음
    200 1004 Failed to delete the certificate. Delete the instance being used first or replace the certificate being used for the instance. 인증서 삭제 실패(인스턴스 사용 중)
    200 1004 Failed to delete the certificate. No certificate was found with a matching with requested certificate name and certificate number. 인증서 삭제 실패(이름, 번호 불일치)
    200 2200 No certificate was found. 인증서 검색 결과 없음
    200 2201 Invalid DNS SANs input format. DNS SANs 입력 형식이 올바르지 않음
    200 2202 Invalid IP SANs input format. IP SANs 입력 형식이 올바르지 않음
    200 2203 Invalid Email SANs input format. IP SANs 입력 형식이 올바르지 않음
    200 2204 Private SSL certificate, but the Common Name input value is not an IP address or DNS name. 프라이빗 SSL 인증서의 Common Name 입력 값이 IP 주소 또는 DNS 이름이 아님
    200 2205 Email SANs cannot be entered in Private SSL certificate. 프라이빗 SSL 인증서는 Email SANs 입력 불가
    200 26034 The certificate is invalid. 인증서가 유효하지 않음
    200 26040 Public key in certificate does not match with private key. 개인 키 정합성이 유효하지 않음
    400 100 Bad Request Exception 요청 구문 오류
    400 2000 CertificateName is invalid. certificateName can only contain 3-20 English alphabet, numbers, and "-" and must start with an alphabetic character. 인증서 이름이 유효하지 않음
    400 2100 CertificateName is missing; PrivateKey is missing; PublicKeyCertificate is missing; CertificateChain is missing. 인증서의 이름이나 개인 키, 공개 키, 체인을 찾을 수 없음
    401 200 Authentication Failed 인증 실패
    401 210 Permission Denied 접근 권한 없음
    404 300 Not Found Exception 서버에서 찾을 수 없음
    413 430 Request Entity Too Large 요청 크기 초과
    429 400 Quota Exceeded 요청 할당량 초과
    429 410 Throttle Limited 너무 빠르거나 잦은 요청
    429 420 Rate Limited 특정 시간 동안 너무 많은 요청
    503 500 Endpoint Error 엔드포인트 오류
    504 510 Endpoint Timeout 엔드포인트 타임아웃
    500 900 Unexpected Error 알 수 없는 오류
    참고

    네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.

    Certificate Manager API

    Certificate Manager 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

    API 설명
    createExternalCertificate 외부 인증서 추가
    deleteCertificate 인증서 삭제
    getCertificateList 인증서 조회
    issuePrivate 사설 인증서 발급

    Certificate Manager 연관 리소스

    Certificate Manager API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.