issuePrivate
    • PDF

    issuePrivate

    • PDF

    기사 요약

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

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

    요청

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

    메서드URI
    POST/certificate/issuePrivate

    요청 헤더

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

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

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

    요청 바디

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

    필드타입필수 여부설명
    caTagStringRequiredCA 태그 값
    certificateNameStringRequired인증서 이름
    • 3~30자로 영어, 숫자, 특수문자 '-' 허용
    • 중복 불가
    certificateTypeStringRequired인증서 유형
    • NCP_PRIVATE: 프라이빗 일반 인증서
    • NCP_PRIVATE_SSL: 프라이빗 SSL 인증서
    keyTypeStringRequired키 타입
    • RSA2048 | RSA4096 | EC256 | EC521
    periodStringRequired유효 기간
    • 1~3650
    • 최대 허용 유효 기간으로 설정하려면 MAX 입력
    registPrivateKeyBooleanRequired개인키 등록 여부
    • true: 개인키를 Certificate Manager에 등록
    • false: 개인키를 Certificate Manager에 등록하지 않음 (발급 이후에 조회할 수 없으므로 응답 값으로 전달 시 별도 저장 필요)
    commonNameStringRequired일반 이름
    • 1~64자
    organizationStringOptional조직 이름
    • 0~64자
    organizationUnitStringOptional부서 이름
    • 0~128자
    localityStringOptional도시 이름
    • 0~128자
    • <예시> Seoul
    stateProvinceStringOptional주/도 또는 지방 이름
    • 0~128자
    • <예시> Gyeonggi-do
    streetAddressStringOptional상세 주소
    • 0~128자
    countryStringOptional표준 국가 코드
    dnsSansArrayOptionalDNS SANs
    • String 타입
    • 0자~200자
    • 도메인 이름 형식으로 입력
    emailSansArrayOptionalEmail SANs
    • String 타입
    • 0자~200자
    • 이메일 주소 형식으로 입력
    ipSansArrayOptionalIP 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"
        ]
    }'
    

    응답

    응답 형식을 설명합니다.

    응답 바디

    응답 바디에 대한 설명은 다음과 같습니다.

    필드타입필수 여부설명
    returnCodeString-응답 코드
    returnMessageString-응답 메시지
    totalRowsInteger-응답 결과 수
    certificateObject-인증서 오브젝트
    certificate.certificateNoInteger-인증서 번호
    certificate.certificateNameString-인증서 이름
    certificate.statusCodeString-인증서 상태 코드 (1: 정상)
    certificate.statusNameString-인증서 상태 이름
    certificate.regDateDate-인증서 등록 일시
    certificate.validStartDateDate-인증서 유효 시작 일시
    certificate.validStartDateDate-인증서 유효 종료 일시
    certificate.domainAddressString-인증서의 대표 도메인
    certificate.subDomainAddressString-인증서의 서브 도메인
    certificate.ipSansString-SAN 필드 IP 주소
    certificate.emailSansString-SAN 필드 이메일 주소
    certificate.emailSansString-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-----"
      }
    }
    

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

    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.