Поведение расширения Let’s Encrypt в Plesk зависит от ряда настроек, например:

  • За какое время до окончания срока действия обновляются сертификаты Let’s Encrypt;
  • Записываются ли в журнал Plesk запросы к серверу ACME;
  • Размер секретного ключа RSA и так далее.

Вы можете изменить эти настройки, указав свои собственные значения в разделе [ext-letsencrypt] конфигурационного файла panel.ini. Например, чтобы настроить обновление сертификатов Let’s Encrypt за 45 дней до окончания срока действия и изменить размер секретного ключа RSA на 4096 бит, добавьте следующий раздел в файл panel.ini:

[ext-letsencrypt]
renew-before-expiration = 45
rsa-key-size = 4096

Как обеспечить защиту сайтов с помощью бесплатных SSL/TLS-сертификатов от Let’s Encrypt

Расширение Let’s Encrypt позволяет автоматически обеспечить защиту сайтов с помощью бесплатных доверенных SSL/TLS-сертификатов от Let’s Encrypt. Эту функцию можно включить или выключить для каждого конкретного хостинг-плана. Когда вы включаете эту функцию для хостинг-плана, то для каждого объекта (домена, субдомена, псевдонима домена или службы веб-почты), принадлежащего подписке на основе этого хостинг-плана, который:

  • защищен самозаверенным SSL/TLS-сертификатом,
  • защищен просроченным SSL/TLS-сертификатом,
  • вообще не защищен SSL/TLS-сертификатом,

самозаверенный или просроченный SSL/TLS-сертификат заменяется на сертификат Let’s Encrypt.

Вы также можете настроить расширение Let’s Encrypt так, чтобы в дополнение к самозаверенным или просроченным SSL/TLS-сертификатам оно заменяло также и SSL/TLS-сертификаты, не выпущенные каким-либо доверенным центром сертификации. Для этого необходимо выставить значение true для настройки check-domain-cert-authority. Читайте больше о настройке check-domain-cert-authority в разделе “Список настроек Let’s Encrypt”.

Чтобы обеспечить защиту сайтов с помощью бесплатного SSL/TLS-сертификата от Let’s Encrypt:

  1. Перейдите в раздел  Тарифные планы.
  2. На вкладке “Хостинг-планы” нажмите  Добавить план для создания нового плана или нажмите имя существующего плана для его редактирования.
  3. Перейдите на вкладку “Дополнительные услуги”.
  4. В разделе “Let’s Encrypt” выберите “Обеспечить защиту сайтов с помощью бесплатного SSL-сертификата”.
  5. Нажмите  OK (или Обновить и синхронизировать в случае редактирования существующего плана).

Теперь все домены, субдомены, псевдонимы доменов и службы веб-почты, принадлежащие подпискам на основе этого хостинг-плана, будут автоматически защищены с помощью сертификатов Let’s Encrypt. Это изменение затрагивает как существующие, так и вновь созданные подписки.

Кроме того, вы можете включить опцию “Обеспечить защиту сайтов с помощью бесплатного SSL-сертификата” с помощью XML API, отправив следующий запрос:

<?xml version="1.0" encoding="UTF-8"?>
<packet>
  <service-plan>
    <add-plan-item>
      <filter>
        <name>Default Domain</name>
      </filter>
      <plan-item>
        <name>urn:ext:letsencrypt:plan-item-sdk:keep-secured</name>
      </plan-item>
    </add-plan-item>
  </service-plan>
</packet>

Список настроек Let’s Encrypt

Все настройки расширения Let’s Encrypt, которые можно задать в файле panel.ini, описаны ниже:

Параметр Тип Описание Значение по умолчанию

server

(устаревший)

строка

URL папки сервера ACME.

В Let’s Encrypt версии 2.6.0 и выше этот параметр заменен на acme-directory-url.

В настоящее время поддержка параметра server еще остается, но в дальнейшем будет прекращена. Замените параметр server параметром acme-directory-url.

