Фильтрация по: order endpoints x очистить
enhancement

CertCentral Services API: Improved domains array in OV/EV order response

To make it easier to see how the Services API groups the domains on your OV/EV TLS certificate orders for validation, we added a new response parameter to the endpoints for submitting certificate order requests: domains[].dns_name.*

The dns_name parameter returns the common name or SAN of the domain on the order. To prove you control this domain, you must have an active validation for the domain associated with the domains[].name and domains[].id key/value pairs.

Example OV certificate order

JSON payload:

JSON payload

JSON response:

JSON response

The Services API returns the domains[].dns_name parameter in the JSON response for the following endpoints:

*Note: Only order requests for OV/EV TLS certificates return a domains array.

enhancement

CertCentral Services API: Улучшенные конечные точки

В DigiCert Services API мы обновили перечисленные ниже конечные точки, что позволяет пропускать проверку дубликата организации для создания новой организации.

Логика работы по умолчанию

По умолчанию при создании новой организации (без указания идентификатора организации) мы проверяем организации, которые уже существуют в вашей учётная запись во избежание создания дубликата организации. Если данные, указанные вами в запросе, совпадают с данными существующей организации, то вместо создания новой организации мы связываем заказ с существующей организацией.

Новая организация.skip_duplicate_org_check — параметр запроса

Мы добавили параметр запроса новой организации.skip_duplicate_org_check в конечные точки, перечисленные ниже, чтобы вы могли переопределить логику работы и принудительно создать новую организацию.

Пример запрос с параметром запроса новой организации.skip_duplicate_org_check

Example API request with the skip_duplicate_org_check parameter

Обновленные конечные точки:

enhancement

CertCentral Services API: Улучшенные конечные точки заказа:

В DigiCert Services API мы добавили ответный параметр "Идентификатор домена" для перечисленных ниже конечных точек. Теперь, когда вы добавляете домены, новые или существующие, в запрос на сертификат, мы указываем идентификаторы доменов в ответе.

Это позволяет уменьшить количество вызовов API, необходимых для получения идентификаторов доменов, указанных в заказе на сертификат. Это также позволяет немедленно выполнить задачу, связанную с доменом, например, изменить метод DCV для одного из доменов в заказе или повторно отправить электронные сообщения WHOIS.

Примечание. Ранее после добавления новых или существующих доменов в свой запрос вам необходимо было выполнить дополнительный вызов для получения идентификаторов доменов: Список доменов или Информация о домене .

Обновленные конечные точки заказа

Пример ответа с параметром нового идентификатора домена

Order endpoints' example reponse with new domains parameter

Январь 14, 2020

enhancement

CertCentral Services API: Улучшенные конечные точки заказа:

В DigiCert Services API мы добавили ответный параметр "Идентификатор организации" для конечных точек, перечисленных ниже. Теперь при добавлении новой организации в ваш запрос сертификата мы отправляем в ответ идентификатор организации, что позволяет вам использовать организацию сразу же в ваших запросах сертификатов.

Ранее после добавления новой организации в ваш запрос сертификата вы должны были сделать дополнительное обращение, чтобы получить идентификатор организации для новой организации: Информация по заказу.

Обновленные конечные точки заказа:

Пример ответа с параметром нового идентификатора организации

Example response with new organization ID parameter

enhancement

Мы усовершенствовали наши предложения однодоменных базовых сертификатов и сертификатов защищенного сайта (стандартный SSL, EV SSL, Secure Site SSL и Secure Site EV SSL), добавив в них параметр Включить оба:[your-domain].com и www. [your-domain].com в сертификат в данные формы заказов на выпуск сертификатов, на повторный выпуск и на дубликаты сертификатов. Данный параметр позволяет вам выбрать, следует ли включать обе версии общего имени (FQDN) в эти однодоменные сертификаты бесплатно.

  • Чтобы защитить обе версии общего имени (FQDN), установите флажок Включить оба[your-domain].com и www. [your-domain].com в сертификат.
  • Чтобы защитить только общее имя (FQDN), снимите флажок Включить оба[your-domain].com и www. [your-domain].com в сертификат.

См. Заказ на ваши сертификаты SSL/TLS.

Действительно также и в отношении субдоменов

Новый параметр позволяет получать версии как базовых доменов, так и субдоменов. Теперь, чтобы защитить обе версии субдоменов, добавьте субдомен в окно Общее имя (sub.domain.com) и отметьте галочкой Включить оба[your-domain].com и www. [your-domain].com в сертификат. Когда DigiCert выпускает ваш сертификат, он будет включать обе версии субдомена в сертификате: [sub.domain].com и www.[sub.doman].com.

Удаление использования функции Plus для субдоменов

Параметр Включить оба[your-domain].com и www. [your-domain].com в сертификат обусловливает неактуальность функции Plus -- Использовать функцию Plus (Плюс) для субдоменов. Таким образом, мы удалили параметр со страницы «Предпочтительные настройки подразделения» (в меню на боковой панели нажмите Настройки > Предпочтительные настройки).

enhancement

В DigiCert Services API мы обновили конечные точки Заказ OV/EV SSL, Заказ SSL (type_hint), Заказать Secure Site SSL, Заказ Private SSL, Перевыпуск сертификата, и Дубликат сертификата, перечисленные ниже. Данные изменения обеспечивают боле широкие возможности контроля при размещении запроса, повторном выпуске и дублировании однодоменных сертификатов, что позволяет вам решить, следует ли включать конкретный дополнительный SAN в эти однодоменные сертификаты бесплатно.

  • /ssl_plus
  • /ssl_ev_plus
  • /ssl_securesite
  • /ssl_ev_securesite
  • /private_ssl_plus
  • /ssl*
  • /перевыпустить
  • /duplicate

*Примечание: Для конечной точки Заказать SSL (type_hint) используйте только параметр dns_names[] в соответствии с описанием ниже для добавления бесплатного SAN.

Чтобы защитить обе версии вашего домена ([your-domain].com и www. [your-domain].com), в своем запросе используйте параметр common_name для добавления домена ([your-domain].com) и параметр dns_names[] для добавления другой версии домена (www. [your-domain].com).

Когда DigiCert выпустит ваш сертификат, он будет защищать обе версии вашего домена.

example SSL certificte request

Чтобы защитить только общее имя (FQDN), опустите параметр dns_names[] в своем запросе.