Настройки

Возможности раздела Настройки:

настройка внешних удаленных хранилищ
добавление пользовательских аудиофайлов
работа с сертификатами
настройка шаблонов электронной почты
работа с системными настройками
сопоставление кодов завершения вызова Q.931

Удаленные хранилища

Во вкладке Удаленные хранилища отображаются все внешние хранилища, используемые в системе и предназначенные для выгрузки, хранения аудиофайлов и CDR.

Для перехода во вкладку: раздел Настройки → вкладка Удаленные хранилища

Добавление внешнего хранилища

Чтобы добавить новое внешнее хранилище, необходимо:

раздел Настройки → вкладка Удаленные хранилища
нажать кнопку Добавить → окно Добавить удаленное хранилище

указать параметры добавляемого хранилища:

поле Имя: ввести наименование хранилища, которое в дальнейшем будет использоваться в системе

поле Тип: выбрать тип хранилища — dir или ftp — и установить его параметры

dir

Локальное хранилище на сервере с установленным сервером телефонии IVA CS. Параметры подключения к dir-хранилищу:

поле Путь: каталог хранения загружаемых файлов, например /home/cdr

Пользователю ivasw предварительно необходимо выдать дополнительные права на запись и чтение каталога, который будет использоваться в качестве удаленного хранилища.
Чтобы выдать права на чтение и запись, необходимо выполнить команду:
```
sudo chown -R ivasw:ivasw <PATH_DIR>
```
где <PATH_DIR> — каталог хранения загружаемых файлов, в примере: /home/cdr
поле Имя пользователя: root
поле Пароль: пароль пользователя (необязательный параметр)

ftp

Удаленное хранилище находящееся на FTP-сервере.
Для аутентификации на данном сервере необходимо заполнить данные в следующих полях:

поле Хост: IP-адрес FTP-сервера, в формате ftp://<FTP_HOSTNAME>, где <FTP_HOSTNAME> — имя FTP-хоста
поле Путь: каталог хранения загружаемых файлов, например /home/cdr
поле Порт: порт подключения к FTP-серверу
поле Имя пользователя: логин FTP-пользователя
поле Пароль: пароль FTP-пользователя

Если данные необходимо передавать в зашифрованном виде, то необходимо перевести переключатель TLS в положение Кнопка ON

Если активирован переключатель Проверить сертификат, то проверка сертификата в режиме TLS не производится

нажать кнопку Сохранить

Удаление внешнего хранилища

Для удаления внешнего хранилища необходимо:
Настройки → Удаленные хранилища → Выбрать хранилище Кнопка Выбрать → Нажать кнопку Удалить → Подтвердить удаление, нажав кнопку Да

Аудиофайлы

Во вкладке Аудиофайлы находятся аудиофайлы, загруженные администратором в систему и доступные для дальнейшего использования в сервисах телефонии, таких как IVR, Голосовая почта, Очередь вызовов и других.

Для перехода во вкладку: раздел Настройки → вкладка Аудиофайлы

Добавление аудиофайла

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

Для загрузки аудиофайлов необходимо:

раздел Настройки → вкладка Аудиофайлы
нажать кнопку Добавить → окно Добавить аудиофайл

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

поле Имя: ввести наименование аудиофайла отображаемое в веб-интерфейсе

переключатель Общий доступ: установить уровень доступа

Если переключатель Общий доступ активирован, то аудиофайл будет доступен всем пользователям системы, в противном случае — только пользователю, загрузившему данный аудиофайл

поле Выберите аудиофайл: выбрать и добавить аудиофайл

нажать кнопку Сохранить

Удаление аудиофайла

Для удаления аудиофайла:
Настройки → Аудиофайлы → Выбрать аудиофайл Кнопка Выбрать → Нажать кнопку Удалить → Подтвердить удаление, нажав кнопку Да

Сертификаты

Во вкладке Сертификаты находятся TLS-сертификаты и приватные ключи, используемые для шифрования сигнального трафика.

Для шифрования сигнального трафика необходимо сгенерировать TLS-сертификат. Такой сертификат позволяет шифровать данные, передаваемые по SIP-протоколу.

Для SIP TLS используется порт 5061

Для перехода во вкладку: раздел Настройки → вкладка Сертификаты

Добавление сертификата / ключа

Чтобы добавить сертификат / ключ, необходимо:

раздел Настройки → вкладка Сертификаты
нажать кнопку Добавить → окно Добавить сертификат
настроить параметры сертификата:
- поле Название: ввести наименование добавляемого сертификата / ключа
- поле Выбрать файл: выбрать добавляемый сертификат / ключ
нажать кнопку Сохранить

При создании TLS-сертификата создаются самоподписанный сертификат безопасности и приватный ключ, которые необходимо в дальнейшем загрузить в соответствующие параметры системных настроек:

поле its.tls_certificate: загрузить используемый TLS-сертификат
поле its.tls_private_key: загрузить используемый приватный ключ
поле its.tls_domain: указать наименование домена, например, root, в котором необходимо функционирование TLS-сертификата

После загрузки TLS-сертификата и приватного ключа необходимо перезагрузить системные сервисы, выполнив следующие действия:

подключиться по ssh
выполнить перезапуск все сервисов с помощью команды:
```
sudo ivacs-ctl restart
```
Запуск скрипта необходимо выполнять поочередно на каждом сервере

или
```
sudo ivacs-ctl restart all
```
Запуск скрипта необходимо выполнять только на одном сервере

Устройства Yealink не могут зарегистрироваться на сервере телефонии IVA CS используя TLS.

Если сертификаты были загружены только на сервер телефонии IVA CS, то на устройствах Yealink необходимо отключать настройку Принимать только доверенные сертификаты для возможности их регистрации на сервере телефонии

Шаблоны электронной почты

Во вкладке Шаблоны электронной почты представлены шаблоны писем, которые затем будут отправляться пользователям на электронную почту при пропущенных звонках.

