Заказать GeoTrust DV SSL

POST
https://www.digicert.com/services/v2/order/certificate/ssl_dv_geotrust_flex

Используйте эту конечную точку для запроса сертификата GeoTrust DV SSL.

Этот более гибкий сертификат GeoTrust DV SSL упрощает процесс получения сертификата GeoTrust DV, соответствующего вашим требованиям. Данный сертификат заменяет продукты GeoTrust Standard DV, GeoTrust Cloud DV и GeoTrust Wildcard DV.

cURL
curl -X POST \
  'https://www.digicert.com/services/v2/order/certificate/ssl_dv_geotrust_flex' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "certificate": {
        "common_name": "example.com",
        "dns_names": [
        	"sub.example.com",
        	"log.example.com"
        ],
        "csr": "<csr>",
        "server_platform": {
            "id": 2
        }
    },
    "custom_expiration_date": "",
    "comments": "Message for the approver.",
    "container": {
        "id": 69748
    },
    "custom_renewal_message": "Renew me.",
    "skip_approval": true,
    "disable_ct": 0,
    "validity_years": 1,
    "custom_fields": [
        {
            "metadata_id": 12,
            "value": "Invoice #12345"
        }
    ],
    "payment_method": "balance",
    "dcv_method": "email",
    "dcv_emails": [
    	{
    		"dns_name": "example.com",
    		"email_domain": "example.com",
    		"email": "admin@example.com"
    	},
    	{
    		"dns_name": "sub.example.com",
    		"email_domain": "example.com",
    		"email": "jim.smith@example.com"
    	},
    	{
    		"dns_name": "log.example.com",
    		"email_domain": "example.com",
    		"email": "it@example.com"
    	}
    ],
    "locale": "en",
    "technical_contact": {
        "first_name": "Jim",
        "last_name": "Smith",
        "telephone": "555-555-5555",
        "job_title": "IT Admin",
        "email": "jim.smith@example.com"
    }
}'
Python
import requests

url = "https://www.digicert.com/services/v2/order/certificate/ssl_dv_geotrust_flex"

