2.2 Sertifika Siparişi
2.2.1 Arayüz Açıklaması
| Test Ortamı | |
|---|---|
| Canlı Ortam | https://portal.racent.com/ssl/place |
| İstek Yöntemi | POST |
| content-type | multipart/form-data |
| Açıklama | Bu arayüz sertifika siparişi vermek için kullanılır. |
2.2.2 Parametre Tanımları
| Parametre Adı | Parametre Türü | Zorunlu | Açıklama |
|---|---|---|---|
| api_token | String | Y | Kimlik bilgisi, token oluşturmak için lütfen Racent teknik desteğiyle iletişime geçin. |
| productCode | String | Y | Ürün kodu, ürün kodunu alma (bkz. 2.7) |
| years | Int | Y | Satın alma süresi (şu anda yalnızca 1, 2, 3, 4, 5 desteklenmektedir), belirli ürüne bağlıdır. |
| refId | String | N | Müşteri tarafından sağlanan benzersiz müşteri sipariş numarası |
| verificationPic | File | N | Yedek doğrulama materyali. Kuruluş doğrulaması için kullanılır; .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf biçimlerini destekler, içerik 2M'ı aşamaz. |
| domainVerificationPic | File | N | Alan adı doğrulama yöntemi VERIFY_DOCUMENT olduğunda bu öğe Y'dir. Alan adı sahipliği doğrulaması için kullanılır (şu anda yalnızca CFCA desteklenmektedir). |
| params | String | Y | Sipariş bilgisi, ayrıntılı açıklama aşağıdaki gibidir |
| csr | String | N | Parametre boş olduğunda sizin için CSR oluşturulur ve özel anahtar saklanır. |
| privateKey | String | N | Özel anahtar. |
| server | String | N | Sunucu. Yalnızca SSL sertifikalarıyla ilgilidir. SSL sertifikası parametresi Y, diğer ürün türleri için parametre N'dir. Bu parametre gerekmiyorsa varsayılan olarak "other" kullanın. |
| orgCheck | Int | N | Değer 0 veya 1'dir. Değer 1 olduğunda, gönderdiğiniz kuruluş bilgilerine göre hesabınızdaki tüm kuruluşlar taranır; kuruluş mevcutsa mevcut kuruluşun ilişkili bilgileri kullanılır, mevcut değilse yeni kuruluş olarak kaydederiz. Değer 0 olduğunda, kuruluş bilgileri kaydedilmez. |
| duplicateOrgCheck | Int | N | Değer 0 veya 1'dir. Bu parametre şu anda yalnızca Digicert SSL sertifikalarıyla ilgilidir. Daha önce doğrulanmış kuruluş ve alan adı bilgilerinin yeniden kullanılıp kullanılmayacağını belirlemek için kullanılır. Değer 1 olduğunda yeniden kullanılır. Değer 0 olduğunda yeni oluşturulur. Varsayılan 1'dir. |
| needFree | Int | N | Değer 1 veya 2'dir. Değer 1 olduğunda FQDN hediye edilir, aynı zamanda www.domain için de domain hediye edilir. Değer 2 olduğunda hediye edilmez. |
| uniqueValue | String | N | Yalnızca Sectigo ürünleriyle ilgilidir. Bayilerin kendi doğrulama değerlerini üretmeleri için 1-20 karakter (a-z A-Z 0-9) kullanılır. |
| dcvMethod | String | N | Başvurulan alan adı doğrulama yöntemini birleşik olarak ayarlar. Aşağıdaki dört yöntemden biri olmalıdır: EMAIL(E-posta doğrulaması) HTTP_CSR_HASH(Dosya doğrulaması) CNAME_CSR_HASH(DNS doğrulaması) HTTPS_CSR_HASH(HTTPS dosya doğrulaması) VERIFY_DOCUMENT(Alan adı sertifika kanıtı, yalnızca CFCA'yı destekler) CFCA için bu öğe Y'dir |
| domainInfo | String | N | Alan adı bilgisi, yalnızca SSL sertifikasıyla ilgilidir. SSL sertifikası parametresi Y, diğer tür parametreleri N'dir. Örnek: [ { "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" } ] Ayrıntılı açıklama aşağıdaki gibidir: |
| dcvMethod | String | N | Alan adı doğrulama yöntemi. Aşağıdaki dört yöntemden biri olmalıdır: EMAIL(e-posta doğrulama) HTTP_CSR_HASH(dosya doğrulama) CNAME_CSR_HASH(DNS doğrulama) HTTPS_CSR_HASH(https dosya doğrulama) Üst düzey dcvMethod mevcut olmadığında bu alan Y olur. Üst düzey dcvMethod mevcut olduğunda ve bu alan da mevcutsa, üst düzey dcvMethod öncelikli olarak kullanılır |
| dcvEmail | String | N | Alan adı doğrulama e-postası. Bu alan N olduğunda varsayılan durum aşağıdaki gibidir racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com |
| domainName | String | N | Alan adı |
| organizationInfo | String | N | Şirket bilgileri. Kurumsal doğrulama gerektiren bir ürün sipariş edildiğinde bu parametre Y olur. Örnek aşağıdaki gibidir: { "organizationCity": "Şanghay", "organizationName": "某公司", "organizationMobile": "18111111111", "organizationAddress": "上海市路", "organizationCountry": "CN", "organizationPostCode": "401320" }" |
| organizationCity | String | N | Şirketin bulunduğu şehir. |
| organizationName | String | N | Şirket adı. |
| organizationMobile | String | N | Şirket telefonu. |
| organizationAddress | String | N | Şirket adresi. |
| organizationCountry | String | N | Şirketin bulunduğu ülke (ISO 3166-1 standardındaki iki harfli kod). |
| organizationPostCode | String | N | Şirketin bulunduğu yerin posta kodu. |
| organizationRegNumbe | String | N | Şirket belge numarası. CFCA için bu alan Y'dir. |
| idType | String | N | Şirket belge türü. CFCA için bu alan Y'dir. Değerler aşağıdaki gibidir: TYDMZ: Birleşik Sosyal Kredi Kodu OTHERS: Diğer |
| Administrator | string | Y | Yönetici bilgileri, ilgili kişi. Kod imzalama, e-posta imzalama veya belge imzalama başvurusu yapılırken bu parametre başvuru bilgisi olarak kullanılır. Ayrıca csr N ise, bu bilgi csr oluşturma bilgisi olarak kullanılır. { "job": "Genel Müdürlük Ofisi", "city": "Şanghay", "email": "xx@yy.com", "state": "Şanghay", "mobile": "18111111111", "address": "Şanghay", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "Belirli Bir Şirket" }" |
| job | String | E | Yönetici pozisyonu. |
| city | String | E | Yöneticinin bulunduğu şehir. |
| String | E | Yöneticinin e-posta adresi. | |
| state | String | Y | Yöneticinin bulunduğu il veya eyalet. |
| mobile | String | Y | Yönetici iletişim bilgileri. |
| address | String | Y | Yönetici iletişim adresi. |
| country | String | E | Yöneticinin bulunduğu ülke (ISO 3166-1 standardındaki iki harfli kod). |
| lastName | String | E | Yöneticinin soyadı. |
| postCode | String | E | Yöneticinin bulunduğu yerin posta kodu. |
| firstName | String | E | Yönetici adı. |
| organation | String | E | Yönetici şirket adı. |
| idType | String | H | Kimlik belgesi türü. CFCA için bu alan E'dir. |
| idNumber | String | N | Belge numarası. CFCA için bu alan Y'dir. |
| finance | string | Yalnızca SSL sertifikalarıyla ilgilidir. Finans personeli bilgileri. Yönetici bilgileriyle aynı olabilir. Sipariş edilen ürün dv türünde olmadığında, bu parametre Y'dir. { "job": "Finans Departmanı", "city": "Şanghay", "email": "xx@yy.com", "state": "Şanghay", "mobile": "18111111111", "address": "Şanghay", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }" | |
| job | String | N | Finans personelinin görevi. |
| city | String | N | Mali işler sorumlusunun bulunduğu şehir. |
| String | N | Mali işler sorumlusunun e-posta adresi. | |
| state | String | N | Mali işler sorumlusunun bulunduğu il veya eyalet. |
| mobile | String | N | Mali işler sorumlusunun iletişim telefonu. |
| address | String | N | Mali işler sorumlusunun iletişim adresi. |
| country | String | N | Mali işler sorumlusunun bulunduğu ülke (ISO 3166-1 standardındaki iki harfli kod). |
| lastName | String | N | Finans görevlisinin soyadı. |
| postCode | String | N | Finans görevlisinin bulunduğu yerin posta kodu. |
| firstName | String | N | Finans görevlisinin adı. |
| organation | String | N | Finans görevlisinin bağlı olduğu şirket. |
| idType | String | N | Belge türü. CFCA için bu alan Y'dir. Değerler aşağıdaki gibidir: SFZ: Kimlik kartı HZ: Pasaport |
| idNumber | String | N | Belge numarası. CFCA için bu alan Y'dir. |
| tech | string | N | Yalnızca SSL sertifikasıyla ilgilidir. Teknik personel bilgileri. Sipariş edilen ürün dv türünde olmadığında bu parametre Y olur. { "job": "Teknik Departman","city": "Şanghay", "email": "xx@yy.com", "state": "Şanghay", "mobile": "18111111111", "address": "Şanghay", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }" |
| job | String | N | Teknik personelin görevi. |
| city | String | N | Teknik personelin bulunduğu şehir. |
| String | N | Teknisyenin e-posta adresi. | |
| state | String | N | Teknisyenin bulunduğu il veya eyalet. |
| mobile | String | N | Teknisyenin iletişim bilgileri. |
| address | String | N | Teknisyenin iletişim adresi. |
| country | String | N | Teknisyenin bulunduğu ülke (ISO 3166-1 standardındaki iki harfli kod). |
| lastName | String | N | Teknisyenin soyadı. |
| postCode | String | N | Teknisyenin bulunduğu yerin posta kodu. |
| firstName | String | N | Teknisyenin adı. |
| organation | String | N | Teknisyenin çalıştığı şirket. |
| idType | String | N | Kimlik türü. CFCA için bu alan Y'dir. Değerler aşağıdaki gibidir: SFZ: Kimlik kartı HZ: Pasaport |
| idNumber | String | N | Kimlik numarası. CFCA için bu alan Y'dir. |
Fonksiyon dönüşü
| Parametre adı | Parametre türü | Zorunlu | Açıklama |
|---|---|---|---|
| code | Int | Y | Dönüş durumu. Ayrıntılı açıklama için Ek 3.1'e bakın |
| errors | Object or String | N | Dönüş durumu hata olduğunda, belirli hata bilgisi. |
| data | Object | N | Dönüş durumu başarılı olduğunda, bu parametre Y olur. Belirli açıklama aşağıdaki gibidir: |
| certId | String | N | racent sertifika kimliği. Lütfen iyi saklayın; bu parametre racent örneğinin tek kimliğidir. |
| failReason | Object | N | Racent, CA'ya sertifika başvurusunda başarısız olduğunda ve başarısızlık nedeni netleştiğinde bu öğe döndürülür. |
| dataReasons | Array | N | Veri nedenleri |
| key | String | N | Öğe |
| reason | String | N | Neden |
| sysReason | String | N | Sistem nedeni |
| vendorId | String | N | CA sipariş numarası. |
| vendorCertId | String | N | CA sertifika numarası. |
| DCVfileName | String | N | Dosya doğrulama dosya adı |
| DCVfileContent | String | N | Dosya doğrulama dosya içeriği |
| DCVdnsHost | String | N | DNS doğrulama ana bilgisayar değeri |
| DCVdnsValue | String | N | DNS doğrulama kayıt değeri |
| DCVdnsType | String | N | DNS doğrulama kayıt türü |
| DCVfilePath | String | N | Dosya doğrulama dosya yolu |
| dcvInfo | Object | N | Sertifika başvurusundaki her alan adının doğrulama değeri farklı olduğunda bu öğe Y'dir Her öğenin türü Object'tir; her öğenin nesne adı başvurulan alan adıdır, örn: racent.com. Her öğenin ayrıntıları aşağıdaki gibidir: |
| DCVfileName | String | N | Dosya doğrulama dosya içeriği |
| DCVfileContent | String | N | Dosya doğrulama dosyası içeriği |
| DCVdnsHost | String | N | DNS doğrulama ana bilgisayar değeri |
| DCVdnsValue | String | N | DNS doğrulama kayıt değeri |
| DCVdnsType | String | N | DNS doğrulama kayıt türü |
| DCVfilePath | String | N | Dosya doğrulama dosya yolu |