Для перехода во вкладку: раздел Настройки → вкладка Шаблоны электронной почты

Для просмотра выбранного шаблона:
Настройки → Шаблоны электронной почты → Нажать на название шаблона → Настройки шаблона электронной почты

Для редактирования шаблона необходимо:
Настройки шаблона электронной почты → Выбрать поле: Тема / Текст / Текст HTML → Внести изменения → Нажать кнопку Сохранить

Чтобы вернуть значения, установленные по умолчанию, необходимо:
Настройки шаблона электронной почты → Выбрать поле: Тема / Текст / Текст HTML → Нажать Вернуть значение по умолчанию → Нажать кнопку Сохранить

Параметры шаблона электронной почты:

поле Код: код типа шаблона, уникальный идентификатор сервиса (неизменяемый параметр)

В зависимости от значения, указанного в поле Код, шаблон используется для разных сервисов
поле Тема: тема электронного письма, отображаемая в заголовке письма
поле Текст: шаблон электронного письма в текстовом формате
поле Текст HTML: шаблон электронного письма в HTML-формате

Поддерживаемые типы шаблонов:

Код шаблона Событие, вызывающее отправку сообщения Шаблон по умолчанию (в текстовом формате)

Код шаблона	Событие, вызывающее отправку сообщения	Шаблон по умолчанию (в текстовом формате)
voicemail	Добавление записи в голосовую почту абонента	Voicemail waiting for you from `{{ .FromName }}`. This letter was sent by a mail robot. This is the manufacturer’s pattern. Follow the link to listen {{ if eq .SubscriberID "00000000-0000-0000-0000-000000000000" }}https://`{{ .WebServer }}`/services/voicemails/`{{ .IvrID }}`/`{{ .VoicemailID }}`{{ else }}https://`{{ .WebServer }}`/subscribers/`{{ .SubscriberID }}`/voicemail/`{{ .VoicemailID }}`{{ end }}
cdr_report_success	Успешное завершение формирования CDR-отчета	Successfully generated CDR report for `{{ .ReportName }}`. File name: `{{ .FileName }}`. Domain name: `{{ .DomainName }}`. Time: `{{ .Time }}`.
cdr_report_failed	Ошибочное завершение формирования CDR-отчета	Failed to generate CDR report for `{{ .ReportName }}`. Error: `{{ .Error }}`. Status code: `{{ .Status }}`. Domain name: `{{ .DomainName }}`. Time: `{{ .Time }}`.
assistant	Информирование автосекретаря	Assistant received call from `{{ .FromName }}`. This letter was sent by a mail robot. This is the manufacturer’s pattern.
fax_incoming	Уведомление о входящем факсе	Fax waiting for you from `{{ .FromName }}`. This message was sent by a mail robot. This is the manufacturer’s template. Follow the link to view https://`{{ .WebServer }}`/subscribers/`{{ .SubscriberID }}`/faxes
fax_incoming_with_attachment	Уведомление о входящем факсе, содержащее факс в теле письма	You are received a fax from `{{ .FromName }}`. This message was sent by a mail robot. This is the manufacturer’s template. Fax is attached.

voicemail

Добавление записи в голосовую почту абонента

Voicemail waiting for you from {{ .FromName }}.
This letter was sent by a mail robot.
This is the manufacturer’s pattern.
Follow the link to listen {{ if eq .SubscriberID "00000000-0000-0000-0000-000000000000" }}https://{{ .WebServer }}/services/voicemails/{{ .IvrID }}/{{ .VoicemailID }}{{ else }}https://{{ .WebServer }}/subscribers/{{ .SubscriberID }}/voicemail/{{ .VoicemailID }}{{ end }}

cdr_report_success

Успешное завершение формирования CDR-отчета

Successfully generated CDR report for {{ .ReportName }}.
File name: {{ .FileName }}.
Domain name: {{ .DomainName }}.
Time: {{ .Time }}.

cdr_report_failed

Ошибочное завершение формирования CDR-отчета

Failed to generate CDR report for {{ .ReportName }}.
Error: {{ .Error }}.
Status code: {{ .Status }}.
Domain name: {{ .DomainName }}.
Time: {{ .Time }}.

assistant

Информирование автосекретаря

Assistant received call from {{ .FromName }}.
This letter was sent by a mail robot.
This is the manufacturer’s pattern.

fax_incoming

Уведомление о входящем факсе

Fax waiting for you from {{ .FromName }}.
This message was sent by a mail robot.
This is the manufacturer’s template.
Follow the link to view https://{{ .WebServer }}/subscribers/{{ .SubscriberID }}/faxes

fax_incoming_with_attachment

Уведомление о входящем факсе, содержащее факс в теле письма

You are received a fax from {{ .FromName }}.
This message was sent by a mail robot.
This is the manufacturer’s template.
Fax is attached.

Параметры шаблонов:

Параметр	Код используемого шаблона	Описание
FromName	Везде	Имя отправителя (в случае, если имя отправителя не определено)
WebServer	Везде	Имя или адрес хоста веб-сервера IVA CS. Может использоваться для составления ссылки на ресурс. Код параметра устанавливается из системной настройки ics_web_server
Time	Везде	Время завершения формирования отчета CDR
ReportName	cdr_report_failed cdr_report_success	Имя отчета CDR
DomainName	cdr_report_failed cdr_report_success	Имя домена в котором формировался отчет CDR
FileName	cdr_report_failed cdr_report_success	Имя файла отчета CDR
Error	cdr_report_failed	Сообщение об ошибке
Status	cdr_report_failed cdr_report_success	Код ошибки (число)
SubscriberID	assistent fax_incoming fax_incoming_with_attachment voicemail	Идентификатор абонента для которого оставлено голосовое сообщение
DomainID	assistent fax_incoming fax_incoming_with_attachment voicemail	Идентификатор домена (абонента для которого оставлено голосовое сообщение)
IvrID	assistent voicemail	Идентификатор IVR
VoicemailID	assistent voicemail	Идентификатор сообщения голосовой почты

