На этой странице содержится описание продуктов с названием группы ssl_certificate
(см. Словарь – Идентификаторы продуктов).
Используйте эту конечную точку для отправки заявки на сертификат OV/EV, используя ssl_plus
, ssl_multi_domain
, ssl_wildcard
, ssl_ev_plus
, ssl_ev_multi_domain
, или ssl_cloud_wildcard
в качестве ssl_certificate_id.
curl -X POST \
'https://www.digicert.com/services/v2/order/certificate/{{ssl_certificate_id}}' \
-H 'Content-Type: application/json' \
-H 'X-DC-DEVKEY: {{api_key}}' \
-d '{
"certificate": {
"common_name": "example.com",
"dns_names": [
"sub.example.com",
"app.example.com"
],
"csr": "<csr>",
"server_platform": {
"id": 45
},
"signature_hash": "sha256",
"organization_units": [
"Accounting department"
]
},
"validity_years": 2,
"comments": "Message for the approver",
"disable_renewal_notifications": true,
"locale": "en",
"payment_method": "balance",
"skip_approval": true,
"organization": {
"id": 123456
},
"custom_fields": [
{
"metadata_id": 11,
"value": "Invoice #00001"
}
]
}'
import requests
url = "https://www.digicert.com/services/v2/order/certificate/{{ssl_certificate_id}}"
payload = "{\n \"certificate\": {\n \"common_name\": \"example.com\",\n \"dns_names\": [\n \"sub.example.com\",\n \"app.example.com\"\n ],\n \"csr\": \"<csr>\",\n \"server_platform\": {\n \"id\": 45\n },\n \"signature_hash\": \"sha256\",\n \"organization_units\": [\n \"Accounting department\"\n ]\n },\n \"validity_years\": 2,\n \"comments\": \"Message for the approver\",\n \"disable_renewal_notifications\": true,\n \"locale\": \"en\",\n \"payment_method\": \"balance\",\n \"skip_approval\": true,\n \"organization\": {\n \"id\": 123456\n },\n \"custom_fields\": [\n {\n \"metadata_id\": 11,\n \"value\": \"Invoice #00001\"\n }\n ]\n}"
headers = {
'X-DC-DEVKEY': "{{api_key}}",
'Content-Type': "application/json"
}
response = requests.request("POST", url, data=payload, headers=headers)
print(response.text)
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://www.digicert.com/services/v2/order/certificate/{{ssl_certificate_id}}"
payload := strings.NewReader("{\n \"certificate\": {\n \"common_name\": \"example.com\",\n \"dns_names\": [\n \"sub.example.com\",\n \"app.example.com\"\n ],\n \"csr\": \"<csr>\",\n \"server_platform\": {\n \"id\": 45\n },\n \"signature_hash\": \"sha256\",\n \"organization_units\": [\n \"Accounting department\"\n ]\n },\n \"validity_years\": 2,\n \"comments\": \"Message for the approver\",\n \"disable_renewal_notifications\": true,\n \"locale\": \"en\",\n \"payment_method\": \"balance\",\n \"skip_approval\": true,\n \"organization\": {\n \"id\": 123456\n },\n \"custom_fields\": [\n {\n \"metadata_id\": 11,\n \"value\": \"Invoice #00001\"\n }\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))
}
var request = require("request");
var options = { method: 'POST',
url: 'https://www.digicert.com/services/v2/order/certificate/{{ssl_certificate_id}}',
headers:
{ 'Content-Type': 'application/json',
'X-DC-DEVKEY': '{{api_key}}' },
body:
{ certificate:
{ common_name: 'example.com',
dns_names: [ 'sub.example.com', 'app.example.com' ],
csr: '<csr>',
server_platform: { id: 45 },
signature_hash: 'sha256',
organization_units: [ 'Accounting department' ] },
validity_years: 2,
comments: 'Message for the approver',
disable_renewal_notifications: true,
locale: 'en',
payment_method: 'balance',
skip_approval: true,
organization: { id: 123456 },
custom_fields: [ { metadata_id: 11, value: 'Invoice #00001' } ] },
json: true };
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
{
"id": 112233,
"requests": [
{
"id": 113,
"status": "pending"
}
]
}
{
"id": 112233,
"requests": [
{
"id": 113,
"status": "submitted"
}
]
}
{
"id": 112233,
"requests": [
{
"id": 113,
"status": "approved"
}
],
"certificate_id": 113
}
{
"id": 112233,
"certificate_id": 113
}
{
"id": 112233,
"certificate_id": 113,
"certificate_chain": [
{
"subject_common_name": "example.com",
"pem": "<pem_certificate>"
},
{
"subject_common_name": "DigiCert SHA2 Secure Server CA",
"pem": "<pem_certificate>"
},
{
"subject_common_name": "DigiCert Global Root CA",
"pem": "<pem_certificate>"
}
]
}
Для ознакомления с информацией о допустимых значениях для полей сертификата см. Публичные доверенные сертификаты – Элементы данных, нарушающие отраслевые стандарты.
Имя | Обязательный/Необязательный | Тип | Описание |
---|---|---|---|
certificate | обязательный | object | Подробные сведения о сертификате. |
.. common_name | обязательный | string | Защищаемый домен. |
.. dns_names | необязательный | array |
Дополнительные защищаемые домены. Может привести к дополнительным расходам. (См. Установившаяся практика — Получение обеих версий домена бесплатно.) |
.. csr | обязательный | string | Запрос на подпись сертификата (CSR). |
.. signature_hash | обязательный | string |
Алгоритм хэширования, используемый для подписывания сертификата. Сертификаты SSL/TLS поддерживают только SHA-256. |
.. organization_units | необязательный | array | Отдел в вашей организации, для которого предназначен сертификат. |
.. server_platform | необязательный | object |
Тип серверной платформы. По умолчанию: -1 (прочее)
|
.. .. id | обязательный | int |
Идентификатор серверной платформы. См. Словарь — Серверные платформы |
.. profile_option | необязательный | string | При использовании настраиваемых профилей сертификатов укажите имя профиля. |
renewed_thumbprint | необязательный | string | Если заказ является заказом на продление, введите отпечаток SHA-1 первичного сертификата по предыдущему заказу. |
validity_years | обязательный | int |
Срок действия сертификата в годах. Может быть заменен на validity_days или custom_expiration_date .Допустимые значения: 1 , 2
|
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 |
Укажите используемый способ оплаты. Допустимые значения: balance , card , profile По умолчанию: balance
|
dcv_method | необязательный | string |
Используемый метод DCV для подтверждения полномочий управления доменом. См. Словарь — Методы DCV |
skip_approval | необязательный | bool |
Укажите, следует ли пропустить этап утверждения заказа, немедленно предоставить его для подтверждения действительности и выпустить после завершения процедуры проверки. По умолчанию: false
|
disable_ct | необязательный | bool |
Укажите, следует ли отключить ведение журналов CT для сертификата. Ведение журналов CT для конкретного заказа должно быть включено, иначе настройка будет проигнорирована. См. Разрешить пользователям не регистрировать сертификаты в журналах CT. По умолчанию: false
|
organization | обязательный | object | Контейнер для подробных сведений об организации. |
.. id | обязательный | int |
Идентификатор организации для привязки к заказу. Кроме того, вы можете передать объект организации, чтобы добавить новую организацию при отправке заказа. См. Создать организацию для ознакомления с требованиями, предъявляемыми к структуре объекта. |
.. contacts | обязательный | array |
Перечень контактных лиц в организации, связанных с заказом. Примечание.
|
.. .. contact_type | обязательный | string |
Тип контакта, добавляемого к заказу. Допустимые значения: organization_contact , technical_contact , ev_approver
|
.. .. user_id | обязательный* | int |
Идентификатор существующего пользователя или контактного лица для учетной записи. * Можно опустить, если добавляется новое контактное лицо. |
.. .. first_name | необязательный | string |
Имя нового контактного лица. Примечание. Требуется, если не указывается user_id . Если user_id указывается, информация об указанном пользователе будет обновляться с использованием нового значения.
|
.. .. last_name | необязательный | string |
Фамилия нового контактного лица. Примечание. Требуется, если не указывается user_id . Если user_id указывается, информация об указанном пользователе будет обновляться с использованием нового значения.
|
.. .. job_title | необязательный | string |
Название должности нового контактного лица. Примечание. Требуется, если не указывается user_id . Если user_id указывается, информация об указанном пользователе будет обновляться с использованием нового значения.
|
.. .. telephone | необязательный | string |
Номер телефона нового контактного лица. Примечание. Требуется, если не указывается user_id . Если user_id указывается, информация об указанном пользователе будет обновляться с использованием нового значения.
|
необязательный | string |
Адрес электронной почты нового контактного лица. Примечание. Требуется, если не указывается user_id . Если user_id указывается, информация об указанном пользователе будет обновляться с использованием нового значения.
|
|
container | необязательный | object | При необходимости укажите контейнер, в которым следует разместить заказ. |
.. id | обязательный | int | Идентификатор контейнера. |
custom_fields | необязательный* | array |
Настраиваемые поля для определенной учетной записи. *Являются ли данные поля обязательными, зависит от настроек пользовательских полей. |
.. metadata_id | обязательный | int | Идентификатор настраиваемого поля. |
.. value | обязательный | string |
Значение для настраиваемого поля. Тип подтверждения действительности данных зависит от настроек пользовательских полей. |
Имя | Тип | Описание |
---|---|---|
id | int | Идентификатор заказа. |
organization | object |
Контейнер для новых сведений об организации. Возвращается только в том случае, если вместе с заказом была создана новая организация. |
.. id | int | Идентификатор новой организации. |
requests | array | Содержит информацию о запросе. |
.. id | int | Идентификатор запроса. |
.. status | string |
Статус запроса. Допустимые значения: pending , submitted , approved , rejected
|
certificate_id | int |
Идентификатор сертификата. Указывается в ответе, если статус запроса approved .
|