createExternalCertificate

Prev Next

The latest service changes have not yet been reflected in this content. We will update the content as soon as possible. Please refer to the Korean version for information on the latest updates.

Available in Classic and VPC

Add an SSL certificate issued by a recognized certificate authority outside of NAVER Cloud Platform.

Request

The following describes the request format for the endpoint. The request format is as follows:

Method URI
POST /certificate/withExternal

Request headers

The following describes the headers.

Field Required Description
Content-Type Required Request data format
  • application/json

For headers common to all Certificate Manager APIs, see Common Certificate Manager headers.

Request body

The following describes the request body.

Field Type Required Description
certificateName String Required Certificate name
  • 3 to 30 characters, including English letters, numbers, and the special character "-"
  • Can't be duplicated
privateKey String Required PEM-encoded certificate private key
publicKeyCertificate String Required PEM-encoded certificate body
  • Can't be duplicated
certificateChain String Required PEM-encoded certificate chain

Request example

The following is a sample request.

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

Response

The following describes the response format.

Response body

The following describes the response body.

Field Type Required Description
returnCode String - Response code
returnMessage String - Response message
totalRows Integer - Number of SSL certificates (sslCertificateList)
sslCertificateList Array - Certificate list

sslCertificateList

The following describes sslCertificateList.

Field Type Required Description
certificateNo Integer - Certificate number
certificateType String - Certificate type
certificateName String - Certificate name
memberNo String - User's NAVER Cloud Platform member ID
dnInfo String - Certificate distinguished name (DN) information
domainAddress String - Representative domain address of the certificate
subDomainAddress String - Sub domain address of the certificate
regDate Date - Certificate registration date and time
validStartDate Date - Certification validity start date and time
validEndDate Date - Certification validity end date and time
revokeDate Date - Certificate revocation date and time
  • Display only if the certificate is revoked
    		•
    statusCode String - Certificate status code
    statusName String - Certificate status
    externalYn String - External certificate status
    domainCode String - Domain code
    caInfo String - Certificate authority (CA) information
    certSerialNumber String - Certificate serial number
    certPublicKeyInfo String - Public key information
    certSignAlgorithmName String - Signature algorithm
    usedInstanceNoList String - List of instances using the certificate
    updateDate Date - Latest change date and time

    Response status codes

    For response status codes common to all Certificate Manager APIs, see Common Certificate Manager response status codes.

    Response example

    The following is a sample example.

    {
    "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"
        }
    ]
}