2.12 SSL 구독 정보 교체
2.12.1 API 정보
| 테스트 환경 | |
|---|---|
| 실제 환경 | https://portal.racent.com/ssl/replace |
| 요청 방식 | POST |
| content-type | multipart/form-data |
| 설명 | 이 인터페이스는 SSL 구독 정보를 교체하는 데 사용됩니다. SSL 인증서와만 관련됩니다. SSL 구독 상태가 발급 완료인 경우에만 SSL 구독 정보 교체가 허용됩니다. |
2.12.2 매개변수 정의
| 매개변수 이름 | 매개변수 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| api_token | String | Y | 신원 증명 자격 증명으로, token 생성은 Racent 기술 지원에 문의하십시오. |
| certId | String | Y | racent 인증서 id |
| refId | String | N | 고객이 제공한 고유 고객 주문 번호 |
| domainVerificationPic | File | N | 도메인 검증 방식이 VERIFY_DOCUMENT인 경우 이 항목은 Y입니다. 도메인 제어 검증(DCV)에 사용됩니다(현재 CFCA만 지원). |
| params | String | Y | 대체 정보, 구체적인 설명은 다음과 같습니다 |
| csr | String | Y | 참고: CSR 정보의 도메인은 기존 SSL 구독의 CSR에 포함된 도메인과 일치해야 합니다. |
| 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 | Y | 도메인 정보입니다. 예시: [ { "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 | Y | 도메인 제어 검증(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 | Y | 도메인 이름입니다. |
| organizationInfo | String | N | 회사 정보를 변경해야 하는 경우 이 파라미터는 Y입니다. |
| organizationCity | String | N | 회사 소재 도시. |
| organizationName | String | N | 회사명. |
| organizationMobile | String | N | 회사 전화번호. |
| organizationAddress | String | N | 회사 주소. |
| organizationCountry | String | N | 회사 소재 국가(ISO 3166-1 표준의 두 자리 코드). |
| organizationPostCode | 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 | 파일 검증 파일 경로 |