# Включение Network Encryption (TLS) в ELMA365 Enterprise

> [HTML Version](enable-tls-enterprise.html)

ELMA365 Enterprise поддерживает шифрование Transport Layer Security (TLS) 1.2+ для входящего и исходящего трафика. Чтобы автоматически переключать приложение на работу по защищённому протоколу HTTPS, включите поддержку шифрования TLS.

Включение TLS для приложения ELMA365 состоит из трёх этапов:

1. [Подготовка secret с сертификатом для работы по HTTPS](#preparation-of-secret-for-work-on-https).

2. [Внесение изменений в конфигурационный файл](#change-config-file).

3. [Применение параметров TLS для ELMA365 Enterprise](#using-tls-for-elma365-enterprise).

## Шаг 1. Подготовка secret с сертификатом для работы по HTTPS

Для работы по протоколу HTTPS создайте secret с сертификатом. Затем настройте поддержку доверия, если это требуется для используемого сертификата или набора сертификатов CA. Подробнее об этих действиях читайте в статье [«Подготовка secret с сертификатом для работы по HTTPS»](preparation-secret-with-certificate-https.md).

## Шаг 2. Внесение изменений в конфигурационный файл values-elma365.yaml

Изменения вносятся в конфигурационный файл \[OBJECT\], заполненный при установке ELMA365.

````
Начало внимание

````
Перед редактированием файла \[OBJECT\] создайте его резервную копию, поскольку некорректная настройка параметров может привести к сбоям в работе приложения ELMA365.

````
Конец внимание

````
Заполните конфигурационный файл \[OBJECT\] для включения TLS:

1. Чтобы включить поддержку шифрования, укажите \[OBJECT\] в параметре \[OBJECT\]. В этом параметре укажите наименование сертификата для работы по HTTPS, например, \[OBJECT\]. Сертификат должен быть выпущен для доменного имени FQDN в параметре \[OBJECT\], по которому будет доступна система, например,** **\[OBJECT\].

````
global:  
  # Домен (FQDN) или IP-адрес, по которому будет доступна система  
  host: 'example.ru'  
  ingress:  
  # Включение host в ingress (значение берётся из host)  
  # Если s3 minio устанавливался через чарты elma365-dbs, в файле values-dbs.yaml  
  # в блоке minio укажите значение в параметре hosts  
  hostEnabled: false  
  onpremiseTls:  
    # включение HTTPS  
    enabled: true  
    # имя секрета с сертификатами для работы HTTPS  
    secret: "elma365-onpremise-tls"

````


````
Начало внимание

````
Перед применением параметров TLS для приложения ELMA365 убедитесь, что хранилище файлов S3 работает по протоколу HTTPS (использует TLS шифрование).

````
Конец внимание

2. ````
Укажите в параметрах подключения, что на стороне сервера хранилища S3 используется TLS-шифрование. Для этого задайте \[OBJECT\] в параметре \[OBJECT\].

````
...  
db:  
  ...    
  # Настройки подключения к S3-хранилищу файлов  
  s3:  
    method: PUT  
    accesskeyid: PZSF73JG72Ksd955JKU1HIA  
    secretaccesskey: aFDkj28Jbs2JKbnvJH678MNwiz88zKjsuNBHHs  
    bucket: s3elma365  
    backend:  
      address: example.ru  
      region: us-east-1  
    ssl:  
      enabled: "true"  
...

## ````
Шаг 3. Применение параметров TLS для ELMA365 Enterprise

Вы можете обновить параметры приложения ELMA365 двумя способами: через интернет или [без доступа к сети](#offline-update). 

### Обновление параметров через интернет

1. Определите версию чарта, с помощью которого было установлено или обновлено приложение ELMA365:

````
helm show chart elma365/elma365

````
Пример выполнения команды:

**(enable-tls-enterprise-1.png)**

В результате выполнения команды информация о версии чарта будет указана в \[OBJECT\]. Сохраните это значение для выполнения следующего шага.

2. Обновите параметры приложения ELMA365 с применением конфигурационного файла \[OBJECT\]. Для этого используйте следующую команду, указав в ней для флага \[OBJECT\] установленную версию чарта вместо \[OBJECT\]:

````
helm upgrade --install elma365 elma365/elma365 -f values-elma365.yaml --version <elma365-chart-version> --timeout=30m --wait \[-n namespace\]

### ````
Обновление параметров без доступа в интернет

Перейдите в каталог с загруженным чартом ELMA365 и выполните команду:

````
helm upgrade --install elma365 ./elma365 -f values-elma365.yaml --timeout=30m --wait \[-n namespace\]

````
Обновление параметров занимает 10–30 минут. Дождитесь его завершения.