createExternalCertificate
    • PDF

    createExternalCertificate

    • PDF

    기사 요약

    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}
    }'
    

    응답

    응답 형식을 설명합니다.

    응답 바디

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

    필드타입필수 여부설명
    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"
            }
        ]
    }
    

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

    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.