Параметр

Код используемого шаблона

Описание

FromName

Везде

Имя отправителя (в случае, если имя отправителя не определено)

WebServer

Везде

Имя или адрес хоста веб-сервера IVA CS.
Может использоваться для составления ссылки на ресурс.
Код параметра устанавливается из системной настройки ics_web_server

Time

Везде

Время завершения формирования отчета CDR

ReportName

cdr_report_failed
cdr_report_success

Имя отчета CDR

DomainName

cdr_report_failed
cdr_report_success

Имя домена в котором формировался отчет CDR

FileName

cdr_report_failed
cdr_report_success

Имя файла отчета CDR

Error

cdr_report_failed

Сообщение об ошибке

Status

cdr_report_failed
cdr_report_success

Код ошибки (число)

SubscriberID

assistent
fax_incoming
fax_incoming_with_attachment
voicemail

Идентификатор абонента для которого оставлено голосовое сообщение

DomainID

assistent
fax_incoming
fax_incoming_with_attachment
voicemail

Идентификатор домена (абонента для которого оставлено голосовое сообщение)

IvrID

assistent
voicemail

Идентификатор IVR

VoicemailID

assistent
voicemail

Идентификатор сообщения голосовой почты

Сопоставление кодов Q.931

Во вкладке Сопоставление кодов Q.931 можно ознакомиться с преобразованиями кодов завершения вызова по стандартам Q.931 и SIP.

Таблица сопоставления кодов формируется для каждого домена и допускает возможность гибкой настройки кодов разъединения, а также сброс к значениям по умолчанию.

Для перехода во вкладку: раздел Настройки → вкладка Сопоставление кодов Q.931

Чтобы добавить сопоставление кода Q.931 в таблицу, необходимо:

раздел Настройки → вкладка Сопоставление кодов Q.931
нажать кнопку Добавить → окно Добавить сопоставление кода Q.931
указать параметры сопоставляемого кода:
- поле Код Q.931: ввести код Q.931
- поле Код SIP: ввести код SIP
- поле Причина разъединения: указать причину разъединения
нажать кнопку Сохранить

Для просмотра / редактирования добавленного кода необходимо:

раздел Настройки → вкладка Сопоставление кодов Q.931
нажать на код в столбце Код Q.931 → окно Настройки сопоставления кода Q.931

Системные настройки

Во вкладке Системные настройки находятся параметры различных системных настроек.

Для перехода во вкладку: раздел Настройки → вкладка Системные настройки

swl_audit

Ключ Тип Значение По умолчанию Описание

Ключ	Тип	Значение	По умолчанию	Описание
syslog_connection_string	Текст		Да	Адрес syslog-сервера для отправки на него событий аудита. Формат адреса: `{network}://{address}`. Например, `tcp://10.0.202.55`. Для подключения к локальному syslog нужно оставить `{network}` пустым, то есть `://`

syslog_connection_string

Текст

Да

Адрес syslog-сервера для отправки на него событий аудита.
Формат адреса: {network}://{address}. Например, tcp://10.0.202.55. Для подключения к локальному syslog нужно оставить {network} пустым, то есть ://

swl_auth

Ключ	Тип	Значение	По умолчанию	Описание
token_ttl	Длительность	28800s	Да	Время жизни токена авторизации
login_ban.max_attempts_wrong_login	Int 64	5	Да	Максимальное количество неудачных попыток авторизации — пара логин / пароль. Значение 0 (или меньше 0) полностью отключает механизм проверки и блокировки
login_ban.ban_duration	Длительность	30s	Да	Период блокировки авторизации, наступающий при превышении максимального числа неудачных попыток входа. До истечения этого срока пользователь не сможет авторизоваться, даже если введет верные данные
login_ban.expires_wrong_login	Длительность	36000s	Да	Длительность блокировки подозрительного IP-адреса. В течение этого срока подозрительный IP-адрес, с которого были зафиксированы неудачные попытки авторизации, остается заблокированным. По истечении указанного времени блокировка снимается, IP-адрес перестает считаться подозрительным и с него можно снова выполнять попытки авторизации

Ключ

Тип

Значение

По умолчанию

Описание

token_ttl

Длительность

28800s

Да

Время жизни токена авторизации

login_ban.max_attempts_wrong_login

Int 64

Да

Максимальное количество неудачных попыток авторизации — пара логин / пароль. Значение 0 (или меньше 0) полностью отключает механизм проверки и блокировки

login_ban.ban_duration

Длительность

30s

Да

Период блокировки авторизации, наступающий при превышении максимального числа неудачных попыток входа. До истечения этого срока пользователь не сможет авторизоваться, даже если введет верные данные

login_ban.expires_wrong_login

Длительность

36000s

Да

Длительность блокировки подозрительного IP-адреса. В течение этого срока подозрительный IP-адрес, с которого были зафиксированы неудачные попытки авторизации, остается заблокированным. По истечении указанного времени блокировка снимается, IP-адрес перестает считаться подозрительным и с него можно снова выполнять попытки авторизации

swl_backend

Ключ	Тип	Значение	По умолчанию	Описание
audit_actions_with_objects	Bool	true	Да	Маркер отправки аудита действий с объектами (создание, изменение, удаление и добавление) на сервер / web API. Рекомендуется включать, если нужен детальный журнал административных изменений
max_notification_numbers	Int 64	100	Да	Максимальное количество номеров для доменного сервиса оповещений
password.complexity_check	Bool	false	Да	Включить проверку сложности пароля
password.max_length	Int 64	72	Да	Максимальная длина пароля
password.min_length	Int 64	8	Да	Минимальная длина пароля
password.require_digits	Bool	false	Да	Наличие цифр в пароле
password.require_lower	Bool	false	Да	Наличие строчных букв в пароле
password.require_special	Bool	false	Да	Наличие спецсимволов в пароле
password.require_upper	Bool	false	Да	Наличие заглавных букв в пароле
password.valid_days	Int 64	0	Да	Срок действия пароля в днях

