2.21 Sửa đổi hồ sơ đăng ký
2.21.1 Thông tin Api
| Môi trường kiểm thử | |
|---|---|
| Môi trường thực tế | https://portal.racent.com/ssl/alter |
| Phương thức yêu cầu | POST |
| content-type | multipart/form-data |
| Mô tả | Giao diện này chỉ dùng khi đăng ký chứng chỉ CFCA thất bại, để sửa đổi thông tin đăng ký. |
2.21.2 Định nghĩa tham số
| Tên tham số | Loại tham số | Bắt buộc | Mô tả |
|---|---|---|---|
| api_token | String | Y | Thông tin xác thực, để tạo token vui lòng liên hệ bộ phận hỗ trợ kỹ thuật của Racent. |
| certId | String | Y | ID chứng chỉ racent |
| refId | String | N | Mã đơn hàng duy nhất do khách hàng cung cấp |
| verificationPic | File | N | Tài liệu xác minh dự phòng. Dùng để xác minh tổ chức, hỗ trợ định dạng .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip, dung lượng không quá 2M. |
| domainVerificationPic | File | N | Khi phương thức xác minh tên miền là: VERIFY_DOCUMENT, mục này là Y. Dùng để xác minh quyền sở hữu tên miền (hiện chỉ hỗ trợ CFCA). |
| params | String | Y | Thông tin đặt hàng, mô tả cụ thể như sau |
| csr | String | N | Khi tham số để trống, hệ thống sẽ tạo csr cho bạn và lưu khóa riêng. |
| privateKey | String | N | Khóa riêng. |
| server | String | N | Máy chủ. Chỉ liên quan đến chứng chỉ SSL. Tham số của chứng chỉ SSL là Y, tham số của các loại sản phẩm khác là N. Nếu không cần tham số này, vui lòng đặt mặc định là “other”. |
| orgCheck | Int | N | Giá trị là 0 hoặc 1. Khi giá trị là 1, hệ thống sẽ truy vấn tất cả tổ chức trong tài khoản của bạn dựa trên thông tin tổ chức bạn đã gửi; nếu tổ chức đã tồn tại thì sử dụng thông tin liên kết của tổ chức hiện có, nếu chưa tồn tại chúng tôi sẽ lưu thành tổ chức mới. Khi giá trị là 0, không lưu thông tin tổ chức. |
| duplicateOrgCheck | Int | N | Giá trị là 0 hoặc 1. Tham số này hiện chỉ liên quan đến chứng chỉ SSL Digicert. Dùng để xác định có tái sử dụng thông tin tổ chức và tên miền đã xác thực trước đó hay không. Khi giá trị là 1, tái sử dụng. Khi giá trị là 0, tạo mới. Mặc định là 1. |
| dcvMethod | String | N | Thống nhất thiết lập phương thức xác thực tên miền khi đăng ký. Phải là một trong bốn phương thức sau: EMAIL (xác thực qua email) HTTP_CSR_HASH (xác thực qua tệp) CNAME_CSR_HASH (xác thực qua DNS) HTTPS_CSR_HASH (xác thực qua tệp https) VERIFY_DOCUMENT (chứng minh chứng chỉ tên miền, chỉ hỗ trợ CFCA) CFCA mục này là Y |
| domainInfo | String | N | Thông tin tên miền, chỉ liên quan đến chứng chỉ SSL. Tham số chứng chỉ SSL là Y, tham số loại khác là N. Tổng số tên miền tiêu chuẩn và tổng số tên miền wildcard không được vượt quá tổng số tên miền tiêu chuẩn và tổng số tên miền wildcard đã mua. Ví dụ: [ { "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" } ] Mô tả chi tiết như sau: |
| dcvMethod | String | N | Phương thức xác thực tên miền. Phải là một trong bốn phương thức sau: EMAIL(xác thực qua email) HTTP_CSR_HASH(xác thực qua tệp) CNAME_CSR_HASH(xác thực DNS) HTTPS_CSR_HASH(xác thực tệp https) Khi dcvMethod cấp trên không tồn tại, mục này là Y. Khi dcvMethod cấp trên tồn tại và mục này cũng tồn tại, sẽ ưu tiên sử dụng dcvMethod cấp trên |
| dcvEmail | String | N | Email xác thực tên miền. Khi mục này là N, các giá trị mặc định như sau racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com |
| domainName | String | N | Tên miền |
| organizationInfo | String | N | Thông tin công ty. Khi đặt mua sản phẩm cần xác thực doanh nghiệp, tham số này là Y. Ví dụ như sau: { "organizationCity": "Thượng Hải", "organizationName": "Công ty nào đó", "organizationMobile": "18111111111", "organizationAddress": "Đường Thượng Hải", "organizationCountry": "CN", "organizationPostCode": "401320" }" |
| organizationCity | String | N | Thành phố nơi công ty đặt trụ sở. |
| organizationName | String | N | Tên công ty. |
| organizationMobile | String | N | Số điện thoại công ty. |
| organizationAddress | String | N | Địa chỉ công ty. |
| organizationCountry | String | N | Quốc gia nơi công ty đặt trụ sở (mã hai chữ cái theo tiêu chuẩn ISO 3166-1). |
| organizationPostCode | String | N | Mã bưu chính nơi công ty đặt trụ sở. |
| organizationRegNumbe | String | N | Số giấy tờ công ty. Đối với CFCA, mục này là Y. |
| idType | String | N | Loại giấy tờ công ty. CFCA điền Y cho mục này. Giá trị như sau: TYDMZ: Mã thống nhất tín dụng xã hội OTHERS: Khác |
| Administrator | String | Y | Thông tin quản trị viên, người liên hệ. Khi đăng ký chứng thư ký mã, chữ ký email, chữ ký tài liệu, tham số này được dùng làm thông tin đăng ký. Ngoài ra, nếu csr là N, thông tin này được dùng làm thông tin tạo csr. { "job": "总经办", "city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }" |
| job | String | Y | Chức vụ quản trị viên. |
| city | String | Y | Thành phố nơi quản trị viên cư trú. |
| String | Y | Email của quản trị viên. | |
| state | String | Y | Tỉnh hoặc bang nơi quản trị viên cư trú. |
| mobile | String | Y | Thông tin liên hệ của quản trị viên. |
| address | String | Y | Địa chỉ liên hệ của quản trị viên. |
| country | String | Y | Quốc gia của quản trị viên (mã hai chữ cái theo tiêu chuẩn ISO 3166-1). |
| lastName | String | Y | Họ của quản trị viên. |
| postCode | String | Y | Mã bưu chính nơi quản trị viên cư trú. |
| firstName | String | Y | Tên của quản trị viên. |
| organation | String | Y | Tên công ty của quản trị viên. |
| idType | String | N | Loại giấy tờ. Đối với CFCA, mục này là Y. Các giá trị như sau: SFZ：Chứng minh nhân dân HZ：Hộ chiếu |
| idNumber | String | N | Số giấy tờ. Đối với CFCA, mục này là Y. |
| finance | String | Chỉ liên quan đến chứng chỉ SSL. Thông tin nhân viên tài chính. Có thể trùng với thông tin quản trị viên. Khi sản phẩm đặt mua không thuộc loại DV, tham số này là Y. { "job": "Phòng Tài chính", "city": "Thượng Hải", "email": "xx@yy.com", "state": "Thượng Hải", "mobile": "18111111111", "address": "Thượng Hải", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "Công ty nào đó" }" | |
| job | String | N | Chức vụ của nhân viên tài chính. |
| city | String | N | Thành phố nơi nhân viên tài chính cư trú. |
| String | N | Email của nhân viên tài chính. | |
| state | String | N | Tỉnh hoặc bang nơi nhân viên tài chính cư trú. |
| mobile | String | N | Thông tin liên hệ của nhân viên tài chính. |
| address | String | N | Địa chỉ liên hệ của nhân viên tài chính. |
| country | String | N | Quốc gia nơi nhân viên tài chính cư trú ( mã hai chữ cái theo tiêu chuẩn ISO 3166-1). |
| lastName | String | N | Họ của nhân viên tài chính. |
| postCode | String | N | Mã bưu chính nơi nhân viên tài chính cư trú. |
| firstName | String | N | Tên của nhân viên tài chính. |
| organation | String | N | Công ty nơi nhân viên tài chính làm việc. |
| idType | String | N | Loại giấy tờ. Đối với CFCA, mục này là Y. Các giá trị như sau: SFZ: Chứng minh nhân dân HZ: Hộ chiếu |
| idNumber | String | N | Số giấy tờ. Đối với CFCA, mục này là Y. |
| tech | String | N | Chỉ liên quan đến chứng chỉ SSL. Thông tin kỹ thuật viên. Khi sản phẩm được đặt không thuộc loại dv, tham số này là Y. { "job": "技术部","city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }" |
| job | String | N | Chức vụ của kỹ thuật viên. |
| city | String | N | Thành phố nơi kỹ thuật viên làm việc. |
| String | N | Email của kỹ thuật viên. | |
| state | String | N | Tỉnh hoặc bang nơi kỹ thuật viên cư trú. |
| mobile | String | N | Thông tin liên hệ của kỹ thuật viên. |
| address | String | N | Địa chỉ liên hệ của kỹ thuật viên. |
| country | String | N | Quốc gia của kỹ thuật viên (mã hai chữ cái theo tiêu chuẩn ISO 3166-1). |
| lastName | String | N | Họ của kỹ thuật viên. |
| postCode | String | N | Mã bưu chính nơi kỹ thuật viên làm việc. |
| firstName | String | N | Tên kỹ thuật viên. |
| organation | String | N | Công ty của kỹ thuật viên. |
| idType | String | N | Loại giấy tờ. Mục này là Y đối với CFCA. Các giá trị như sau: SFZ：Chứng minh nhân dân HZ：Hộ chiếu |
| idNumber | String | N | Số giấy tờ. Mục này là Y đối với CFCA. |
Giá trị trả về của hàm
| code | Int | Y | Trạng thái trả về, chi tiết xem Phụ lục 3.1 |
|---|---|---|---|
| errors | Object or String | N | Khi trạng thái trả về là lỗi, thông tin lỗi cụ thể. |
| data | Object | N | Khi trạng thái trả về là thành công, tham số này là Y. Mô tả cụ thể như sau: |
| certId | String | N | ID chứng chỉ racent. Vui lòng lưu giữ cẩn thận, tham số này là chứng từ duy nhất của phiên bản racent. |
| vendorId | String | N | Số đơn hàng CA. |
| vendorCertId | String | N | Số chứng chỉ CA. |
| DCVfileName | String | N | Tên tệp xác thực tệp |
| DCVfileContent | String | N | Nội dung tệp xác thực tệp |
| DCVdnsHost | String | N | Giá trị máy chủ xác thực Dns |
| DCVdnsValue | String | N | Giá trị bản ghi xác thực Dns |
| DCVdnsType | String | N | Loại bản ghi xác thực Dns |
| DCVfilePath | String | N | Đường dẫn tệp xác thực tệp |
| dcvInfo | Object | N | Khi giá trị xác thực của từng tên miền trong chứng chỉ đang đăng ký khác nhau, mục này là Y Mỗi mục có kiểu Object, tên đối tượng của mỗi mục là tên miền đã đăng ký, ví dụ: racent.com. Chi tiết từng mục như sau: |
| DCVfileName | String | N | Nội dung tệp xác thực tệp |
| DCVfileContent | String | N | Nội dung tệp xác thực tệp |
| DCVdnsHost | String | N | Giá trị máy chủ xác thực Dns |
| DCVdnsValue | String | N | Giá trị bản ghi xác thực Dns |
| DCVdnsType | String | N | Loại bản ghi xác thực Dns |
| DCVfilePath | String | N | Đường dẫn tệp xác thực tệp |
| failReason | Object | N | Khi Racent không thể nộp đơn xin chứng chỉ lên CA và xác định rõ nguyên nhân thất bại, mục này sẽ được trả về. |
| dataReasons | Array | N | Nguyên nhân dữ liệu |
| key | String | N | Mục |
| reason | String | N | Nguyên nhân |
| sysReason | String | N | Nguyên nhân hệ thống |