getCertificateList
    • PDF

    getCertificateList

    • PDF

    기사 요약

    개요

    SSL 인증서를 조회합니다.

    요청

    MethodRequest URI
    GEThttps://certificatemanager.apigw.gov-ntruss.com/api/v1/certificates

    요청 헤더

    헤더명설명
    x-ncp-apigw-timestamp1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타낸 것
    API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
    x-ncp-iam-access-key네이버 클라우드 플랫폼에서 발급받은 API Key 또는 IAM에서 발급받은 AccessKey
    x-ncp-apigw-signature-v2Body를 AccessKey와 맵핑되는 SecretKey로 암호화한 서명
    HMAC 암호화 알고리즘은 HmacSHA256 사용
    acceptapplication/json으로 지정

    요청 파라미터

    파라미터명필수 여부타입설명
    certificateNameNoString인증서 이름으로 필터링하여 조회
    Default : 모든 인증서를 조회합니다.
    certificateNoNoInteger인증서 번호로 필터링하여 조회
    Default : 모든 인증서를 조회합니다.
    instanceNoNoInteger인스턴스 번호로 필터링하여 조회
    Default : 모든 인증서를 조회합니다.

    응답

    응답 바디

    필드명타입설명
    returnCodeString요청에 대한 처리 결과 코드
    returnMessageString요청에 대한 처리 결과 메시지
    totalRowsIntegersslCertificateList의 object 개수
    sslCertificateList[]String요청한 인증서 조회 결과
    리스트에 object가 있을 경우: 해당 인증서 있음
    리스트에 object가 없을 경우: 해당 인증서 없음

    예시

    요청 예시

    curl -X GET "https://certificatemanager.apigw.gov-ntruss.com/api/v1/certificates" 
    -H "accept: application/json" 
    -H "x-ncp-iam-access-key: 72A565A16F1827A27DD5" 
    -H "x-ncp-apigw-timestamp: 1594646226859" 
    -H "x-ncp-apigw-signature-v2: y0hqZ1RyFtJjTq7ZLcu6ds1d8HyzoTgT1XoPjkyoYA8=" 
    -H "cache-control: no-cache" 
    -H "pragma: no-cache"
    

    응답 예시

    응답 헤더

    connection: keep-alive 
    content-type: application/json;charset=UTF-8 
    date: Mon, 13 Jul 2020 13:17:08 GMT 
    referrer-policy: unsafe-url 
    server: nginx 
    transfer-encoding: chunked 
    x-ncp-apigw-response-origin: ENDPOINT 
    x-ncp-trace-id: 32e1m6kp3acr43gohj6li30e36 
    

    응답 바디

    {
      "returnCode": "0",
      "returnMessage": "Success",
      "totalRows": 3,
      "sslCertificateList": [
        {
          "certificateNo": 3,
          "certificateName": "myCertificate-03",
          "memberNo": "1",
          "dnInfo": "CN=www.example.com, O=NAVER Cloud Corp., L=Bundang-gu, S=Seongnam-si, C=KR",
          "domainAddress": "www.example.com",
          "subDomainAddress": "",
          "regDate": "2020-07-13 13:52:36",
          "issueDate": null,
          "validStartDate": "2019-10-21 09:00:00",
          "validEndDate": "2021-10-20 21:00:00",
          "disuseDate": null,
          "disuseMsg": null,
          "requestId": null,
          "statusCode": "1",
          "statusName": "Normal",
          "externalYn": "N",
          "domainCode": "PUB",
          "caInfo": "NAVER Secure Certification Authority 1",
          "certSerialNumber": "e9af6050aea0e2af700519217c00f95",
          "certPublicKeyInfo": "Sun RSA public key, 2048 bits",
          "certSignAlgorithmName": "SHA256withRSA",
          "usedInstanceNoList": null
        },
        {
          "certificateNo": 2,
          "certificateName": "myCertificate-02",
          "memberNo": "1",
          "dnInfo": "CN=mail.example.com",
          "domainAddress": "mail.example.com",
          "subDomainAddress": "mail2.example.com",
          "regDate": "2020-07-13 13:36:57",
          "issueDate": null,
          "validStartDate": "2019-10-21 09:00:00",
          "validEndDate": "2021-10-20 21:00:00",
          "disuseDate": null,
          "disuseMsg": null,
          "requestId": null,
          "statusCode": "1",
          "statusName": "Normal",
          "externalYn": "Y",
          "domainCode": "PUB",
          "caInfo": "ABC RSA CA 2018",
          "certSerialNumber": "d9af6050bea0e2af700518217c00695",
          "certPublicKeyInfo": "Sun RSA public key, 2048 bits",
          "certSignAlgorithmName": "SHA256withRSA",
          "usedInstanceNoList": null
        },
        {
          "certificateNo": 1,
          "certificateName": "myCertificate-01",
          "memberNo": "1",
          "dnInfo": "CN=exmaple.net",
          "domainAddress": "exmaple.net",
          "subDomainAddress": "www.exmaple.net",
          "regDate": "2020-05-30 14:40:48",
          "issueDate": null,
          "validStartDate": "2019-07-10 09:00:00",
          "validEndDate": "2021-07-10 08:59:59",
          "disuseDate": null,
          "disuseMsg": null,
          "requestId": null,
          "statusCode": "1",
          "statusName": "Normal",
          "externalYn": "Y",
          "domainCode": "PUB",
          "caInfo": "XYZ RSA Domain Validation Secure Server CA",
          "certSerialNumber": "bfc9f64ca4532d9897d542c72988d61f",
          "certPublicKeyInfo": "Sun RSA public key, 2048 bits",
          "certSignAlgorithmName": "SHA256withRSA",
          "usedInstanceNoList": null
        }
      ]
    }
    

    오류 코드

    아래 오류 코드는 이 액션(Action)에서 특징적으로 발생하는 오류입니다. 공통적으로 발생하는 오류에 대한 상세한 설명은 NAVER Cloud Platform API를 참고해주세요

    HTTP 응답 코드errorCodemessage설명
    2002200No certificate was found.인증서 조회 결과가 없음

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

    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.