createExternalCertificate
- 인쇄
- PDF
createExternalCertificate
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
개요
외부 인증기관에서 발급한 SSL 인증서를 추가합니다.
요청
| Method | Request URI |
|---|---|
| POST | https://certificatemanager.apigw.gov-ntruss.com/api/v1/certificate/withExternal |
요청 헤더
| 헤더명 | 설명 |
|---|---|
| x-ncp-apigw-timestamp | 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타낸 것 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주 |
| x-ncp-iam-access-key | 네이버 클라우드 플랫폼에서 발급받은 API Key 또는 IAM에서 발급받은 AccessKey |
| x-ncp-apigw-signature-v2 | Body를 AccessKey와 맵핑되는 SecretKey로 암호화한 서명 HMAC 암호화 알고리즘은 HmacSHA256 사용 |
| accept | application/json으로 지정 |
| Content-Type | application/json으로 지정 |
요청 파라미터
| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
|---|---|---|---|---|
| certificateName | Yes | String | 중복 불가 | 인증서 이름 |
| privateKey | Yes | String | 중복 불가 | 인증서 개인키PEM–인코딩된 값을 입력합니다. |
| publicKeyCertificate | Yes | String | 중복 불가 | 인증서 공개키PEM–인코딩된 값을 입력합니다. |
| certificateChain | Yes | String | 중복 불가 | 인증서 체인PEM–인코딩된 값을 입력합니다.(인증서 체인 추출 방법은 Certificate Manager 사용 가이드에서 확인 가능) |
응답
응답 바디
| 필드명 | 타입 | 설명 |
|---|---|---|
| returnCode | String | 요청에 대한 처리 결과 코드 |
| returnMessage | String | 요청에 대한 처리 결과 메시지 |
| totalRows | Integer | sslCertificateList의 object 개수 |
| sslCertificateList[] | String | 추가한 인증서 정보 |
예시
요청 예시
curl -X POST "https://certificatemanager.apigw.gov-ntruss.com/api/v1/certificate/withExternal"
-H "accept: application/json"
-H "Content-Type: application/json"
-H "x-ncp-iam-access-key: 72A565A16F1827A27DD5"
-H "x-ncp-apigw-timestamp: 1594649662877"
-H "x-ncp-apigw-signature-v2: 1en0ujbwgX+UNEZ6JnWbxKJQjaf808InNpx7RGZJjCY="
-d "{ "certificateChain": "-----BEGIN CERTIFICATE-----MIIFziCCA3OgAwIBAgIQBUb+GCP34ZQdo5/OFMRhczANBgkqhkiG9w0BAQsFADBhMQswCQYDVQQGEwJVUzEVMTMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBDQTAeFw0xNzExMDYxMjIzNDVaFw0yNzExMDYxMjIzNDVaMF4xCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xHTAbBgNVBAMTFEdlb1RydXN0IFJTQSBDQSAyMDE4MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAv4rRY03hGOqHXegWPI9/tr6HFzekDPgxP59FVEAh150Hm8oDI0q9m+2FAmM/n4W57Cjv8oYi2/hNVEHFtEJ/zzMXAQ6CkFLTxzSkwaEB2jKgQK0fWeQz/KDDlqxobNPomXOMJhB3y7c/OTLo0lko7geG4gk7hfiqafapa59YrXLIW4dmrgjgdPstU0Nigz2PhUwRl9we/FAwuIMIMl5cXMThdSBK66XWdS3cLX184ND+fHWhTkAChJrZDVouoKzzNYoq6tZaWmyOLKv23v14RyZ5eqoi6qnmcRID1/i6U9J5nL1krPYbY7tNjzgC+PBXXcWqJVoMXcUw/iBTGWzpwwIDAQABo4IBQDCCATwwHQYDVR0OBBYEFJBY/7CcdahRVHex7fKjQxY4nmzFMB8GA1UdIwQYMBaAFAPeUDVW0Uy7ZvCj4hsbw5eyPdFVMA4GA1UdDwEB/wQEAwIBhjAdBgNVHSUEFjAUBggrBgEFBQcDAQYIKwYBBQUHAwIwEgYDVR0TAQH/BAgwBgEB/wIBADA0BggrBgEFBQcBAQQoMCYwJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBCBgNVHR8EOzA5MDegNaAzhjFodHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRHbG9iYWxSb290Q0EuY3JsMD0GA1UdIAQ2MDQwMgYEVR0gADAqMCgGCCsGAQUFBwIBFhxodHRwczovL3d3dy5kaWdpY2VydC5jb20vQ1BTMA0GCSqGSIb3DQEBCwUAA4IBAQAw8YdVPYQI/C5earp80s3VLOO+AtpdiXft9OlWwJLwKlUtRfccKj8QW/Pp4b7h6QAlufejwQMb455OjpIbCZVS+awY/R8pAYsXCnM09GcSVe4ivMswyoCZP/vPEn/LPRhHhdgUPk8MlD979RGoUWz7qGAwqJChi28uRds3thx+vRZZIbEyZ62No0tJPzsSGSz8nQ//jP8BIwrzBAUH5WcBAbmvgWfrKcuv+PyGPqRcc4T55TlzrBnzAzZ3oClo9fTvO9PuiHMKrC6V6mgi0s2sa/gbXlPCD9Z24XUMxJElwIVTDuKB0Q4YMMlnpN/QChJ4B0AFsQ+BgkqCO+f78Xf7-----END CERTIFICATE----------BEGIN CERTIFICATE-----MIIGrxCCApegAwIBAgIQCDvgVpBCRrGhdWrJWZHHSjANBgkqhkiG9w0BAQUFADBhMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBDQTAeFw0wNjExMTAwMDAwMDBaFw0zMTExMTAwMDAwMDBaMGExCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydA5jb20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4jvhEXLeqKTTo1eqUKKPC3eQyaKl7jPQ3lsBCSDMAZOnTjC3U/dDxGkAV53ijSLdhwZAAIEJzs4bg7/fzTtxRuLWZscFs3YnFo97nh6Vfe63SKMI2tavegw5BmV/Sl0fvBf4q77uKNd0f3p4mVmFaG5cIzJLv07A6Fpt43C/dxC//AH2hdmoRBBYMql1GNXRor5H4idq9Joz+EkIYIvUX7Q6hL+hqkpMfT7PT19sdl6gSzeRntwi5m3OFBqOasv+zbMUZBfHWymeMr/y7vrTC0LUq7dBMtoM1O/4gdW7jVg/tRvoSSiicNoxZN33shbyTApOB6jtSj1etX+jkMOvJwIDAQABo2MwYTAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUA95QNVbRTLtm8KPiGxvDl7I90VUwHwYDVR0jBBgwFoAUA95QNVbRTLtm8KPiGxvDl7I90VUwDQYJKoZIhvcNAQEFBQADggEBAMucN6pIExIK+t1EnE9SsPTfrgT1eXkIoyQY/EsrhMAtudXH/vTBH1jLuG2cenTnmCmrEbXjcKChzUyImZOMkXDiqw8cvpOp/2PV5Adg06O/nVsJ8dWO41P0jmP6P6fbtGbfYmbW0W5BjfIttep3Sp+dWOIrWcBAI+0tKIJFPnlUkiaY4IBIqDfv8NZ5YBberOgOzW6sRBc4L0na4UU+Krk2U886UAb3LujEV0lsYSEY1QSteDwsOoBrp+uvFRTp2InBuThs4pFsiv9kuXclVzDAGySj4dzp30d8tbQkCAUw7C29C79Fv1C5qfPrmAESrciIxpg0X40KPMbp1ZWVbd4=-----END CERTIFICATE-----",
"certificateName": "CM-openAPI",
"privateKey": "-----BEGIN RSA PRIVATE KEY-----MIIEpIQABBKCAQEAivoZ5cI47dY8yJM4ueGsdeWhzyki/+6vNhxmueW4+CJMzX+L6ym7h3YLNKyBgptU++1cdfbcJuOGYtzXxn+tsKwzYxb8L4cKKQP4Jjgegv8fmmRMaQBFOvNT3JhhvBgMC1rMLGaRj0jnLo/9KO6QJl9A6WRSGVqVi0c6HMr7VYVP/CFKQCRn6wMmIZ0oUpmU04AvcyyoDbagr1acwDkhs3k+fEG2dgGZXDiHzFImfTQvIto8bc6Um6n8YoK2YjO8/DRbwZRmU8gNGfOr6C+i88EwU4Mym7S0FLyGgNzq4NwoKL0KUar5b96GGc1BPbPk2GKpESueSR+DhV/F6RSdYwIDQQEBAoIBAAg3dta6PZbBmNhp2HVcI4jeAnh/zEqVw9THsa14Ax0Jsirjrp+HxXR8qhN1ZSvgLouub/ZCggdw1+p91PXsLCe+yK/9LyVaivgzJ2TuRP3iuY7w7o4BnraRFiNW6IFThWoiwa9s/0sEbq84uzA0yPfWzET9x89m53vpIr0jRqeMfz7qVUq/pU5XZa+EBVjmJk8jVBvGdS0YlFqyZJ6IHHpKdEiZqJ1BHPkxaSNdsnLQhS0q3LrVmB1eD6cB31I6j4WqiXIo+CJ2U1IihpzAZN13wlqASVXmjcthPYU1CJ6k5T9C2ZzPLQxHnrJxn81c+TXyx05IHRYbzb3vpoMWafECgYEA7XKQ4xnDhXPwuQ7adUE6IYAICr0lmK06R30+LOn55GXuw/bJx7A/dorW5AlMRev7xac6jIq0kXB9Y0nbwUVnRivJ2qehZzBuVUmj9u+hqQSyLv0jYrC6fmL5ZPD+FpsdPRWpvBMJl5Mw4AzqSmWOi3gCoTaMPKWpdiOrxpDymtkCgYEAzQXHEC/VuF5yLcCM+rCQcIrTTLEwEfQ+TAQ0kKIQMpX2MCN205Ynw2eQusDajrwxNvl69xg6Aco+VkYg3NI11YjLtHRLGHs4JLHVE1wiU3S4gCAUbMl3uTm4mIzZY4ck7v1BoQJx16+ygObV4/W2YBI3XoQSOykamSSHQBKL/JsCgYEA2+4HoTHV1aAj0WSel4iI7UqHKFs1nYqltl2c30EAgrqfQscs8lafEY9bpu+tw/3lv5c7Nb2rriKBIRvh/cvo8ifQ2UP2zXsgVsLUqf4m9Pn6h6glh3Ul57aIxSQqVInrtQ6BnoALnGdrF7serzYNp8TKusOpdOsEYTZ8/nh3HVECgYEAo8QSrwZWo++lKpCcy/5PUeRCZAdgy2aagGP3jPQ3FgEdZnRdjUNqvbYzMEmuCseeVDhQuSp341gmJQndZCXxZIDhnmIqPgLm5MC737v/m0QnwAhf6EnBfU3y+r+/QbYItXHMg40NXGj2n+pDPdTeebzzR2cdnO4HVf6MnoxyDzMCgYEApNQLQaGuHIrA9X0Y91rRfFAL4J7XQAIsc08LKtyKX1711wtK53eWbp2vTF0OWwIKr2j5aQHrUph77Pde4Sg5t2mQumgT/m/WGk6z07+4I3/ZqqxJmGqspxUBxysAygQRY0jQyApZxu5psO30M4RqHWmdlnfnfHpZETmsiH2QIfk=-----END RSA PRIVATE KEY-----",
"publicKeyCertificate": "-----BEGIN CERTIFICATE-----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-----END CERTIFICATE-----" }"
응답 예시
응답 헤더
connection: keep-alive
content-type: application/json;charset=UTF-8
date: Mon, 13 Jul 2020 14:14:26 GMT
referrer-policy: unsafe-url
server: nginx
transfer-encoding: chunked
x-ncp-apigw-response-origin: ENDPOINT
x-ncp-trace-id: 32cj46him8dhg30oj668rjedb3
응답 바디
{
"returnCode": "0",
"returnMessage": "Success",
"totalRows": 1,
"sslCertificateList": [
{
"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 응답 코드 | errorCode | message | 설명 |
|---|---|---|---|
| 200 | 1002 | Unable to load certificate. Expecting PEM format file. | PEM 형식이 유효하지 않음 |
| 200 | 26034 | The certificate is invalid. | 인증서가 유효하지 않음 |
| 200 | 26040 | Public key in certificate does not match with private key. | 개인키 정합성이 유효하지 않음 |
| 400 | 2000 | CertificateName is invalid. certificateName can only contain 3-20 English alphabet, numbers, and "-" and must start with an alphabetic character. | 인증서 이름이 유효하지 않음 |
| 400 | 2100 | CertificateName is missing; PrivateKey is missing; PublicKeyCertificate is missing; CertificateChain is missing. | 인증서 이름 또는 개인키 또는 인증서 본문 또는 인증서 체인을 찾을 수 없음 |
이 문서가 도움이 되었습니까?