Ключ

Тип

Значение

По умолчанию

Описание

audit_actions_with_objects

Bool

true

Да

Маркер отправки аудита действий с объектами (создание, изменение, удаление и добавление) на сервер / web API. Рекомендуется включать, если нужен детальный журнал административных изменений

max_notification_numbers

Int 64

100

Да

Максимальное количество номеров для доменного сервиса оповещений

password.complexity_check

Bool

false

Да

Включить проверку сложности пароля

password.max_length

Int 64

Да

Максимальная длина пароля

password.min_length

Int 64

Да

Минимальная длина пароля

password.require_digits

Bool

false

Да

Наличие цифр в пароле

password.require_lower

Bool

false

Да

Наличие строчных букв в пароле

password.require_special

Bool

false

Да

Наличие спецсимволов в пароле

password.require_upper

Bool

false

Да

Наличие заглавных букв в пароле

password.valid_days

Int 64

Да

Срок действия пароля в днях

swl_call

Ключ Тип Значение По умолчанию Описание

Ключ	Тип	Значение	По умолчанию	Описание
time_location	Часовой пояс	Europe/Moscow	Да	Временная зона для отчетов и корректной работы модуля Расписание в сервисах
enable_dial_from_any_host	Bool	false	Да	Включить возможность выполнить дозвон с любого хоста в многосерверной установке
enable_subscriber_loop_back	Bool	false	Да	Разрешить абоненту возможность позвонить самому себе
disable_loop_by_ip_port	Bool	true	Да	Определение уникальности абонента по IP-адресу (без учета связки `IP-адрес:порт`)
max_depth_redirects	Int 64	10	Да	Максимальное число переадресаций при определении маршрута для звонка
disabled_video_codecs	Текст		Да	Глобальный список отключенных видеокодеков (разделитель `,`). Действует как черный список поверх групп видеокодеков, позволяя запретить видеокодек на уровне всей системы без изменения самих групп видеокодеков
disabled_audio_codecs	Текст		Да	Глобальный список отключенных аудиокодеков (разделитель `,`). Действует как черный список поверх групп аудиокодеков, позволяя запретить аудиокодек на уровне всей системы без изменения самих групп аудиокодеков
validate_b_leg_number_from_gateway	Bool	false	Да	Включение валидации номеров для второго плеча звонка, пришедшего со шлюза
video_enabled	Bool	true	Да	Включить обработку видеокодеков в звонках. При включении — видеокодеки участвуют в обработке звонков. При выключении — видеокодеки игнорируются, даже если они разрешены в группах кодеков
leg_a_search_gw_before_user	Bool	true	Да	Предоставить приоритет при аутентификации для вызывающего шлюза, а не для абонента
load.black_list_step	Длительность	5s	Да	Частота обновления кэша черных списков пользователей
load.black_list_delay	Длительность	0s	Да	Длительность задержки перед первым обновлением кэша черных списков пользователей после запуска сервиса
load.routes_step	Длительность	900s	Да	Частота обновления кэша маршрутов для маршрутизации вызовов
load.routes_delay	Длительность	10s	Да	Длительность задержки перед первым обновлением кэша маршрутов для маршрутизации вызовов после запуска сервиса
load.domains_step	Длительность	900s	Да	Частота обновления кэша доменов
load.domains_delay	Длительность	5s	Да	Длительность задержки перед первым обновлением кэша доменов после запуска сервиса
load.codecs_step	Длительность	600s	Да	Частота обновления кэша кодеков
load.codecs_delay	Длительность	0s	Да	Длительность задержки перед первым обновлением кэша кодеков после запуска сервиса
load.features_step	Длительность	300s	Да	Частота обновления кэша кодов абонентских функций
load.features_delay	Длительность	0s	Да	Длительность задержки перед первым обновлением кэша кодов абонентских функций после запуска сервисов
client_redirect_enabled	Bool	false	Да	Включить обработку редиректов, инициированных терминалами (ответ 302)
audio.number_not_found	UUID	00000000-0000-0000-0000-000000000000	Да	Аудиофайл уведомления, что вызываемый номер не существует — если файл не задан, то звонок просто завершится
audio.subscriber_unavailable	UUID	00000000-0000-0000-0000-000000000000	Да	Аудиофайл уведомления о недоступности абонента — если файл не задан, то звонок просто завершится
audio.call_recording	UUID	00000000-0000-0000-0000-000000000000	Да	Аудиофайл уведомления о записи разговора (используется системной настройкой inform_about_call_record). Если не задан, то проигрывается аудиофайл, установленный по умолчанию — recording-all-calls
audio.call_beep	UUID	00000000-0000-0000-0000-000000000000	Да	Аудиофайл, устанавливаемый вместо гудков при дозвоне
audio.music_on_hold	UUID	00000000-0000-0000-0000-000000000000	Да	Аудиофайл, который будет проигрываться во время постановки звонка на удержание
audio.dnd_message	UUID	00000000-0000-0000-0000-000000000000	Да	Аудиофайл, устанавливаемый на режим Не беспокоить (DND)
inform_about_call_record	Bool	true	Да	Воспроизводить уведомление о записи разговора. Если файл не задан, то используется системный файл, установленный по умолчанию (из системной настройки audio.call_recording)
alternative_routing	Bool	true	Да	Включить альтернативную маршрутизацию
ringing_timeout	Длительность	30s	Да	Общий таймаут дозвона. Дозвон прерывается, если его длительность превышает указанную величину. Используется для исходящих звонков с IVA CS и для входящих звонков на IVA CS через шлюз

time_location

Часовой пояс

Europe/Moscow

Да

Временная зона для отчетов и корректной работы модуля Расписание в сервисах

