2.10 SSL 구독 갱신
2.10.1 API 정보
| 테스트 환경 | |
|---|---|
| 실제 환경 | https://portal.racent.com/ssl/renew |
| 요청 방식 | POST |
| content-type | multipart/form-data |
| 설명 | 이 인터페이스는 SSL 구독을 갱신하는 데 사용됩니다. SSL 구독 상태가 발급 완료이고 30일 이내에 만료되는 구독만 갱신할 수 있습니다. |
2.10.2 매개변수 정의
| 매개변수 이름 | 매개변수 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| api_token | String | Y | 신원 증명 자격 증명이며, 토큰 생성은 Racent 기술 지원에 문의하십시오. |
| renewId | String | Y | racent 인증서 id |
| 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 | 도메인 제어 검증(DCV) 방식이 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입니다. |
| 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입니다. CFCA의 경우 이 항목은 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 | 도메인 제어 검증(DCV) 방식입니다. 다음 네 가지 방식 중 하나여야 합니다: EMAIL(이메일 검증) HTTP_CSR_HASH(파일 검증) CNAME_CSR_HASH(DNS 검증) HTTPS_CSR_HASH(https 파일 검증) |
| dcvEmail | String | N | 도메인 검증용 이메일입니다. 검증 방식이 EMAIL인 경우 이 항목은 Y입니다. |
| domainName | String | N | 도메인 |
| organizationInfo | String | N | 회사 정보입니다. 기업 검증이 필요한 제품을 주문할 경우 이 파라미터는 Y입니다. CFCA의 경우 이 항목은 N입니다. 예시는 다음과 같습니다: { "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 | 회사 소재지 우편번호입니다. |
| Administrator | String | Y | 관리자 정보, 담당자 정보입니다. 코드 서명, 이메일 서명, 문서 서명 신청 시 이 매개변수는 신청 정보로 사용됩니다. 또한 csr이 N인 경우 이 정보는 csr 생성 정보로 사용됩니다. CFCA의 경우 이 항목은 N입니다. { "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 | 관리자 회사명입니다. |
| finance | String | SSL 인증서에만 관련됩니다. 재무 담당자 정보입니다. 관리자 정보와 동일해도 됩니다. 주문 제품이 dv 유형이 아닌 경우 이 매개변수는 Y입니다. CFCA의 경우 이 항목은 N입니다. { "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 | 재무 담당자가 소속된 회사입니다. |
| tech | String | N | SSL 인증서에만 관련됩니다. 기술 담당자 정보입니다. 주문 제품이 dv 유형이 아닐 경우 이 파라미터는 Y입니다. CFCA의 경우 이 항목은 N입니다. { "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 | 기술자 소재 성(省) 또는 주(State)입니다. |
| 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 | 기술자가 소속된 회사입니다. |
함수 반환
| 매개변수 이름 | 매개변수 유형 | 필수 | 설명 |
|---|---|---|---|
| code | Int | Y | 반환 상태이며, 자세한 내용은 부록 3.1을 참조하십시오. |
| errors | Object or String | N | 반환 상태가 오류일 때의 구체적인 오류 정보입니다. |
| data | Object | N | 반환 상태가 성공일 때 이 매개변수는 Y입니다. 구체적인 설명은 다음과 같습니다. |
| certId | String | N | Racent 인증서 id입니다. 이 매개변수는 Racent 인스턴스의 고유 자격 증명이므로 안전하게 보관하십시오. |
| 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 | 파일 검증 파일 경로 |