https://acme-v01.api.letsencrypt.org/directory
rsa-key-size целое число Размер секретного ключа RSA в битах. 2048
user-agent строка HTTP-заголовок User-Agent. Plesk/$PRODUCT_VERSION
letsencrypt-url строка URL сайта Let’s Encrypt. https://letsencrypt.org/
terms-url строка URL хранилища правовых политик Let’s Encrypt. https://letsencrypt.org/repository/
renew-before-expiration целое число Количество дней до окончания срока действия сертификата, за которое он должен автоматически обновиться. 30
config-dir строка Путь, по которому хранятся сертификаты для интеграции с третьими лицами. $PRODUCT_ROOT/var/modules/letsencrypt/etc
verify строка Путь к набору доверенных сертификатов, подписанных корневым центром сертификации. $PRODUCT_ROOT/admin/plib/modules/letsencrypt/resources/ca/cacert.pem
disable-cleanup логическое значение Отключить очистку файлов идентификации после разрешения спора о доменах. false
log-requests логическое значение Записывать запросы к серверу ACME в журнал Plesk. false
secure-new-domain логическое значение Состояние по умолчанию флажка «Защитить домен с помощью Let’s Encrypt», отображаемое при создании подписки, домена или субдомена. false
letsencrypt-docs-rate-limits-url строка URL сайта с документацией Let’s Encrypt об ограничениях (“Rate Limits”). Эта ссылка отображается в сообщениях об ошибках в интерфейсе расширения, когда ограничения Let’s Encrypt превышаются. https://letsencrypt.org/docs/rate-limits/
check-availability-delay целое число *Временной интервал в секундах между попытками проверки доступности домена по HTTP. 5
check-availability-max-attempts целое число *Максимальное количество попыток проверки того, что домен доступен по HTTP. 10
check-availability-timeout целое число *Время ожидания ответа при проверке доступности домена по HTTP. Если в течение периода времени, установленного параметром check-availability-timeout, не получен код ответа, домен считается недоступным. 5
check-domain-cert-authority логическое значение Если выбрана опция “Обеспечить защиту сайтов с помощью бесплатного SSL-сертификата”, и эта настройка имеет значение «false», то расширение Let’s Encrypt заменяет только самозаверенные и просроченные SSL/TLS-сертификаты. Если же эта настройка имеет значение «true», расширение также заменяет SSL/TLS-сертификаты, не заверенные ни одним из корневых сертификатов комплекта сертификатов какого-либо доверенного корневого центра сертификации (смотрите описание настройки verify). false
send-notifications-interval временной интервал Эта настройка определяет, как часто расширение Let’s Encrypt сможет отправлять вам уведомления (например, о том, что домен был защищен сертификатом Let’s Encrypt, или об обновлении сертификата Let’s Encrypt). По умолчанию расширение отправляет вам по электронной почте одно уведомление в день. Это уведомление содержит информацию обо всех событиях, имеющих отношение к Let’s Encrypt, которые произошли с момента отправки предыдущего уведомления. Чтобы получать отдельное уведомление о каждом событии сразу после того, как оно произошло, присвойте этой настройке значение 0. 1 день
use-common-challenge-dir  

Задает общую папку для подтверждения владения доменом: /var/www/vhosts/default/.well-known/acme-challenge.

Примечание:

Этот параметр используется в Plesk 12.5 и выше для Linux.

true
fallback-registration-email   Регистрационный адрес электронной почты при возобновлении SSL/TLS-сертификатов. Используется только в случае, когда адрес для регистрации домена не сохранен в ModulesSettings, и адрес владельца домена не зарегистрирован. Адрес электронной почты администратора
acme-directory-url  

URI папки сервера ACME.

ACME v1: https://acme-v01.api.letsencrypt.org/directory

ACME v2: https://acme-v02.api.letsencrypt.org/directory

https://acme-v01.api.letsencrypt.org/directory

Для выпуска подстановочных SSL/TLS-сертификатов измените значение по умолчанию на https://acme-v02.api.letsencrypt.org/directory.

acme-protocol-version  

Версия протокола ACME.

Возможные значения: acme-v01, acme-v02.

acme-v02

Для выпуска подстановочных SSL/TLS-сертификатов измените значение по умолчанию на acme-v02.

Примечание: *Каждый раз при защите нового домена расширение Let’s Encrypt проверяет, доступен ли он по HTTP, так как домены могут быть некоторое время недоступны после создания их в Plesk. Во время этой проверки применяются все настройки, начиная с check-availability.

Примечание: Если у вас установлено расширение Let’s Encrypt версии 2.0.3 или ниже, обновите расширение до версии 2.1 или выше, чтобы можно было изменять настройки Let’s Encrypt с помощью конфигурационного файла panel.ini.