Удаленное управление настройками (Provisining)

Поддерживается только в версии Softphone.Pro 3.0

Используйте Provisioning для централизованного управления пользовательскими настройками Softphone.Pro.

Для начала работы потребуется:

1. Cоздать конфигурационный файл provisioning.ini на компьютере пользователя.

2. Установить Provisioning.

2. Настроить учетные записи и параметры конфигураций для пользователей в приложении Provisioning.

Создайте конфигурационный файл provisioning.ini.

Конфигурационный файл Provisioning.ini используется для управления настройками клиента с сервера и находится в папке с данными приложения:

C:\Users\[WINDOWS-USER]\AppData\Local\SoftphonePro
, где [WINDOWS-USER] - имя пользователя Windows.

Создайте файл Provisioning.ini и вставьте в него параметры:

[Features]
# 0 or 1
ProvisioningEnabled=1
[Urls]
LoginUrl=http://[SERVER]/[APP_URI]/login.php?login=%LOGIN%&password=%PASSWORD_HASH%

, где ProvisioningEnabled - параметр включения/выключения удаленного управления настройками, [SERVER] - адрес удаленного сервера, [APP_URI]- адрес приложения Provisioning.

Установите Provisioning.

Скачайте и установите Provisioning на удаленный сервер.

Настройте учетные записи пользователей.

Файл users.xml находится в директории приложения Provisioning и хранит данные учетной записи для входа в аккаунт Softphone.Pro для каждого пользователя.

Создайте учетную запись и укажите логин и пароль для авторизации в Softphone.Pro.

<?xml version="1.0" encoding="UTF-8"?>
<users>
    <user>
        <login>user1</login>
        <password>1234</password>
    </user>
    <user>
        <login>user2</login>
        <password>abcd</password>
    </user>
</users>

Используйте онлайн сервис для скачивания готового к работе дистрибутива Softphone.Pro с файлом конфигураций Provisionig.ini.
Перейдите по ссылке и укажите в полях формы для сборки готового дистрибутива:
в поле Версия укажите 3
в поле Provisioning.ini вставьте содержимое конфигурационного файла Provisioning.ini.
Далее следуйте инструкции по сборке, указанной на сайте Softphone.Pro.

Создайте настройки конфигураций на сервере для пользователей.

В папке configs/ приложения Provisioning для каждого пользователя создается файл [USER].ini ,где [USER] - логин пользователя. Файл повторяет настройки пользовательского конфигурационного файла SoftphonePro.ini.

[USER].ini имеет более высокий приоритет и перекрывает настройки из пользовательского файла SoftphonePro.ini. Чтобы сохранить пользовательское значение параметра, не включайте этот параметр в [USER].ini и не используйте ограничения (restrictions) для этой секции настроек.

Проверьте авторизацию пользователя.

Запустите SoftPhone.Pro. Появится диалоговое окно для входа в аккаунт.

Авторизация пользователя в Softphone.Pro

При успешной авторизации откроется главное окно Softphone.Pro.

Отображение возможных ошибок.

Если возникла ошибка при авторизации в диалоговом окне для входа появится сообщение с кодом и описанием ошибки.

Ошибка при авторизации

Возможные ошибки:

Код Описание
500 Некорректный формат запроса.
600 Неправильный логин или пароль.
700 Внутренняя ошибка сервиса.
701 Отсутствует конфигурация для данного пользователя.
702 Ошибка генерации конфигурации.

Шаблоны настроек конфигурации.

Используйте шаблоны для повторяющихся настроек в [USER].ini у пользователей. Шаблоны хранятся в папке templates/ приложения Provisining.

Для того, чтобы вставить шаблон в файл конфигурации пользователя [USER].ini, используйте:

{% include "template1.ini" %}

Ограничения настроек (Restrictions).

Используйте ограничения (restriction), чтобы скрыть секции из диалога пользовательских настроек в Softphone.Pro и пользовательского конфигурационного файла SoftphonePro.ini.