issuePrivate
- 인쇄
- PDF
issuePrivate
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
Classic/VPC 환경에서 이용 가능합니다.
Private CA에서 생성한 CA로부터 사설 인증서를 발급합니다.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
메서드 | URI |
---|---|
POST | /certificate/issuePrivate |
요청 헤더
헤더에 대한 설명은 다음과 같습니다.
필드 | 필수 여부 | 설명 |
---|---|---|
Content-Type | Required | 요청 데이터의 형식
|
Certificate Manager API에서 공통으로 사용하는 헤더에 대한 정보는 Certificate Manager 공통 헤더를 참조해 주십시오.
요청 바디
요청 바디에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
caTag | String | Required | CA 태그 값
|
certificateName | String | Required | 인증서 이름
|
certificateType | String | Required | 인증서 유형
|
keyType | String | Required | 키 타입
|
period | String | Required | 유효 기간
|
registPrivateKey | Boolean | Required | 개인키 등록 여부
|
commonName | String | Required | 일반 이름
|
organization | String | Optional | 조직 이름
|
organizationUnit | String | Optional | 부서 이름
|
locality | String | Optional | 도시 이름
|
stateProvince | String | Optional | 주/도 또는 지방 이름
|
streetAddress | String | Optional | 상세 주소
|
country | String | Optional | 표준 국가 코드 |
dnsSans | Array | Optional | DNS SANs
|
emailSans | Array | Optional | Email SANs
|
ipSans | Array | Optional | IP SANs
|
요청 예시
요청 예시는 다음과 같습니다.
curl --location --request POST 'https://certificatemanager.apigw.gov-ntruss.com/api/v1/certificate/issuePrivate' \
--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 '{
"caTag": "Private CA의 CA 태그 값",
"certificateName": "string",
"certificateType": "NCP_PRIVATE | NCP_PRIVATE_SSL",
"keyType": "RSA2048 | RSA4096 | EC256 | "EC521",
"period": "1~3650 사이의 숫자 입력, 허용되는 최대 유효기간 설정은 ‘MAX’를 입력",
"registPrivateKey": true | false,
"commonName": "string",
"organization": "string",
"organizationUnit": "string",
"country": "string",
"stateProvince": "string",
"locality": "string",
"streetAddress": "string",
"dnsSans": [
"string"
],
"emailSans": [
"string"
],
"ipSans": [
"string"
]
}'
응답
응답 형식을 설명합니다.
응답 바디
응답 바디에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
returnCode | String | - | 응답 코드 |
returnMessage | String | - | 응답 메시지 |
totalRows | Integer | - | 응답 결과 수 |
certificate | Object | - | 인증서 오브젝트 |
certificate.certificateNo | Integer | - | 인증서 번호 |
certificate.certificateName | String | - | 인증서 이름 |
certificate.statusCode | String | - | 인증서 상태 코드 (1: 정상) |
certificate.statusName | String | - | 인증서 상태 이름 |
certificate.regDate | Date | - | 인증서 등록 일시 |
certificate.validStartDate | Date | - | 인증서 유효 시작 일시 |
certificate.validStartDate | Date | - | 인증서 유효 종료 일시 |
certificate.domainAddress | String | - | 인증서의 대표 도메인 |
certificate.subDomainAddress | String | - | 인증서의 서브 도메인 |
certificate.ipSans | String | - | SAN 필드 IP 주소 |
certificate.emailSans | String | - | SAN 필드 이메일 주소 |
certificate.emailSans | String | - | SAN 필드 이메일 주소 |
응답 상태 코드
Certificate Manager API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Certificate Manager 공통 응답 상태 코드를 참조해 주십시오.
응답 예시
응답 예시는 다음과 같습니다.
{
"returnCode": "0",
"returnMessage": "Success",
"totalRows": 1,
"certificate": {
"certificateNo": ****,
"certificateName": "myCert",
"statusCode": "1",
"statusName": "Normal",
"regDate": "2025-02-19 11:27:17",
"validStartDate": "2025-02-19 11:26:47",
"validEndDate": "2030-08-03 18:06:00",
"domainAddress": "mydomain.com",
"subDomainAddress": "mysubdomain.com, othersubdomain.com",
"ipSans": "*.*.*.*",
"emailSans": "n***@n***r.com",
"certSerialNumber": "**:**:**:**:**:**:**:**:**:**:**:**:**:**:**:**:**:**:**:**",
"caTag": "********-********",
"privateKey": "-----BEGIN RSA PRIVATE KEY-----\n ... \n-----END RSA PRIVATE KEY-----",
"publicKeyCertificate": "-----BEGIN CERTIFICATE-----\n ... \n-----END CERTIFICATE-----",
"certificateChain": "-----BEGIN CERTIFICATE-----\n ... \n-----END CERTIFICATE-----"
}
}
이 문서가 도움이 되었습니까?