issuePrivate

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

Private CA에서 생성한 CA로부터 사설 인증서를 발급합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
POST /certificate/issuePrivate

요청 헤더

헤더에 대한 설명은 다음과 같습니다.

필드 필수 여부 설명
Content-Type Required 요청 데이터의 형식
  • application/json

Certificate Manager API에서 공통으로 사용하는 헤더에 대한 정보는 Certificate Manager 공통 헤더를 참조해 주십시오.

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
caTag String Required CA 태그 값
certificateName String Required 인증서 이름
  • 3~30자로 영어, 숫자, 특수문자 '-' 허용
  • 중복 불가
certificateType String Required 인증서 유형
  • NCP_PRIVATE: 프라이빗 일반 인증서
  • NCP_PRIVATE_SSL: 프라이빗 SSL 인증서
keyType String Required 키 타입
  • RSA2048 | RSA4096 | EC256 | EC521
period String Required 유효 기간
  • 1~3650
  • 최대 허용 유효 기간으로 설정하려면 MAX 입력
registPrivateKey Boolean Required 개인키 등록 여부
  • true: 개인키를 Certificate Manager에 등록
  • false: 개인키를 Certificate Manager에 등록하지 않음 (발급 이후에 조회할 수 없으므로 응답 값으로 전달 시 별도 저장 필요)
commonName String Required 일반 이름
  • 1~64자
organization String Optional 조직 이름
  • 0~64자
organizationUnit String Optional 부서 이름
  • 0~128자
locality String Optional 도시 이름
  • 0~128자
  • <예시> Seoul
stateProvince String Optional 주/도 또는 지방 이름
  • 0~128자
  • <예시> Gyeonggi-do
streetAddress String Optional 상세 주소
  • 0~128자
country String Optional 표준 국가 코드
dnsSans Array Optional DNS SANs
  • String 타입
  • 0자~200자
  • 도메인 이름 형식으로 입력
emailSans Array Optional Email SANs
  • String 타입
  • 0자~200자
  • 이메일 주소 형식으로 입력
ipSans Array Optional IP SANs
  • String 타입
  • 0자~200자
  • IP 주소 형식으로 입력

요청 예시

요청 예시는 다음과 같습니다.

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-----"
  }
}