2.2 인증서 주문
2.2.1 인터페이스 설명
| 테스트 환경 | |
|---|---|
| 실제 환경 | https://portal.racent.com/ssl/place |
| 요청 방식 | POST |
| content-type | multipart/form-data |
| 설명 | 이 인터페이스는 인증서 주문에 사용됩니다. |
2.2.2 매개변수 정의
| 매개변수 이름 | 매개변수 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| api_token | String | Y | 신원 증명 자격 증명으로, token 생성은 Racent 기술 지원팀에 문의하십시오. |
| productCode | String | Y | 제품 코드, 제품 코드 획득 방법(2.7 참조) |
| years | Int | Y | 구매 연한(현재 1, 2, 3, 4, 5년만 지원), 구체적인 제품에 따라 다릅니다. |
| refId | String | N | 고객이 제공하는 고유 고객 주문 번호 |
| verificationPic | File | N | 예비 검증 자료입니다. 조직 검증에 사용되며 .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf 형식을 지원하고, 파일 크기는 2M를 초과할 수 없습니다. |
| domainVerificationPic | File | N | 도메인 검증 방식이 VERIFY_DOCUMENT인 경우 이 항목은 Y입니다. 도메인 제어 검증(DCV)에 사용됩니다(현재 CFCA만 지원). |
| params | String | Y | 주문 정보이며, 구체적인 설명은 다음과 같습니다. |
| csr | String | N | 매개변수가 비어 있으면 csr이 생성되고 개인 키가 저장됩니다. |
| privateKey | String | N | 개인 키. |
| server | String | N | 서버. SSL 인증서에만 관련됩니다. SSL 인증서의 경우 매개변수는 Y이고, 다른 유형의 제품의 경우 매개변수는 N입니다. 이 매개변수가 필요하지 않은 경우 기본값을 "other"로 설정하십시오. |
| orgCheck | Int | N | 값은 0 또는 1입니다. 값이 1일 경우, 제출한 조직 정보를 바탕으로 계정 내 모든 조직을 검색합니다. 일치하는 조직이 있으면 해당 조직의 연계 정보를 사용하고, 없으면 새 조직으로 저장합니다. 값이 0일 경우 조직 정보를 저장하지 않습니다. |
| duplicateOrgCheck | Int | N | 값은 0 또는 1입니다. 이 매개변수는 현재 Digicert SSL 인증서에만 적용됩니다. 이전에 검증 완료된 조직 및 도메인 정보를 재사용할지 여부를 결정합니다. 값이 1일 경우 재사용하고, 0일 경우 새로 생성합니다. 기본값은 1입니다. |
| needFree | Int | N | 값은 1 또는 2입니다. 값이 1일 경우 FQDN을 무료로 제공하며, 동시에 www.domain에 대해 domain도 무료로 제공합니다. 값이 2일 경우 무료로 제공하지 않습니다. |
| uniqueValue | String | N | Sectigo 제품에만 적용됩니다. 리셀러가 자체적으로 검증 값을 생성할 때 사용하며 1~20자(a-z A-Z 0-9)로 입력합니다. |
| dcvMethod | String | N | 신청 도메인의 검증 방식을 일괄 설정합니다. 다음 네 가지 방식 중 하나여야 합니다: EMAIL(이메일 검증) HTTP_CSR_HASH(파일 검증) CNAME_CSR_HASH(DNS 검증) HTTPS_CSR_HASH(https 파일 검증) VERIFY_DOCUMENT(도메인 인증서 증명, CFCA만 지원) CFCA의 경우 이 항목이 Y입니다. |
| domainInfo | String | N | 도메인 정보로, SSL 인증서에만 적용됩니다. SSL 인증서의 경우 이 매개변수가 Y이고, 다른 유형의 경우 N입니다. 예시: [ { "dcvEmail": "admin@xxx.com", "dcvMethod": "EMAIL", "domainName": "www.xxx.com" }, { "dcvEmail": "admin@aaa.com", "dcvMethod": "EMAIL", "domainName": "aaa.com" }, "dcvEmail": "admin@racent.com", "dcvMethod": "EMAIL", "domainName": "racent.com" } ] 구체적인 설명은 다음과 같습니다. |
| dcvMethod | String | N | 도메인 검증 방식. 다음 네 가지 방식 중 하나여야 합니다: EMAIL(이메일 검증) HTTP_CSR_HASH(파일 검증) CNAME_CSR_HASH(DNS 검증) HTTPS_CSR_HASH(https 파일 검증) 상위 dcvMethod가 존재하지 않을 경우 이 항목은 Y입니다. 상위 dcvMethod가 존재하고 이 항목도 존재할 경우, 상위 dcvMethod가 우선 적용됩니다 |
| dcvEmail | String | N | 도메인 검증 이메일. 이 항목이 N일 때 기본값은 다음과 같습니다 racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com |
| domainName | String | N | 도메인 |
| organizationInfo | String | N | 회사 정보입니다. 기업 검증이 필요한 제품을 주문할 경우 이 매개변수는 Y입니다. 예시는 다음과 같습니다: { "organizationCity": "上海", "organizationName": "某公司", "organizationMobile": "18111111111", "organizationAddress": "上海市路", "organizationCountry": "CN", "organizationPostCode": "401320" }" |
| organizationCity | String | N | 회사 소재 도시입니다. |
| organizationName | String | N | 회사명입니다. |
| organizationMobile | String | N | 회사 전화번호입니다. |
| organizationAddress | String | N | 회사 주소입니다. |
| organizationCountry | String | N | 회사 소재 국가(ISO 3166-1 표준의 두 자리 코드)입니다. |
| organizationPostCode | String | N | 회사 소재지 우편번호입니다. |
| organizationRegNumbe | String | N | 회사 증서 번호입니다. CFCA의 경우 이 항목이 Y입니다. |
| idType | String | N | 회사 증서 유형입니다. CFCA의 경우 이 항목이 Y입니다. 값은 다음과 같습니다: TYDMZ：통합 사회 신용 코드 OTHERS：기타 |
| Administrator | string | Y | 관리자 정보, 담당자입니다. 코드 서명, 이메일 서명, 문서 서명을 신청할 때 이 파라미터는 신청 정보로 사용됩니다. 또한 csr이 N인 경우 이 정보는 csr 생성 정보로 사용됩니다. { "job": "총경영실", "city": "상하이시", "email": "xx@yy.com", "state": "상하이시", "mobile": "18111111111", "address": "상하이시", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某회사" }" |
| job | String | Y | 관리자 직책입니다. |
| city | String | Y | 관리자가 위치한 도시입니다. |
| String | Y | 관리자의 이메일 주소입니다. | |
| state | String | Y | 관리자所在省或州。 |
| mobile | String | Y | 관리자 연락처입니다. |
| address | String | Y | 관리자 연락 주소입니다. |
| country | String | Y | 관리자가 소재한 국가(ISO 3166-1 표준의 두 자리 코드)입니다. |
| lastName | String | Y | 관리자의 성입니다. |
| postCode | String | Y | 관리자 소재지의 우편번호입니다. |
| firstName | String | Y | 관리자 이름입니다. |
| organation | String | Y | 관리자 회사명입니다. |
| idType | String | N | 증명서 유형입니다. CFCA의 경우 이 항목은 Y입니다. |
| idNumber | String | N | 증명서 번호. CFCA의 경우 이 항목은 Y입니다. |
| finance | string | SSL 인증서에만 관련됩니다. 재무 담당자 정보. 관리자 정보와 동일할 수 있습니다. 주문 제품이 dv 유형이 아닌 경우 이 매개변수는 Y입니다. { "job": "재무부", "city": "상하이시", "email": "xx@yy.com", "state": "상하이시", "mobile": "18111111111", "address": "상하이시", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }" | |
| job | String | N | 재무 담당자 직책. |
| city | String | N | 재무 담당자가 위치한 도시입니다. |
| String | N | 재무 담당자의 이메일 주소입니다. | |
| state | String | N | 재무 담당자가 위치한 성 또는 주입니다. |
| mobile | String | N | 재무 담당자 연락처입니다. |
| address | String | N | 재무 담당자 연락 주소입니다. |
| country | String | N | 재무 담당자 소재 국가입니다(ISO 3166-1 표준의 2자리 코드). |
| lastName | String | N | 재무 담당자의 성입니다. |
| postCode | String | N | 재무 담당자 소재지의 우편번호입니다. |
| firstName | String | N | 재무 담당자의 이름입니다. |
| organation | String | N | 재무 담당자가 소속된 회사입니다. |
| idType | String | N | 증명서 유형입니다. CFCA의 경우 이 항목은 Y입니다. 값은 다음과 같습니다: SFZ：주민등록증 HZ：여권 |
| idNumber | String | N | 증명서 번호입니다. CFCA의 경우 이 항목은 Y입니다. |
| tech | string | N | SSL 인증서와만 관련됩니다. 기술 담당자 정보입니다. 주문 제품이 dv 유형이 아닌 경우 이 매개변수는 Y입니다. { "job": "기술부","city": "상하이시", "email": "xx@yy.com", "state": "상하이시", "mobile": "18111111111", "address": "상하이시", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }" |
| job | String | N | 기술 담당자 직책입니다. |
| city | String | N | 기술 담당자가 위치한 도시입니다. |
| String | N | 기술자의 이메일 주소입니다. | |
| state | String | N | 기술자가 위치한 성 또는 주입니다. |
| mobile | String | N | 기술자의 연락처입니다. |
| address | String | N | 기술자 연락처 주소입니다. |
| country | String | N | 기술자 소재 국가입니다(ISO 3166-1 표준의 2자리 코드). |
| lastName | String | N | 기술자의 성입니다. |
| postCode | String | N | 기술자 소재지 우편번호입니다. |
| firstName | String | N | 기술자 이름입니다. |
| organation | String | N | 기술자 소속 회사입니다. |
| idType | String | N | 증명서 유형. CFCA의 경우 이 항목은 Y입니다. 값은 다음과 같습니다: SFZ: 주민등록증 HZ: 여권 |
| idNumber | String | N | 증명서 번호. CFCA의 경우 이 항목은 Y입니다. |
함수 반환
| 매개변수 이름 | 매개변수 유형 | 필수 | 설명 |
|---|---|---|---|
| code | Int | Y | 반환 상태, 자세한 내용은 부록 3.1을 참조하십시오 |
| errors | Object or String | N | 반환 상태가 오류인 경우 구체적인 오류 정보입니다. |
| data | Object | N | 반환 상태가 성공인 경우 이 매개변수는 Y입니다. 구체적인 설명은 다음과 같습니다: |
| certId | String | N | racent 인증서 id. 잘 보관하십시오, 이 매개변수는 racent 인스턴스의 고유 자격 증명입니다. |
| failReason | Object | N | Racent가 CA에 인증서를 신청하는 데 실패하고 실패 원인을 명확히 파악할 수 있는 경우 이 항목이 반환됩니다. |
| dataReasons | Array | N | 데이터 원인 |
| key | String | N | 항목 |
| reason | String | N | 원인 |
| sysReason | String | N | 시스템 원인 |
| vendorId | String | N | CA 주문 번호. |
| vendorCertId | String | N | CA 인증서 번호. |
| DCVfileName | String | N | 파일 검증 파일명 |
| DCVfileContent | String | N | 파일 검증 파일 내용 |
| DCVdnsHost | String | N | DNS 검증 호스트 값 |
| DCVdnsValue | String | N | DNS 검증 레코드 값 |
| DCVdnsType | String | N | DNS 검증 레코드 유형 |
| DCVfilePath | String | N | 파일 검증 파일 경로 |
| dcvInfo | Object | N | 인증서 신청 시 각 도메인의 검증 값이 다를 경우 이 항목은 Y입니다 각 항목의 유형은 Object이며, 각 객체명은 신청한 도메인입니다(예: racent.com). 각 항목의 세부 정보는 다음과 같습니다: |
| DCVfileName | String | N | 파일 검증 파일 내용 |
| DCVfileContent | String | N | 파일 검증 파일 내용 |
| DCVdnsHost | String | N | DNS 검증 호스트 값 |
| DCVdnsValue | String | N | DNS 검증 레코드 값 |
| DCVdnsType | String | N | DNS 검증 레코드 유형 |
| DCVfilePath | String | N | 파일 검증 파일 경로 |