====== Proxy сервер МИКО ======

<note important>Инструкции составлены для **версии** MIKO Proxy **1.0.0.10+**. Для более старых версий следует выполнить [[astpanel:ast_miko_proxy|эти инструкции]]. </note>

===== Обзор Proxy сервер МИКО =====

Сервер «**PROXY**» или «**мультиплексирования**» написан на языке C# и позволяет организовать многоуровневую структуру взаимодействия 1С и IP АТС.

<note tip>Разработан специально для решений с большим количеством пользователей (20+) и сложной сетевой архитектурой</note>

Схема подключения описана на изображении ниже:
{{ :astpanel:proxy.png | Схема подключения МИКО Прокси сервера}}

Приложение "**МИКО Прокси сервер**" устанавливает соединение с телефонной станцией. По умолчанию используется порт 8088. 
В продукте "Панель телефонии для 1С" подключение настраивают не к АТС, а к прокси серверу, по умолчанию порт 8080. 
Сервер PROXY транслирует полученные события всем подключенным к нему клиентам (Панель телефонии). Не имеет ограничений на количество подключенных клиентов.

===== Установка =====

<note important>ПК, на который производится установка прокси сервера должен иметь **постоянный ip-адрес**.</note>

  - Скачайте приложение по [[https://files.miko.ru/s/wDlz8mIbbF18lkI | ссылке]]
  - Запустите файл **setup.exe** от **имени администратора**
  - Если файл запустить не удалось, то перейдите в свойства и измените режим совместимости, как показано на скриншотах ниже.\\ {{ :astpanel:001.png |}}\\ {{ :astpanel:002.png |}} 
  - У Вас должен запуститься **мастер первоначальной установки** МИКО Proxy сервера.\\ {{ :astpanel:1jf.png |}} 
  - На следующем шаге выберите **папку назначения**, в которую будет установлен МИКО Proxy сервер. По умолчанию он устанавливается в каталог: **C:\Program Files (x86)\MIKO LLC\Asterisk AJAM Proxy server**\\ {{ :astpanel:2jf.png |}}
  - Выполните команду "**Установить**".\\ {{ :astpanel:3yfy.png |}}
  - Результат успешной установки МИКО Proxy сервера выглядит следующим образом:\\ {{ :astpanel:4fyfy.png |}} 
  - Далее следует перейти к [[astpanel:ast_miko_proxy_v10#nastrojka|этапу настройки]].

===== Настройка =====

  - Перейдите в каталог, куда был установлен МИКО Proxy сервер (по умолчанию **C:\Program Files (x86)\MIKO LLC\Asterisk AJAM Proxy server**), в папку **Config**.
  - Отредактируйте конфигурационный файл **config_proxy.xml**. Описание секций в конфигурационном файле и правила его редактирования описаны [[astpanel:ast_miko_proxy_v10#opisanie_konfig_fajla|здесь]].  
  - Запустите службу **MIKO Asterisk AJAM Proxy server**  в оснастке Services(Службы) {{ :astpanel:5qwe.png |}} "**Тип запуска**" следует установить в значение "**Автоматически**".
  - Далее следует перейти к этапу [[astpanel:ast_miko_proxy_v10#proverka|Проверки]].

<note warning>Обязательно проверьте, что брандмауэр или антивирус не блокирует работу MIKO Proxy server.</note>

===== Описание конфиг. файла =====
<code>
<?xml version="1.0" encoding="UTF-8"?>
<root>
  <asteriskservers>
    <asteriskserver host="demo.askozia.ru" port="8088" prefix="asterisk" login="1cami" secret="PASSWORD1cami">asterisk</asteriskserver>
  </asteriskservers>
  <asterisk_proxy_port>8088</asterisk_proxy_port>
  <waitevent_timeout>15</waitevent_timeout>
  <log_level>3</log_level>
  <client_login>1cami</client_login>
  <client_secret>PASSWORD1cami</client_secret>
</root>
</code>

  * **asteriskserver host**- IP-адрес сервера Asterisk, на котором настроен AJAM протокол\\ \\ 
  * **asteriskserver port**- порт ajam интерфейса Asterisk, настроенный в http.conf\\ \\ 
  * **asteriskserver prefix** - префикс AJAM-интерфейса Asterisk, настроенный в http.conf\\ \\ 
  * **asteriskserver login** - имя пользователя Asterisk AMI, настроенное в manager.conf\\ \\ 
  * **asteriskserver secret** - пароль пользователя Asterisk AMI, настроенный в manager.conf\\ \\ 
  * **waitevent_timeout** - интервал в секундах для выполнения запроса на получение нового пакета событий от сервера Asterisk, по умолчанию 3\\ \\ 
  * **log_level** - режим отладки, при котором отладочная информация накапливается в папке Logs, директории установки сервиса. Есть 4 уровня логирвания, указывем порядковый номер от 0 до 3 (Error, Info, Verbose, Debug)\\ \\ 
  * **client_login** - имя пользователя для авторизации панели телефонии, это же имя указывается в настройках панели телефонии для 1С на вкладке **Телефонные станции**\\ \\ 
  * **client_secret** - пароль  пользователя для авторизации панели телефонии, это же имя указывается в настройках панели телефонии для 1С на вкладке **Телефонные станции**\\ \\ 
  * **asterisk_proxy_port** - порт, на котором прокси принимает запросы от панели телефонии для 1С.\\ \\ 


===== Проверка =====

Первым делом необходимо проверить, корректно ли настроен Asterisk:\\
Переходим в браузере по адресу:\\
[[http://<asteriskserver host>:<asteriskserver port>/<asteriskserver prefix>/rawman?action=login&username=<asteriskserver login>&secret=<asteriskserver secret>]]
  * **<asteriskserver login>**  - значение определено в конфигурационный файле прокси сервера
  * **<asteriskserver secret>** - значение определено в конфигурационный файле прокси сервера
  * **<asteriskserver host>** - значение определено в конфигурационный файле прокси сервера
  * **<asteriskserver port>** - значение определено в конфигурационный файле прокси сервера
  * **<asteriskserver prefix>** - значение определено в конфигурационный файле прокси сервера
Если в качестве результата получим строку:
<code>Response: Success
Message: Authentication accepted
</code>
То с настройкой АТС все в порядке.\\
Инструкции по настройке АТС доступны на [[astpanel:ats|Wiki]].

**Окончательная проверка**:
Переходим в браузере по адресу 
http://ipadress_proxy:asterisk_proxy_port/asterisk/rawman?action=login&username=client_login&secret=client_secret
  * **ipadress_proxy** - адрес ПК, где установлена служба прокси
  * **asterisk_proxy_port** - значение определено в конфигурационный файле прокси сервера
  * **client_login**  - значение определено в конфигурационный файле прокси сервера
  * **client_secret** - значение определено в конфигурационный файле прокси сервера
  * **asterisk_proxy_port** - значение определено в конфигурационный файле прокси сервера

Если в качестве результата получим следующую xml-структуру:
<code>
<ajax-response>
   <response type='object' id='unknown'>
     <generic response='Success' message='Authentication accepted' host='demo.askozia.ru' idenity='0' proxy='MikoProxyMode' />
   </response>
</ajax-response>
</code>
Значит со стороны "Прокси" все настроено правильно.
===== Подключение панели телефонии =====

Следует скорректировать настройки панели телефонии. Теперь она должна подключаться к **ip-адресу прокси сервера МИКО**.

  * "**Адрес Asterisk**" (Хост) - IP адрес прокси сервера. 
  * "**Порт AJAM**" - порт прокси сервера (**asterisk_proxy_port**). 
  * "**Логин AMI**" - имя пользователя прокси сервера (**client_login**).
  * "**Пароль AMI**" - пароль пользователя прокси сервера (**client_secret**). 

<note warning>Не путайте "**http прокси**" и "**МИКО прокси сервер**".  Это разные вещи!</note> 
===== Дополнительно =====

  * [[http://www.telefon1c.ru/products/#/tabProductsUsers/havyload | Пользователям. ]]
  * [[http://www.telefon1c.ru/products/#/tabProductsDevelopers/proxymiko|Разработчикам.]]
  * [[astpanel:ast_miko_proxy:proxymiko_filter|Фильтрация событий.]]
===== Комментарии =====
~~DISQUS~~