Вопросы и ответы

Как установить сертификаты для Nginx

1. Загрузите на хост, где развёрнут On‑Premise, публичный сертификат и секретный ключ в PEM-формате.
2. В конфигурационном файле configs_variables.json укажите пути до ранее загруженных файлов:
   • Publication.SslCertificateFilePath
   • Publication.SslCertificateKeyFilePath
3. Обновите конфигурацию. Для этого следуйте инструкции Обновление из раздела «Обновление конфигурации».

Как установить логотип организации

1. Загрузите на хост, где развёрнут On‑Premise логотип в формате PNG.
2. В конфигурационном файле configs_variables.json добавьте путь для логотипа в блок Organization.LogoImageFilePath.
3. Обновите конфигурацию. Для этого следуйте инструкции Обновление из раздела «Обновление конфигурации».

Как развернуть изолированный On‑Premise или сменить тип текущего

1. В конфигурационном файле configs_variables.json измените значение InstallationType на Full или Hybrid, в зависимости от выбранного типа.
2. Обновите конфигурацию. Для этого следуйте инструкции Обновление из раздела «Обновление конфигурации».

Как поменять ApiKey

1. В конфигурационном файле configs_variables.json измените значение KonturCloud.ApiKey.
2. Обновите конфигурацию. Для этого следуйте инструкции Обновление из раздела «Обновление конфигурации».

Как добавить администраторов в организацию в изолированном On‑Premise

1. В конфигурационном файле configs_variables.json измените значение Organization.InstallationAdmins.
2. Обновите конфигурацию. Для этого следуйте инструкции Обновление из раздела «Обновление конфигурации».

Как отключить автоматическую привязку к организации при входе в On‑Premise

1. В конфигурационном файле configs_variables.json установите значение false в Organization.IsUsersAutoRegistrationEnabled.
2. Обновите конфигурацию. Для этого следуйте инструкции Обновление из раздела «Обновление конфигурации».

   [Expand | title=Пример установки доменов | size=p]

   

Как указать путь до директории с сертификатами LDAPS для кабинета администратора

Сервер LDAPS, который установлен в вашей инфраструктуре, должен доверять сертификатам CA (Certificate Authority).

В дистрибутивах Linux директория:/etc/ssl/certs служит для хранения SSL-сертификатов. Вы можете просмотреть содержимое директории с помощью команды:

ls /etc/ssl/certs

Это поможет вам понять, какие SSL-сертификаты расположены в директории.

1. Убедитесь, что на вашем сервере установлен SSL-сертификат, но не по пути /etc/ssl/certs.

2. В конфигурационном файле configs_variables.json укажите путь до директории с доверенным корневым сертификатом:

   {
   	...,
   	...,
   	"Environment": {
       	"CaSslCertificatesDirectoryPath": "<путь до директории с доверенным корневым сертификатом>"
     	},
   	...,
   	...
   }

   Пример настройки

     "Environment": {
       "CaSslCertificatesDirectoryPath": "/etc/pki/ca-trust/source/anchors"
     },

3. Обновите конфигурацию. Для этого следуйте инструкции Обновление из раздела «Обновление конфигурации».

Как использовать собственные email-сервера для отправки email-приглашений

1. В конфигурационном файле configs_variables.json укажите блок EmailSending.
2. В EmailSending заполните настройки:
   • EmailSending.SenderAddress: адрес отправителя.
   • EmailSending.Gateways.[].Login: логин для подключения к почтовому серверу.
   • EmailSending.Gateways.[].Password: пароль для подключения к почтовому серверу.
   • EmailSending.Gateways.[].SmtpUrl: адрес для подключения к почтовому серверу по SMTP. Настройка необходима, чтобы отправить письмо.
   • EmailSending.Gateways.[].ImapUrl: адрес для подключения к почтовому серверу по IMAP. Настройка необходима, чтобы получить статус письма.

3. Обновите конфигурацию. Для этого следуйте инструкции Обновление из раздела «Обновление конфигурации».

    Пример использования собственных email-серверов для отправки email-приглашений 

   

Для работы с двумя и более почтовыми серверами и обеспечения отказоустойчивости, укажите несколько значений в блоке EmailSending.Gateways:

"EmailSending": {
  "Type": "OnPrem",
  "SenderAddress": "kid@example.ru",
  "Gateways": [
    {
      "Login": "example-login",
      "Password": "example-password",
      "SmtpUrl": "smtp://ntfcts-postifix3:587",
      "ImapUrl": "imap://ntfcts-postifix3"
    },
    {
      "Login": "example-second-login",
      "Password": "example-second-password",
      "SmtpUrl": "smtp://ntfcts-postifix4:587",
      "ImapUrl": "imap://ntfcts-postifix4"
    }
  ]
}

Как отредактировать шаблоны email-приглашений на собственных email-серверах

1. Скопируйте текущие шаблоны по пути /onprem/configs/spam-api/data/templates в новую директорию. Например, /onprem/email-templates.
2. Внесите правки в скопированные шаблоны.
3. В конфигурационном файле configs_variables.json установите путь до директории с новыми шаблонами в EmailSending.TemplatesDirectoryPath.

4. Обновите конфигурацию. Для этого следуйте инструкции Обновление из раздела «Обновление конфигурации».

    Пример редактирования шаблонов email-приглашений на собственных email-серверах 

   

    

Как изменить доменные адреса kid и kid-portal

1. В конфигурационном файле configs_variables.json укажите в блоке Publication новые значения KonturIdDomainName и KonturIdPortalDomainName:

   "DomainName": "<доменное имя инсталляции>", 
   "KonturIdDomainName": "<доменное имя инсталляции kid>",  
   "KonturIdPortalDomainName": "<доменное имя инсталляции kid-portal>"

   Пример настройки

   "Publication": {
     "DomainName": "example.com",
     "KonturIdDomainName": "kid.example.com",
     "KonturIdPortalDomainName": "kid-portal.example.com"
   },

2. Обновите конфигурацию. Для этого следуйте инструкции Обновление из раздела «Обновление конфигурации».