Certificate Manager 개요
-
인쇄
-
PDF
Certificate Manager 개요
-
인쇄
-
PDF
개요
Certificate Manager API는 RESTful 형태로 제공되며, 제공되는 API를 호출하기 위해서는 API Gateway의 IAM 인증을 수행해야 합니다.
공통 설정
IAM 인증
Certificate Manager의 API는 API Gateway를 통해 제공되므로 API Gateway이용 시 필요한 IAM 인증을 위해 이용 신청 및 API Key가 필요합니다.
-
API Gateway 서비스를 이용 신청합니다. (API Gateway 소개)
-
API Gateway의 API Keys 메뉴로 이동하여 API Key를 생성 합니다. (API Key 생성하기)
Certificate Manager의 API의 Subscription Type은 공개-자율구독(Public)이므로 별도의 구독과정없이 생성하신 API Key를 이용하여 사용 가능합니다.
API
| Service | API | Method | Request URI |
|---|---|---|---|
| 인증서 조회 | getCertificateList | GET | https://certificatemanager.apigw.ntruss.com/api/v1/certificates |
| 외부 인증서 추가 | createExternalCertificate | POST | https://certificatemanager.apigw.ntruss.com/api/v1/certificate/withExternal |
| 인증서 삭제 | deleteCertificate | DELETE | https://certificatemanager.apigw.ntruss.com/api/v1/certificate/{certificateNo} |
요청 헤더
IAM 인증을 위한 요청 헤더입니다.
| 헤더명 | 설명 |
|---|---|
| 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 | 요청 경로 및 헤더를 AccessKey와 맵핑되는 SecretKey로 암호화한 서명으로 HMAC 암호화 알고리즘은 HmacSHA256 사용 IAM 인증이 필요한 API 호출하기를 참조 |
공통 오류
| HTTP 응답 코드 | ErrorCode | ErrorMessage |
|---|---|---|
| 400 | 100 | Bad Request Exception |
| 401 | 200 | Authentication Failed |
| 401 | 210 | Permission Denied |
| 404 | 300 | Not Found Exception |
| 429 | 400 | Quota Exceeded |
| 429 | 410 | Throttle Limited |
| 429 | 420 | Rate Limited |
| 413 | 430 | Request Entity Too Large |
| 503 | 500 | Endpoint Error |
| 504 | 510 | Endpoint Timeout |
| 500 | 900 | Unexpected Error |
이 문서가 도움이 되었습니까?