enable_dial_from_any_host

Bool

false

Да

Включить возможность выполнить дозвон с любого хоста в многосерверной установке

enable_subscriber_loop_back

Bool

false

Да

Разрешить абоненту возможность позвонить самому себе

disable_loop_by_ip_port

Bool

true

Да

Определение уникальности абонента по IP-адресу (без учета связки IP-адрес:порт)

max_depth_redirects

Int 64

Да

Максимальное число переадресаций при определении маршрута для звонка

disabled_video_codecs

Текст

Да

Глобальный список отключенных видеокодеков (разделитель ,). Действует как черный список поверх групп видеокодеков, позволяя запретить видеокодек на уровне всей системы без изменения самих групп видеокодеков

disabled_audio_codecs

Текст

Да

Глобальный список отключенных аудиокодеков (разделитель ,). Действует как черный список поверх групп аудиокодеков, позволяя запретить аудиокодек на уровне всей системы без изменения самих групп аудиокодеков

validate_b_leg_number_from_gateway

Bool

false

Да

Включение валидации номеров для второго плеча звонка, пришедшего со шлюза

video_enabled

Bool

true

Да

Включить обработку видеокодеков в звонках. При включении — видеокодеки участвуют в обработке звонков. При выключении — видеокодеки игнорируются, даже если они разрешены в группах кодеков

leg_a_search_gw_before_user

Bool

true

Да

Предоставить приоритет при аутентификации для вызывающего шлюза, а не для абонента

load.black_list_step

Длительность

Да

Частота обновления кэша черных списков пользователей

load.black_list_delay

Длительность

Да

Длительность задержки перед первым обновлением кэша черных списков пользователей после запуска сервиса

load.routes_step

Длительность

900s

Да

Частота обновления кэша маршрутов для маршрутизации вызовов

load.routes_delay

Длительность

10s

Да

Длительность задержки перед первым обновлением кэша маршрутов для маршрутизации вызовов после запуска сервиса

load.domains_step

Длительность

900s

Да

Частота обновления кэша доменов

load.domains_delay

Длительность

Да

Длительность задержки перед первым обновлением кэша доменов после запуска сервиса

load.codecs_step

Длительность

600s

Да

Частота обновления кэша кодеков

load.codecs_delay

Длительность

Да

Длительность задержки перед первым обновлением кэша кодеков после запуска сервиса

load.features_step

Длительность

300s

Да

Частота обновления кэша кодов абонентских функций

load.features_delay

Длительность

Да

Длительность задержки перед первым обновлением кэша кодов абонентских функций после запуска сервисов

client_redirect_enabled

Bool

false

Да

Включить обработку редиректов, инициированных терминалами (ответ 302)

audio.number_not_found

UUID

00000000-0000-0000-0000-000000000000

Да

Аудиофайл уведомления, что вызываемый номер не существует — если файл не задан, то звонок просто завершится

audio.subscriber_unavailable

UUID

00000000-0000-0000-0000-000000000000

Да

Аудиофайл уведомления о недоступности абонента — если файл не задан, то звонок просто завершится

audio.call_recording

UUID

00000000-0000-0000-0000-000000000000

Да

Аудиофайл уведомления о записи разговора (используется системной настройкой inform_about_call_record). Если не задан, то проигрывается аудиофайл, установленный по умолчанию — recording-all-calls

audio.call_beep

UUID

00000000-0000-0000-0000-000000000000

Да

Аудиофайл, устанавливаемый вместо гудков при дозвоне

audio.music_on_hold

UUID

00000000-0000-0000-0000-000000000000

Да

Аудиофайл, который будет проигрываться во время постановки звонка на удержание

audio.dnd_message

UUID

00000000-0000-0000-0000-000000000000

Да

Аудиофайл, устанавливаемый на режим Не беспокоить (DND)

inform_about_call_record

Bool

true

Да

Воспроизводить уведомление о записи разговора. Если файл не задан, то используется системный файл, установленный по умолчанию (из системной настройки audio.call_recording)

alternative_routing

Bool

true

Да

Включить альтернативную маршрутизацию

ringing_timeout

Длительность

30s

Да

Общий таймаут дозвона. Дозвон прерывается, если его длительность превышает указанную величину.

Используется для исходящих звонков с IVA CS и для входящих звонков на IVA CS через шлюз

swl_dtmf

Ключ	Тип	Значение	По умолчанию	Описание
delete.old_dtmf_signals_age	Длительность	30s	Да	Длительность хранения DTMF сигнала
delete.old_dtmf_signals_step	Длительность	10s	Да	Частота очистки старых DTMF сигналов
delete.old_dtmf_signals_delay	Длительность	0s	Да	Длительность задержки перед первой очисткой старых DTMF сигналов после запуска сервиса
first_in_queue_retry_interval	Длительность	1s	Да	Интервал повторных попыток набора группы вызова для абонента, стоящего на первом месте в очереди вызова
load.dtmf_routine_step	Длительность	60s	Да	Частота обновления кэша DTMF правил в сервисе
load.dtmf_routine_delay	Длительность	0s	Да	Длительность задержки перед первым обновление кэша DTMF-правил после запуска сервиса
load.audio_step	Длительность	86400s	Да	Частота обновления кэша аудиозаписей
load.audio_delay	Длительность	0s	Да	Длительность задержки перед первым обновлением кэша аудиозаписей после запуска сервиса
load.actions_step	Длительность	86400s	Да	Частота обновления кэша действий
load.actions_delay	Длительность	0s	Да	Длительность задержки перед первым обновлением кэша действий после запуска сервиса
notification_max_try_count	Int 64	3	Да	Максимальное количество попыток выполнить исходящий вызов с уведомлением по расписанию
notification_capture_timeout	Длительность	40s	Да	Таймаут блокировки объекта уведомления сервисом, взявшим его в работу. Предотвращает вечную блокировку при аварийном завершении сервиса

Ключ

Тип

