2.21 신청 자료 수정
2.21.1 API 정보
| 테스트 환경 | |
|---|---|
| 실제 환경 | https://portal.racent.com/ssl/alter |
| 요청 방식 | POST |
| content-type | multipart/form-data |
| 설명 | 이 인터페이스는 CFCA 인증서 신청 실패 시 신청 자료를 수정하는 용도로만 사용됩니다. |
2.21.2 매개변수 정의
| 매개변수 이름 | 매개변수 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| api_token | String | Y | 신원 증명 자격 증명입니다. 토큰 생성은 Racent 기술 지원팀에 문의해 주세요. |
| certId | String | Y | Racent 인증서 id |
| refId | String | N | 고객이 제공하는 고유 고객 주문 번호입니다. |
| verificationPic | File | N | 예비 검증 자료입니다. 조직 검증에 사용되며 .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip 형식을 지원하고, 파일 크기는 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입니다. |
| 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 | 도메인 제어 검증(DCV) 방식. 반드시 다음 네 가지 방식 중 하나여야 합니다: EMAIL(이메일 검증) HTTP_CSR_HASH(파일 검증) CNAME_CSR_HASH(DNS 검증) HTTPS_CSR_HASH(https 파일 검증) 상위 dcvMethod가 존재하지 않을 경우 이 항목은 Y입니다. 상위 dcvMethod가 존재하고 이 항목도 존재하는 경우 상위 dcvMethod가 우선 적용됩니다 |
| dcvEmail | String | N | 도메인 제어 검증(DCV) 이메일. 이 항목이 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 표준의 2자 코드)입니다. |
| 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입니다. 값은 다음과 같습니다: SFZ：주민등록증 HZ：여권 |
| 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 인스턴스의 고유 자격 증명입니다. |
| 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 | 파일 검증용 파일 경로 |
| failReason | Object | N | Racent에서 인증 기관(CA)에 인증서 신청이 실패하고 실패 원인을 명확히 파악할 수 있는 경우 이 항목이 반환됩니다. |
| dataReasons | Array | N | 데이터 관련 원인 |
| key | String | N | 항목 |
| reason | String | N | 원인 |
| sysReason | String | N | 시스템 관련 원인 |