payload = "{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n        \"dns_names\": [\n        \t\"sub.example.com\",\n        \t\"log.example.com\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 2\n        }\n    },\n    \"custom_expiration_date\": \"\",\n    \"comments\": \"Message for the approver.\",\n    \"container\": {\n        \"id\": 69748\n    },\n    \"custom_renewal_message\": \"Renew me.\",\n    \"skip_approval\": true,\n    \"disable_ct\": 0,\n    \"validity_years\": 1,\n    \"custom_fields\": [\n        {\n            \"metadata_id\": 12,\n            \"value\": \"Invoice #12345\"\n        }\n    ],\n    \"payment_method\": \"balance\",\n    \"dcv_method\": \"email\",\n    \"dcv_emails\": [\n    \t{\n    \t\t\"dns_name\": \"example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"admin@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"sub.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"jim.smith@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"log.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"it@example.com\"\n    \t}\n    ],\n    \"locale\": \"en\",\n    \"technical_contact\": {\n        \"first_name\": \"Jim\",\n        \"last_name\": \"Smith\",\n        \"telephone\": \"555-555-5555\",\n        \"job_title\": \"IT Admin\",\n        \"email\": \"jim.smith@example.com\"\n    }\n}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)
Go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://www.digicert.com/services/v2/order/certificate/ssl_dv_geotrust_flex"

	payload := strings.NewReader("{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n        \"dns_names\": [\n        \t\"sub.example.com\",\n        \t\"log.example.com\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 2\n        }\n    },\n    \"custom_expiration_date\": \"\",\n    \"comments\": \"Message for the approver.\",\n    \"container\": {\n        \"id\": 69748\n    },\n    \"custom_renewal_message\": \"Renew me.\",\n    \"skip_approval\": true,\n    \"disable_ct\": 0,\n    \"validity_years\": 1,\n    \"custom_fields\": [\n        {\n            \"metadata_id\": 12,\n            \"value\": \"Invoice #12345\"\n        }\n    ],\n    \"payment_method\": \"balance\",\n    \"dcv_method\": \"email\",\n    \"dcv_emails\": [\n    \t{\n    \t\t\"dns_name\": \"example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"admin@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"sub.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"jim.smith@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"log.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"it@example.com\"\n    \t}\n    ],\n    \"locale\": \"en\",\n    \"technical_contact\": {\n        \"first_name\": \"Jim\",\n        \"last_name\": \"Smith\",\n        \"telephone\": \"555-555-5555\",\n        \"job_title\": \"IT Admin\",\n        \"email\": \"jim.smith@example.com\"\n    }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
NodeJS
var request = require("request");

var options = { method: 'POST',
  url: 'https://www.digicert.com/services/v2/order/certificate/ssl_dv_geotrust_flex',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { certificate: 
      { common_name: 'example.com',
        dns_names: [ 'sub.example.com', 'log.example.com' ],
        csr: '<csr>',
        server_platform: { id: 2 } },
     custom_expiration_date: '',
     comments: 'Message for the approver.',
     container: { id: 69748 },
     custom_renewal_message: 'Renew me.',
     skip_approval: true,
     disable_ct: 0,
     validity_years: 1,
     custom_fields: [ { metadata_id: 12, value: 'Invoice #12345' } ],
     payment_method: 'balance',
     dcv_method: 'email',
     dcv_emails: 
      [ { dns_name: 'example.com',
          email_domain: 'example.com',
          email: 'admin@example.com' },
        { dns_name: 'sub.example.com',
          email_domain: 'example.com',
          email: 'jim.smith@example.com' },
        { dns_name: 'log.example.com',
          email_domain: 'example.com',
          email: 'it@example.com' } ],
     locale: 'en',
     technical_contact: 
      { first_name: 'Jim',
        last_name: 'Smith',
        telephone: '555-555-5555',
        job_title: 'IT Admin',
        email: 'jim.smith@example.com' } },
  json: true };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
201 201 Created (email)
{
  "id": 6484932,
  "certificate_id": 6079436
}
201 201 Created (dns-txt-toke or http-token)
{
  "id": 6484932,
  "certificate_id": 6079436
  "dcv_random_value": "icru1984rnekfj"
}

Параметры запроса

Информация о допустимых значениях для полей сертификата содержится в разделе Публичные доверенные сертификаты – Элементы данных, нарушающие отраслевые стандарты.

Имя Обязательный/Необязательный Тип Описание
certificate обязательный object Подробные сведения о сертификате.
.. common_name обязательный string Защищаемый домен.
.. dns_names необязательный array Дополнительные защищаемые домены.
Может привести к дополнительным расходам. (См. раздел  Установившаяся практика — Получение обеих версий домена бесплатно.)
.. csr обязательный* string Запрос на подпись сертификата (CSR).
.. organization_units необязательный array Отдел в вашей организации, для которого предназначен сертификат.
.. server_platform необязательный object Тип серверной платформы.
По умолчанию: -1 (прочие)
.. .. id обязательный int Идентификатор серверной платформы.
См. раздел  Словарь – Серверные платформы.
renewed_thumbprint необязательный string Если заказ является заказом на продление срока действия, введите отпечаток SHA-1 первичного сертификата по предыдущему заказу.
validity_years обязательный int Срок действия сертификата в годах.
Можно заменить  validity_days или custom_expiration_date.
Допустимые значения: 12.
validity_days необязательный int Срок действия сертификата в днях после его выпуска.
Отменяет validity_years.
custom_expiration_date необязательный string Настраиваемая дата окончания срока действия сертификата.
Срок не должен превышать 825 дней.
Отменяет validity_days и validity_years
Формат: yyyy-MM-dd
comments необязательный string Комментарии о заказе для утверждающего лица.
auto_renew необязательный int Укажите, следует ли автоматически продлевать срок действия сертификата.
По умолчанию: 0
Допустимые значения: 0 (запрещено), 1 (разрешено)
custom_renewal_message необязательный string Настраиваемое сообщение, включаемое в уведомления о продлении срока действия.
disable_renewal_notifications необязательный bool Укажите, следует ли отключить отправку по электронной почте уведомлений о продлении срока действия.
По умолчанию: false
additional_emails необязательный array Дополнительные адреса электронной почты, предназначенные для получения уведомлений (например, о выпуске сертификата, дублировании сертификата, продлениях срока действия сертификата и т. д.).
renewal_of_order_id необязательный int Если заказ является заказом на продление срока действия, введите идентификатор предыдущего заказа.
payment_method необязательный string Укажите используемый способ оплаты.
Допустимые значения: balancecardprofile
По умолчанию: balance
dcv_method обязательный string Используемый метод DCV для подтверждения полномочий управления доменом.
См. раздел  Словарь – Методы DCV.
dcv_emails необязательный array Список с указанием области электронной почты при отправке электронной почты DCV.
Можно добавить запись для каждого DNS-имени, защищенного сертификатом.
.. dns_name обязательный string DNS-имя в сертификате, к которому должна применяться эта область.
.. email_domain обязательный string Запись домена WHOIS, используемая для проверки адресов электронной почты.
Данное значение должно соответствовать dns_names базовому домену.
.. email необязательный string Адрес электронной почты, используемый при отправке писем DCV.
Данный адрес электронной почты должен появиться в записи WHOIS для домена, указанного в параметре email_domain .
locale необязательный string Язык, используемый в электронной почте DCV.
См. раздел  Словарь – Коды региональной настройки.
skip_approval необязательный bool Укажите, следует ли пропустить этап утверждения заказа, немедленно предоставить его для подтверждения действительности и выпустить после завершения процедуры проверки.
По умолчанию: false
disable_ct необязательный bool Укажите, следует ли отключить ведение журналов CT для сертификата.
Ведение журналов CT для конкретного заказа должно быть включено, иначе настройка будет проигнорирована.
См. раздел  Разрешить пользователям не регистрировать сертификаты в журналах CT.
По умолчанию: false
container необязательный object При необходимости укажите контейнер, в которым следует разместить заказ.
.. id обязательный int Идентификатор контейнера.
custom_fields необязательный* array Настраиваемые поля для определенной учетной записи.
*Являются ли данные поля обязательными, зависит от настроек пользовательских полей.
.. metadata_id обязательный int Идентификатор настраиваемого поля.
.. value обязательный string Значение для настраиваемого поля.
Тип подтверждения действительности данных зависит от настроек пользовательских полей.
technical_contact необязательный object Подробные сведения о контактном лице по техническим вопросам.
.. first_name обязательный string
.. last_name обязательный string
.. telephone обязательный string
.. job_title необязательный string
.. email обязательный string

Параметры ответного сообщения

Имя Тип Описание
id int Идентификатор заказа.
certificate_id int Идентификатор сертификата.
dcv_random_value string Произвольное значение, используемое для подтверждения полномочий управления доменом.
Указывается в ответе только при использовании dns-txt-token или http-token в качестве метода DCV.