Значение

По умолчанию

Описание

delete.old_dtmf_signals_age

Длительность

30s

Да

Длительность хранения DTMF сигнала

delete.old_dtmf_signals_step

Длительность

10s

Да

Частота очистки старых DTMF сигналов

delete.old_dtmf_signals_delay

Длительность

Да

Длительность задержки перед первой очисткой старых DTMF сигналов после запуска сервиса

first_in_queue_retry_interval

Длительность

Да

Интервал повторных попыток набора группы вызова для абонента, стоящего на первом месте в очереди вызова

load.dtmf_routine_step

Длительность

60s

Да

Частота обновления кэша DTMF правил в сервисе

load.dtmf_routine_delay

Длительность

Да

Длительность задержки перед первым обновление кэша DTMF-правил после запуска сервиса

load.audio_step

Длительность

86400s

Да

Частота обновления кэша аудиозаписей

load.audio_delay

Длительность

Да

Длительность задержки перед первым обновлением кэша аудиозаписей после запуска сервиса

load.actions_step

Длительность

86400s

Да

Частота обновления кэша действий

load.actions_delay

Длительность

Да

Длительность задержки перед первым обновлением кэша действий после запуска сервиса

notification_max_try_count

Int 64

Да

Максимальное количество попыток выполнить исходящий вызов с уведомлением по расписанию

notification_capture_timeout

Длительность

40s

Да

Таймаут блокировки объекта уведомления сервисом, взявшим его в работу. Предотвращает вечную блокировку при аварийном завершении сервиса

swl_gc

Ключ

Тип

Значение

По умолчанию

Описание

gc.remove_old_system_messages_enabled

Bool

true

Да

Включить очистку старых системных сообщений

gc.remove_old_system_messages_step

Длительность

3600s

Да

Периодичность запуска очистки системных сообщений

gc.remove_old_system_messages_age

Длительность

2592000s

Да

Возраст системных сообщений, по превышении которого они будут автоматически удалены из системы

gc.remove_deleted_files_enabled

Bool

true

Да

Включить очистку хранилища от файлов, помеченных в базе данных на удаление

gc.remove_deleted_files_init_delay

Длительность

Да

Задержка включения очистки хранилища от удаленных файлов после запуска сервиса swl_gc

gc.remove_deleted_files_step

Длительность

10s

Да

Периодичность запуска очистки хранилища от удаленных файлов

gc.remove_deleted_files_delay

Длительность

168h

Да

Задержка между пометкой файла на удаление и добавлением его в очередь на очистку

gc.remove_deleted_files_max_per_step

Int 64

Да

Максимальное количество файлов, которое может быть удалено за один шаг очистки

gc.remove_deleted_files_mode

Int 64

Да

Режим удаления файлов (для типа хранилища local)

Значение

Политика использования

перемещение в папку files-dir + "_deleted" (например для /var/lib/ivasw/files — /var/lib/ivasw/files_deleted)

безвозвратно

swl_ldap

Ключ	Тип	Значение	По умолчанию	Описание
update.accounts_step	Длительность	20s	Да	Частота синхронизации пользователей
update.accounts_delay	Длительность	0s	Да	Длительность задержки перед первой синхронизацией пользователей после запуска сервиса
update.auth_sources_step	Длительность	900s	Да	Частота обновления источников авторизации
update.auth_sources_delay	Длительность	900s	Да	Длительность задержки перед первым обновлением источника авторизации после запуска сервиса
ldap_default_timeout	Длительность	5s	Да	Длительность таймаута на запрос данных из одного источника авторизации для синхронизации пользователей
audit_actions_with_objects	Bool	true	Да	Проводить аудит действий с объектами в процессе синхронизации с LDAP

Ключ

Тип

Значение

По умолчанию

Описание

update.accounts_step

Длительность

20s

Да

Частота синхронизации пользователей

update.accounts_delay

Длительность

Да

Длительность задержки перед первой синхронизацией пользователей после запуска сервиса

update.auth_sources_step

Длительность

900s

Да

Частота обновления источников авторизации

update.auth_sources_delay

Длительность

900s

Да

Длительность задержки перед первым обновлением источника авторизации после запуска сервиса

ldap_default_timeout

Длительность

Да

Длительность таймаута на запрос данных из одного источника авторизации для синхронизации пользователей

audit_actions_with_objects

Bool

true

Да

Проводить аудит действий с объектами в процессе синхронизации с LDAP

swl_location

Ключ	Тип	Значение	По умолчанию	Описание
dns_cache_step	Длительность	900s	Да	Частота обновления кеша для обратного DNS-разрешения

Ключ

Тип

Значение

По умолчанию

Описание

dns_cache_step

Длительность

900s

Да

Частота обновления кеша для обратного DNS-разрешения

swl_monitor

Ключ	Тип	Значение	По умолчанию	Описание
snmp.address	Текст	0.0.0.0:1610	Да	IP-адрес и порт для приема запросов от SNMP-сервера
snmp.authentication_passphrase	Текст	ivaswSTrP@SSWRD	Да	Пароль (ключ) для аутентификации SNMP
snmp.authentication_protocol	Текст	SHA	Да	Протокол аутентификации SNMP — определяет алгоритм хеширования, который используется для проверки подлинности пользователя
snmp.enable	Bool	false	Да	Включение SNMP-сервера
snmp.privacy_passphrase	Текст	ivaswSTrP@SSWRD	Да	Пароль шифрования SNMP
snmp.privacy_protocol	Текст	AES	Да	Протокол шифрования (приватности) SNMP. Определяет алгоритм, используемый для шифрования трафика между SNMP-менеджером и SNMP-агентом
snmp.user_name	Текст	ivasw	Да	Имя пользователя для аутентификации на SNMP-сервере

Ключ

Тип

Значение

По умолчанию

Описание

snmp.address

Текст

0.0.0.0:1610

Да

IP-адрес и порт для приема запросов от SNMP-сервера

