Certificate Manager overview

Prev Next

Available in Classic and VPC

Certificate Manager is a NAVER Cloud Platform service that enables you to issue, register, and manage certificates to be used by associated services (Load Balancer, CDN+, etc.). It provides APIs for certificate registration, deletion, and inquiry features in RESTful form, and you must complete IAM authentication with API Gateway to call the APIs.

Common Certificate Manager settings

The following describes commonly used request and response formats in Certificate Manager APIs.

Request

The following describes the common request format.

API URL

The request API URL is as follows.

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

Request headers

The following describes the headers.

Field Required Description
x-ncp-apigw-timestamp Required This is the number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC
  • Request is considered invalid if the timestamp differs from the current time by more than 5 minutes
    		•
    x-ncp-iam-access-key Required Access key issued on NAVER Cloud Platform
  • Issue and check access key: See Create authentication key
  • Issue and check access key for sub account: See Create sub account
    		•
    x-ncp-apigw-signature-v2 Required Base64-encoded signature that encrypts the request information with a secret key that maps to the access key issued on NAVER Cloud Platform, using the HMAC encryption algorithm (HmacSHA256)
  • Issue and check secret key: See Create authentication key
  • Create signature: See Create signature
    		•
    Accept Required Response data format
  • application/json
    		•

    Response

    The following describes the common response format.

    Response status codes

    The following describes the response status codes.

    HTTP status code Code Message Description
    200 1002 Unable to load certificate. Expecting PEM format file. Invalid PEM format
    200 1004 Failed to delete the certificate. Delete the instance being used first or replace the certificate being used for the instance. Failed to delete certificate (instance in use)
    200 1004 Failed to delete the certificate. No certificate was found with a matching with requested certificate name and certificate number. Failed to delete certificate (name, number mismatch)
    200 2200 No certificate was found. No certificate search results
    200 26034 The certificate is invalid. Invalid certificate
    200 26040 Public key in certificate does not match with private key. Invalid private key match
    400 100 Bad Request Exception Request syntax error
    400 2000 CertificateName is invalid. certificateName can only contain 3-20 English alphabet, numbers, and "-" and must start with an alphabetic character. Invalid certificate name
    400 2100 CertificateName is missing; PrivateKey is missing; PublicKeyCertificate is missing; CertificateChain is missing. Unable to find the certificate's name, private key, public key, or chain
    401 200 Authentication Failed Authentication failed
    401 210 Permission Denied Access unauthorized
    404 300 Not Found Exception Not found on server
    413 430 Request Entity Too Large Request size exceeded
    429 400 Quota Exceeded Request quota exceeded
    429 410 Throttle Limited Too fast or frequent requests
    429 420 Rate Limited Too many requests in a given time period
    503 500 Endpoint Error Endpoint error
    504 510 Endpoint Timeout Endpoint timeout
    500 900 Unexpected Error Unknown error
    Note

    For response status codes common to NAVER Cloud Platform, see Ncloud API response status codes.

    Certificate Manager API

    The following describes the APIs provided by the Certificate Manager service.

    API Description
    createExternalCertificate Add external certificate
    deleteCertificate Delete certificate
    getCertificateList Viewing a certificate

    Certificate Manager related resources

    NAVER Cloud Platform provides a variety of related resources to help users better understand Certificate Manager APIs.