MENU
      createExternalCertificate

        createExternalCertificate


        기사 요약

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

        네이버 클라우드 플랫폼이 아닌 외부의 공인된 인증 기관에서 발급한 SSL 인증서를 추가합니다.

        요청

        요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

        메서드URI
        POST/certificate/withExternal

        요청 헤더

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

        필드필수 여부설명
        Content-TypeRequired요청 데이터의 형식
        • application/json

        Certificate Manager API에서 공통으로 사용하는 헤더에 대한 정보는 Certificate Manager 공통 헤더를 참조해 주십시오.

        요청 바디

        요청 바디에 대한 설명은 다음과 같습니다.

        필드타입필수 여부설명
        certificateNameStringRequired인증서 이름
        • 3~30자로 영어, 숫자, 특수문자 '-' 허용
        • 중복 불가
        privateKeyStringRequiredPEM 인코딩된 인증서 개인 키
        publicKeyCertificateStringRequiredPEM 인코딩된 인증서 바디
        • 중복 불가
        certificateChainStringRequiredPEM 인코딩된 인증서 체인

        요청 예시

        요청 예시는 다음과 같습니다.

        curl --location --request POST 'https://certificatemanager.apigw.ntruss.com/api/v1/certificate/withExternal' \
        --header 'x-ncp-apigw-timestamp: {Timestamp}' \
        --header 'x-ncp-iam-access-key: {Access Key}' \
        --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
        --header 'Content-Type: application/json' \
        --header 'accept: application/json' \
        --data '{
            "certificateName": {Certificate Name},
            "privateKey": {Private Key},
            "publicKeyCertificate": {Public Key Certificate},
            "certificateChain": {Certificate Chain}
        }'
        Shell

        응답

        응답 형식을 설명합니다.

        응답 바디

        응답 바디에 대한 설명은 다음과 같습니다.

        필드타입필수 여부설명
        returnCodeString-응답 코드
        returnMessageString-응답 메시지
        totalRowsInteger-SSL 인증서(sslCertificateList) 수
        sslCertificateListArray-인증서 목록

        sslCertificateList

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

        필드타입필수 여부설명
        certificateNoInteger-인증서 번호
        certificateTypeString-인증서 유형
        certificateNameString-인증서 이름
        memberNoString-사용자의 네이버 클라우드 플랫폼 회원 번호
        dnInfoString-인증서 DN(Distinguished Name) 정보
        domainAddressString-인증서의 대표 도메인 주소
        subDomainAddressString-인증서의 서브 도메인 주소
        regDateDate-인증서 등록 일시
        validStartDateDate-인증서 유효 시작 일시
        validEndDateDate-인증서 유효 종료 일시
        revokeDateDate-인증서 폐기 일시
      • 인증서가 폐기된 경우에만 표시
      • statusCodeString-인증서 상태 코드
        statusNameString-인증서 상태
        externalYnString-외부 인증서 여부
        domainCodeString-도메인 코드
        caInfoString-인증서 발급 기관(CA) 정보
        certSerialNumberString-인증서 일련 번호
        certPublicKeyInfoString-공개 키(Public key) 정보
        certSignAlgorithmNameString-서명 알고리즘
        usedInstanceNoListString-인증서를 사용 중인 인스턴스 목록
        updateDateDate-최근 변경 일시

        응답 상태 코드

        Certificate Manager API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Certificate Manager 공통 응답 상태 코드를 참조해 주십시오.

        응답 예시

        응답 예시는 다음과 같습니다.

        {
            "returnCode": "0",
            "returnMessage": "Success",
            "totalRows": 1,
            "sslCertificateList": [
                {
                    "certificateNo": 30728,
                    "certificateType": "EXT",
                    "certificateName": "zero-certi",
                    "memberNo": "*******",
                    "dnInfo": "CN=************.***.kr",
                    "domainAddress": "************.***.kr",
                    "subDomainAddress": "",
                    "regDate": "2024-07-30 11:33:33",
                    "validStartDate": "2024-07-30 09:00:00",
                    "validEndDate": "2024-10-29 08:59:59",
                    "statusCode": "1",
                    "statusName": "Normal",
                    "externalYn": "Y",
                    "domainCode": "PUB",
                    "caInfo": "ZeroSSL RSA Domain Secure Site CA",
                    "certSerialNumber": "92cf99ce**************a6205a5018",
                    "certPublicKeyInfo": "Sun RSA public key, 2048 bits",
                    "certSignAlgorithmName": "SHA384withRSA",
                    "updateDate": "2024-07-30 11:33:33"
                }
            ]
        }
        JSON

        이 문서가 도움이 되었습니까?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.