snmp.authentication_passphrase

Текст

ivaswSTrP@SSWRD

Да

Пароль (ключ) для аутентификации SNMP

snmp.authentication_protocol

Текст

SHA

Да

Протокол аутентификации SNMP — определяет алгоритм хеширования, который используется для проверки подлинности пользователя

snmp.enable

Bool

false

Да

Включение SNMP-сервера

snmp.privacy_passphrase

Текст

ivaswSTrP@SSWRD

Да

Пароль шифрования SNMP

snmp.privacy_protocol

Текст

AES

Да

Протокол шифрования (приватности) SNMP. Определяет алгоритм, используемый для шифрования трафика между SNMP-менеджером и SNMP-агентом

snmp.user_name

Текст

ivasw

Да

Имя пользователя для аутентификации на SNMP-сервере

swl_notify

Ключ Тип Значение По умолчанию Описание

Ключ	Тип	Значение	По умолчанию	Описание
ics_web_server	Текст	127.0.0.1	Да	Адрес хоста веб-сервера IVA CS. Используется в параметрах шаблонов сервиса нотификации для формирования веб-ссылок, например, ссылка на голосовую почту
sendmail.email	Текст		Да	Адрес электронной почты для приема писем — обязательно заполняется если параметр Login не совпадает с адресом электронной почты
sendmail.login	Текст		Да	Логин для аутентификации на почтовом сервере
sendmail.host	Текст		Да	IP-адрес или FQDN почтового сервера
sendmail.port	Int 64	0	Да	Номер порта почтового сервера
sendmail.max_attach_size	Int 64	10485760	Да	Максимальный размер вложения (в байтах) для отправки в электронном письме
sendmail.max_count_sessions	Int 64	1	Да	Максимальное количество одновременных соединений с SMTP-сервером
sendmail.max_mail_per_connection	Int 64	10	Да	Максимальное количество отправленных писем в одном соединении с почтовым сервером
sendmail.session_ttl	Длительность	600s	Да	Максимальное время жизни одного SMTP-соединения с сервером
sendmail.proto	Текст	smtp	Да	Почтовый протокол — на текущий момент поддерживается только протокол SMTP
sendmail.ext_app_id	Текст		Да	Имя (идентификатор) ключа внешнего приложения
sendmail.from_name	Текст		Да	Имя отправителя письма — если имя пустое, то используется имя из параметра sendmail.ext_app_id
sendmail.insecure_skip_verify	Bool	false	Да	Игнорирование недоверенных сертификатов при использовании TLS
sendmail.ssl	Bool	false	Да	Включить использование SSL-соединения. Если Port равен 465, то SSL автоматически устанавливается в состояние true
sendmail.connect_timeout	Длительность	3s	Да	Время, отведенное на установление соединения с почтовым сервером и последующую авторизацию. Если почтовый сервер недоступен, то время ожидания может увеличиться. Рекомендуется устанавливать небольшое значение
sendmail.password	Текст		Да	Пароль пользователя для ящика электронной почты / пароль для внешнего приложения (из параметра sendmail.ext_app_id)
sendmail.tls_policy	Int 64	1	Да	Политика использования TLS: по требованию сервера: `0` режим TLS *не используется: `-1` режим TLS используется** — обязателен по умолчанию: `1`

ics_web_server

Текст

127.0.0.1

Да

Адрес хоста веб-сервера IVA CS. Используется в параметрах шаблонов сервиса нотификации для формирования веб-ссылок, например, ссылка на голосовую почту

sendmail.email

Текст

Да

Адрес электронной почты для приема писем — обязательно заполняется если параметр Login не совпадает с адресом электронной почты

sendmail.login

Текст

Да

Логин для аутентификации на почтовом сервере

sendmail.host

Текст

Да

IP-адрес или FQDN почтового сервера

sendmail.port

Int 64

Да

Номер порта почтового сервера

sendmail.max_attach_size

Int 64

10485760

Да

Максимальный размер вложения (в байтах) для отправки в электронном письме

sendmail.max_count_sessions

Int 64

Да

Максимальное количество одновременных соединений с SMTP-сервером

sendmail.max_mail_per_connection

Int 64

Да

Максимальное количество отправленных писем в одном соединении с почтовым сервером

sendmail.session_ttl

Длительность

600s

Да

Максимальное время жизни одного SMTP-соединения с сервером

sendmail.proto

Текст

smtp

Да

Почтовый протокол — на текущий момент поддерживается только протокол SMTP

sendmail.ext_app_id

Текст

Да

Имя (идентификатор) ключа внешнего приложения

sendmail.from_name

Текст

Да

Имя отправителя письма — если имя пустое, то используется имя из параметра sendmail.ext_app_id

sendmail.insecure_skip_verify

Bool

false

Да

Игнорирование недоверенных сертификатов при использовании TLS

sendmail.ssl

Bool

false

Да

Включить использование SSL-соединения. Если Port равен 465, то SSL автоматически устанавливается в состояние true

sendmail.connect_timeout

Длительность

Да

Время, отведенное на установление соединения с почтовым сервером и последующую авторизацию.

Если почтовый сервер недоступен, то время ожидания может увеличиться. Рекомендуется устанавливать небольшое значение

sendmail.password

Текст

Да

Пароль пользователя для ящика электронной почты / пароль для внешнего приложения (из параметра sendmail.ext_app_id)

sendmail.tls_policy

Int 64

Да

Политика использования TLS:

по требованию сервера: 0
режим TLS не *используется: -1
режим TLS используется — обязателен по умолчанию: 1

Для получения почтового уведомления о формировании отчета CDR необходимо предварительно авторизоваться пользователем (которому принадлежит почтовый ящик) и создать правило выгрузки CDR.

Для получения почтовых уведомлений от абонентских сервисов Автосекретарь и Голосовая почта необходимо авторизоваться пользователем (чей ящик используется для получения писем) и создать абонента, а затем активировать данные сервисы

