Установка сервера ссылок

Установка сервиса ссылок

Запустите командную строку.
Подключитесь к репозиторию разработчика в Docker для скачивания контейнеров^
```
docker login -u Login -p Password registry.public.express
```
Примечание

В качестве логина и пароля используются Login и Password, которые выдаются разработчиком.
Создайте рабочий каталог веб-клиента:
```
mkdir -p /opt/xlnk
cd /opt/xlnk
echo DPL_IMAGE_TAG=xlnk-release > dpl.env
dpl --init
```
После выполнения команды dpl --init создается файл settings.yaml.
Установите цепочки сертификатов и ключа SSL:
- при использовании собственного сертификата создайте директорию для сертификатов:
  
  Внимание!
  
  Имя файла сертификата и имя ключа должны соответствовать примеру ниже.
```
mkdir -p certs
cp /somewhere/my-certificate-chain.crt certs/express.crt
cp /somewhere/my-unencrypted-key.key certs/express.key
```
  Конструкции /somewhere/my-certificate-chain.crt и /somewhere/my-unencrypted-key.key индивидуальны для каждого конкретного случая.
  
  Конструкции certs/express.crt и certs/express.key являются обязательными.
  
  Требования к сертификатам изложены в статье "Требования к сертификату".
- при использовании сертификата от Let's Encrypt в файл settings.yaml добавьте параметр le_email: admin@company-mail.ru.
  
  Проверка подключения сертификатов после инсталляции описана в статье "Проверка сертификатов".
Созданный по умолчанию файл конфигурации имеет следующий вид и тре-бует редактирования:
```
ccs_host: somehost.somedomain.sometld
```
Пример заполнения конфигурации:
```
ccs_host: xlnk.example.com
le_email: test@example.com
home_address: www.example.com
android_app_link: 'https://play.google.com/store/apps/details?id=ru.unlimitedtech.express'
ios_app_link: 'https://apps.apple.com/ru/app/express-enterprise-messaging/id1225251588?l=en'
ets_id: 00000000-0000-000-000-000000000000
api_gw_url: 'http://link:4000'
web_host_default: 'web.example.com'
```
5. В каталоге /opt/express/xlnk выполните команду:
```
dpl -d
```

Изменение файла конфигурации

Для изменения файла конфигурации воспользуйтесь любым текстовым редактором и внесите исправления в файл:

Название настройки	Значение
ccs_host	Полное имя домена данного сервера, прописанное в DNS и соответствующее имени, на которое приобретался сертификат
le_email	Параметр устанавливается при использовании сертификата от компании Let`s Encrypt. Значение параметра должно соответствовать
e-mail, на который будут приходить оповещения от Let`s Encrypt
home_address	Полное имя домена основного сайта компании, на который будут перенаправляться пользователи при обращении без ссылки на чат/конференцию
ets_id	Идентификатор сервера ETS, необходимый для определения ссылок, созданных на серверах предприятия. Включает отображение ссылок на мобильные приложения компании
android_app_link ios_app_link	Ссылки на мобильные приложения в магазинах приложений Apple, Play Market
android_app_link ios_app_link	Название ссылки на мобильные приложения, по умолчанию имеют значение Android Custom App, iOS Custom App. Отображается при переходе с мобильных устройств по ссылке
api_gw_url	Путь до сервиса xlink для доступа
web_host_default	Полное имя домена сервера web-клиента для чата/конференции