====== Настройка публикации веб-сервиса 1С ======

Веб-сервис обеспечивает доступ панели телефонии к вашей базе клиентов. Когда поступит звонок с известного номера, имя клиента будет отображено в окне панели. Также веб-сервис обеспечивает доступ к списку сотрудников компании с их добавочными номерами и фотографиями (при наличии).

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

<note>Данное руководство предполагает наличие у читателя навыков установки настройки веб-сервера.</note>

===== Задачи: =====
  * [[nightbird:prepare-web-service#shag_1_opublikujte_veb-servis|Шаг 1. Опубликуйте веб-сервис]]
  * [[nightbird:prepare-web-service#shag_2_nastrojte_prava_dostupa_k_veb-servisu|Шаг 2. Настройте права доступа к веб-сервису]]
  * [[nightbird:prepare-web-service#shag_3_proverte_podkljuchenie|Шаг 3. Проверьте подключение]]
===== Шаг 1. Опубликуйте веб-сервис =====
Предварительно необходимо установить и настроить веб-сервер Apache или IIS ([[https://its.1c.ru/db/v8312doc#bookmark:adm:TI000000194|подробные инструкции]] можно найти в интернете или поставляемой к ним документации). При тестировании мы используем [[https://infostart.ru/public/646384/|инструкцию]].
О настройке защищенного соединения можно прочитать [[https://its.1c.ru/db/metod8dev/content/5978/hdoc|здесь]]. 
Не забудьте настроить правила брандмауэра:
  * Для АТС MikoPBX правило входящее на 80 порт
  * Дkя АТС Манго правило входящее на 80, 4222, 8222 портах

=== Для публикации веб-сервиса: ===
  - Запустите **конфигуратор** Вашей информационной базы от имени Администратора.
  - Откройте окно настройки **публикации на веб-сервере**, //Администрирование -> Публикация на веб-сервере//.
  - Укажите **имя** публикации под которым будет доступна информационная база (например, base1c). Имя следует указывать латиницей.
  - На вкладке Web-сервисы установите флажок напротив **Публиковать Web-сервисы расширений по умолчанию** {{ :nightbird:publikacija_bazy.png?nolink |}}
  - (для  ранних версий нужно установить флажок напротив **микоПровайдерAPI**). {{ :nightbird:2021-03-11_10-38-56.png?nolink |}}
  - Нажмите **Опубликовать** и согласитесь на вопрос о перезапуске веб-сервера.

===== Шаг 2. Настройте права доступа к веб-сервису =====
<note>Если вы уже установили подсистему телефонии 2.2, то данный раздел можно не проделывать, пользователь уже присутствует в конфигурации.</note> 

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

=== Для настройки доступа: ===
  - Откройте в конфигураторе **список пользователей**, //Администрирование -> Пользователи//.
  - Нажмите **добавить**.
  - Укажите **имя** нового пользователя (например, WebService). Имя следует указывать латиницей.
  - Введите произвольный **пароль**. Запомните его, он понадобиться позже.
  - Снимите флажок **"Показывать в списке выбора"**. {{ :nightbird:02-08-2018_15-02-41.png?nolink |}}
  - На вкладке **Прочие** установите флажок на против ролей **Телефония: Базовые права, Телефония: Веб сервисы**. {{ :nightbird:publikacija_bazy_polzovatel.png?nolink |}}
  - Нажмите **ОК** для сохранения изменений.

===== Шаг 3. Проверьте подключение =====
Необходимо проверить, что веб-сервер готов принимать обращения к опубликованному веб-сервису.

Для проверки подключения:
  - Откройте браузер на странице вида: <code>http://[АдресСервера]/[ИмяПубликации]/ws/miko_crm_api.1cws?wsdl</code>Для текущего примера ссылка будет иметь вид http://127.0.0.1/base1c/ws/miko_crm_api.1cws?wsdl.
  - На запрос авторизации укажите имя и пароль служебного пользователя, который был создан на предыдущем шаге.
  - Если все в порядке, то на экране будет сообщение: <code>Не указан заголовок управления сеансами или куки с идентификатором сеанса.</code> Оно говорит, что все в порядке, включен режим повторного использования сеансов для повышения быстродействия в работе веб-сервиса. Вместо сообщения возможно отображение XML представление веб-сервиса. {{ :nightbird:02-08-2018_15-51-30.png?nolink |}}