Пример настроек для почтового сервера mail.ru

Для неуказанных параметров используются значения по умолчанию.

Ключ Значение

Ключ	Значение
sendmail.host	smtp.mail.ru
sendmail.port	465
sendmail.login	`<LOGIN>@mail.ru` (где <LOGIN> — логин пользователя на почтовом сервере)
sendmail.password	`<PASSWORD>` (где <PASSWORD> — пароль для внешнего приложения, сгенерированный на почтовом сервере)
sendmail.connect_timeout	4s
sendmail.ext_app_id	`<ID_PASSWORD>` (где <ID_PASSWORD> — идентификатор сгенерированного пароля для внешнего приложения)
sendmail.max_mail_per_connection	5
sendmail.session_ttl	600s
sendmail.max_count_sessions	1
sendmail.insecure_skip_verify	false
sendmail.tls_policy	1

sendmail.host

smtp.mail.ru

sendmail.port

465

sendmail.login

<LOGIN>@mail.ru (где <LOGIN> — логин пользователя на почтовом сервере)

sendmail.password

<PASSWORD> (где <PASSWORD> — пароль для внешнего приложения, сгенерированный на почтовом сервере)

sendmail.connect_timeout

sendmail.ext_app_id

<ID_PASSWORD> (где <ID_PASSWORD> — идентификатор сгенерированного пароля для внешнего приложения)

sendmail.max_mail_per_connection

sendmail.session_ttl

600s

sendmail.max_count_sessions

sendmail.insecure_skip_verify

false

sendmail.tls_policy

swl_registry

Ключ	Тип	Значение	По умолчанию	Описание
maintenance_mode	Bool	false	Да	Режим обслуживания: блокировка любых действий, которые изменяют данные, через веб-интерфейс администрирования / API
monitor.process_shutdown_duration	Длительность	60s	Да	Максимально допустимая длительность завершения процесса
monitor.reg_db_timeout	Длительность	5s	Да	Таймаут подключения к внутренней базе данных сервиса
its.check_latency	Длительность	7s	Да	Длительность задержки перед повторной проверкой состояния ITS после того, как в результате предыдущей проверки была получена ошибка
its.cache_cleanup_interval	Длительность	420s	Да	Частота очистки экземпляров ITS, определенных балансировщиком нагрузки для конкретного звонка
its.cache_expiration	Длительность	300s	Да	Длительность хранения экземпляра ITS, определенного балансировщиком нагрузки для конкретного звонка
its.get_services_info_interval	Длительность	900s	Да	Частота проверки состояния ITS
its.tls_certificate	UUID	00000000-0000-0000-0000-000000000000	Да	TLS-сертификат для подключения к ITS
its.tls_private_key	UUID	00000000-0000-0000-0000-000000000000	Да	Приватный ключ TLS для подключения к ITS
its.tls_domain	Текст		Да	Доменное имя для TLS-подключения к ITS
its.allow_diversion	Bool	true	Да	Включить обработку SIP-заголовка Diversion. Чтобы применить изменения настройки, необходимо перезапустить сервисы ITS

Ключ

Тип

Значение

По умолчанию

Описание

maintenance_mode

Bool

false

Да

Режим обслуживания: блокировка любых действий, которые изменяют данные, через веб-интерфейс администрирования / API

monitor.process_shutdown_duration

Длительность

60s

Да

Максимально допустимая длительность завершения процесса

monitor.reg_db_timeout

Длительность

Да

Таймаут подключения к внутренней базе данных сервиса

its.check_latency

Длительность

Да

Длительность задержки перед повторной проверкой состояния ITS после того, как в результате предыдущей проверки была получена ошибка

its.cache_cleanup_interval

Длительность

420s

Да

Частота очистки экземпляров ITS, определенных балансировщиком нагрузки для конкретного звонка

its.cache_expiration

Длительность

300s

Да

Длительность хранения экземпляра ITS, определенного балансировщиком нагрузки для конкретного звонка

its.get_services_info_interval

Длительность

900s

Да

Частота проверки состояния ITS

its.tls_certificate

UUID

00000000-0000-0000-0000-000000000000

Да

TLS-сертификат для подключения к ITS

its.tls_private_key

UUID

00000000-0000-0000-0000-000000000000

Да

Приватный ключ TLS для подключения к ITS

its.tls_domain

Текст

Да

Доменное имя для TLS-подключения к ITS

its.allow_diversion

Bool

true

Да

Включить обработку SIP-заголовка Diversion. Чтобы применить изменения настройки, необходимо перезапустить сервисы ITS

swl_report

Ключ	Тип	Значение	По умолчанию	Описание
dial_timeout	Длительность	5s	Да	Таймаут подключения к внешнему хранилищу

Ключ

Тип

Значение

По умолчанию

Описание

dial_timeout

Длительность

Да

Таймаут подключения к внешнему хранилищу

swl_status

Ключ	Тип	Значение	По умолчанию	Описание
load.ivaid_cache_reload_step	Длительность	86401s	Да	Интервал принудительного обновления кэша всех учетных записей IVA ID в памяти сервиса swl_status (помимо стандартных уведомлений об изменениях). Кэш используется для фильтрации событий, относящихся к учетным записям IVA ID, и последующей отправки их статусов через сервис swl_ivalink в сервис iva_presence для актуального отображения текущих статусов пользователей IVA ID в iva_presence

Ключ

Тип

Значение

По умолчанию

Описание

load.ivaid_cache_reload_step

Длительность

86401s

Да

Интервал принудительного обновления кэша всех учетных записей IVA ID в памяти сервиса swl_status (помимо стандартных уведомлений об изменениях). Кэш используется для фильтрации событий, относящихся к учетным записям IVA ID, и последующей отправки их статусов через сервис swl_ivalink в сервис iva_presence для актуального отображения текущих статусов пользователей IVA ID в iva_presence