INTEGRITY Документация

← Cloudflare for Platforms / cloudflare-for-platforms / cloudflare-for-saas / security / certificate-management / custom-certificates

Управление пользовательскими сертификатами

Узнайте, как управлять пользовательскими сертификатами для пользовательских имён хостов Cloudflare for SaaS. Варианты использования и ограничения см. в пользовательские сертификаты.

Загрузка сертификатов

В этом разделе описан общий процесс загрузки пользовательского сертификата, соответствующего одному из поддерживаемые типы.

Чтобы загрузить пользовательский сертификат в дашборде, выберите Собственный сертификат в то время как создание вашего пользовательского имени хоста.

Информация о метод объединения параметрах см. Документация Cloudflare по SSL/TLS.

Приведённый ниже вызов загрузит сертификат для использования с app.example.com.

Обратите внимание, что при использовании ключа ECC, сгенерированного с помощью OpenSSL, вам сначала нужно будет удалить -----BEGIN EC PARAMETERS-----...-----END EC PARAMETERS----- раздел файла.

  1. Обновите файл и соберите полезную нагрузку
cat app_example_com.pem
-----BEGIN CERTIFICATE-----
MIIFJDCCBAygAwIBAgIQD0ifmj/Yi5NP/2gdUySbfzANBgkqhkiG9w0BAQsFADBN
MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMScwJQYDVQQDEx5E
...
SzSHfXp5lnu/3V08I72q1QNzOCgY1XeL4GKVcj4or6cT6tX6oJH7ePPmfrBfqI/O
OeH8gMJ+FuwtXYEPa4hBf38M5eU5xWG7
-----END CERTIFICATE-----
MYCERT="$(cat app_example_com.pem|perl -pe 's/\r?\n/\\n/'|sed -e 's/..$//')"
MYKEY="$(cat app_example_com.key|perl -pe 's/\r?\n/\\n/'|sed -e's/..$//')"

Сохранив сертификат и ключ в переменных окружения (используя экранированные символы новой строки), сформируйте полезную нагрузку:

$ echo $MYCERT
-----BEGIN CERTIFICATE-----\nMIIFJDCCBAygAwIBAgIQD0ifmj/Yi5NP/2gdUySbfzANBgkqhkiG9w0BAQsFADBN\nMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMScwJQYDVQQDEx5E...SzSHfXp5lnu/3V08I72q1QNzOCgY1XeL4GKVcj4or6cT6tX6oJH7ePPmfrBfqI/O\nOeH8gMJ+FuwtXYEPa4hBf38M5eU5xWG7\n-----END CERTIFICATE-----\n

$ request_body=$(< <(cat <<EOF
{
  "hostname": "app.example.com",
  "ssl": {
    "custom_certificate": "$MYCERT",
    "custom_key": "$MYKEY"
  }
}
EOF
))
  1. Используйте POST запрос чтобы загрузить свой сертификат и ключ.

Используйте пакеты сертификатов: RSA и ECDSA

Certificate pack позволяет загрузить для пользовательского имени хоста до одного пользовательского сертификата RSA и одного ECDSA. На данный момент этот процесс поддерживается только через API.

Чтобы загрузить сертификат RSA и ECDSA для пользовательского имени хоста, укажите bundle_method к force и определите custom_cert_bundle свойство, когда создание пользовательского имени хоста через API.

Также можно использовать "bundle_method": "force" и custom_cert_bundle с PATCH запрос к Edit Custom Hostname конечная точка.

Удаление пользовательского сертификата и закрытого ключа

Используйте Удаление отдельного сертификата и ключа для пользовательского имени хоста endpoint для удаления одного из пользовательских сертификатов и соответствующего ключа из пакета сертификатов.

Сертификат нельзя удалить, если он единственный оставшийся сертификат в пакете.

Замена пользовательского сертификата и закрытого ключа

Чтобы заменить один пользовательский сертификат в certificate pack, который содержит два объединённых сертификата, используйте Замена пользовательского сертификата и пользовательского ключа в пользовательском имени хоста конечная точка.

Сертификат RSA можно заменить только другим сертификатом RSA, а сертификат ECDSA можно заменить только другим сертификатом ECDSA.

Переход на сертификат Cloudflare

Если вы хотите перейти от собственного сертификата к сертификату, выпущенному Cloudflare, вы можете перенести его без простоя.

Отправьте PATCH запрос к вашему пользовательскому имени хоста со значением для DCV method. Как только сертификат проверен и имя хоста проверено, Cloudflare удалит старый пользовательский сертификат и начнёт обслуживать новый.