[Документация Yandex Cloud](../../../index.md) > [Yandex Cloud CDN](../../index.md) > [Пошаговые инструкции](../index.md) > Ресурсы > Настройка профиля безопасности TLS

# Настройка профиля безопасности TLS для CDN-ресурса

Для соединения с клиентами в Cloud CDN поддерживается использование протокола TLS, начиная с версии 1.0.

Чтобы обеспечить большую безопасность вашего CDN-ресурса, вы можете настроить для него специальный профиль с допустимыми для использования версиями протокола TLS.

Подробнее в разделе [Профили безопасности TLS](../../concepts/clients-to-servers-tls.md#tls-profiles).

{% list tabs group=instructions %}

- REST API {#rest-api}

  Чтобы включить опцию, добавьте в спецификацию CDN-ресурса в теле запроса блок `tls` при использовании метода [create](../../api-ref/Resource/create.md) или [update](../../api-ref/Resource/update.md) для ресурса [Resource](../../api-ref/Resource/index.md):

  ```json
  "tls": {
    "profile": "<профиль_безопасности_TLS>"
  }
  ```

  Поддерживаются следующие профили безопасности:
  * `PROFILE_STRICT` — шифры, совместимые только с TLS версии 1.3.
  
      {% note info %}
  
      Все шифры TLS версии 1.3 считаются безопасными.
  
      {% endnote %}
  
  * `PROFILE_SECURE` — шифры, совместимые с TLS версии 1.2 и новее с поддержкой PFS (Perfect Forward Secrecy) и AEAD (Authenticated Encryption with Associated Data).
  * `PROFILE_COMPATIBLE` — шифры, совместимые с TLS версии 1.2 и новее без известных критических уязвимостей.
  
      Этот профиль используется по умолчанию.
  * `PROFILE_LEGACY` — шифры, совместимые с TLS версии 1.0 и новее без известных критических уязвимостей.

  Например:

  ```bash
  export IAM_TOKEN=`yc iam create-token`
  curl \
    --request POST \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --header "Content-Type: application/json" \
    --url 'https://cdn.api.yandexcloud.kz/cdn/v1/resources' \
    --data '{
      "folderId": "b12m81qm6abc********",
      "cname": "cdn-portal.example.com",
      "origin": {
        "originSourceParams": {
          "source": "portal.example.com",
          "meta": {
            "common": { "name": "portal.example.com" }
          }
        }
      },
      "originProtocol": "HTTPS",
      "tls": {
        "profile": "PROFILE_SECURE"
      }
    }'
  ```

  Результат:

  ```text
  {
    "done": true,
    "metadata": {
      "@type": "type.googleapis.com/yandex.cloud.cdn.v1.CreateResourceMetadata",
      "resourceId": "bc8rgivxwhcy********"
    },
    "response": {
      "@type": "type.googleapis.com/yandex.cloud.cdn.v1.Resource",
      "active": true,
      ...
      "tls": {
        "profile": "PROFILE_SECURE"
      },
      ...
    },
    "id": "bc8y2mnkri2d********",
    "description": "Create resource",
    "createdAt": "2026-02-05T18:02:30.735628Z",
    "createdBy": "aje9k8luj4qf********",
    "modifiedAt": "2026-02-05T18:02:30.735628Z"
  }
  ```

- gRPC API {#grpc-api}

  Чтобы включить опцию, добавьте в спецификацию CDN-ресурса в теле запроса блок `tls` при использовании вызова [ResourceService/Create](../../api-ref/grpc/Resource/create.md) или [ResourceService/Update](../../api-ref/grpc/Resource/update.md):

  ```json
  "tls": {
    "profile": "<профиль_безопасности_TLS>"
  }
  ```

  Поддерживаются следующие профили безопасности:
  * `PROFILE_STRICT` — шифры, совместимые только с TLS версии 1.3.
  
      {% note info %}
  
      Все шифры TLS версии 1.3 считаются безопасными.
  
      {% endnote %}
  
  * `PROFILE_SECURE` — шифры, совместимые с TLS версии 1.2 и новее с поддержкой PFS (Perfect Forward Secrecy) и AEAD (Authenticated Encryption with Associated Data).
  * `PROFILE_COMPATIBLE` — шифры, совместимые с TLS версии 1.2 и новее без известных критических уязвимостей.
  
      Этот профиль используется по умолчанию.
  * `PROFILE_LEGACY` — шифры, совместимые с TLS версии 1.0 и новее без известных критических уязвимостей.

  Например:

  ```bash
  export IAM_TOKEN=`yc iam create-token`
  grpcurl \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
          "folder_id": "b12m81qm6abc********",
          "cname": "cdn-portal.example.com",
          "origin": {
            "origin_source_params": {
              "source": "portal.example.com",
              "meta": {
                "common": { "name": "portal.example.com" }
              }
            }
          },
          "origin_protocol": "HTTPS",
          "tls": {
            "profile": "PROFILE_SECURE"
          }
        }' \
    cdn.api.yandexcloud.kz:443 \
    yandex.cloud.cdn.v1.ResourceService/Create
  ```

  Результат:

  ```text
  {
    "id": "bc8h7teov4q7********",
    "description": "Create resource",
    "createdAt": "2026-02-05T18:19:01.262477Z",
    "createdBy": "aje9k8luj4qf********",
    "modifiedAt": "2026-02-05T18:19:01.262477Z",
    "done": true,
    "metadata": {"@type":"type.googleapis.com/yandex.cloud.cdn.v1.CreateResourceMetadata","resourceId":"bc8r4gogfqeb********"},
    "response": {..."tls":{"profile":"PROFILE_SECURE"},...}
  }
  ```

{% endlist %}

#### Полезные ссылки {#see-also}

* [Профили безопасности TLS](../../concepts/clients-to-servers-tls.md#tls-profiles)
* [Аутентификация в API](../../api-ref/authentication.md)
* [Введение в TLS: обзор принципов и основных характеристик](../../../glossary/tls.md)