Проект [[http://www.gnutelephony.org/index.php/GNU_SIP_Witch GNU SIP Witch]] позволяет напрямую связать несколько компьютеров, предоставив возможность прямой отправки и приёма SIP-звонков через интернет, без использования внешних SIP-сервисов и шлюзов, а также давая возможность соединения машин, доступ в сеть которых организован через транслятор адресов (NAT). Выступая в роли посредника, GNU SIP Witch может быть установлен как на локальной машине, на которой запускается SIP-клиент, так и на сервере, позволяя обеспечить работу сразу для нескольких машин в локальной сети. Все операции обработки и кодирования медиапотоков осуществляются на стороне SIP-клиента, GNU SIP Witch занимается лишь согласованием SIP-соединений, обеспечивает простейшие операции проброса канала связи до абонента и маршрутизации вызовов по URI-идентификаторам абонентов, что делает программу легковесной и не требовательной к ресурсам.

Рассмотрим процесс установки и настройки GNU SIP Witch в Ubuntu Linux для организации прямых звонков через интернет, используя такие SIP-клиенты, как Twinkle Softphone и SIP Communicator.

Установим GNU SIP Witch, который присутствует в стандартном репозитории Ubuntu и Debian:

   sudo apt-get install sipwitch sipwitch-plugin-forward

автоматически в систему будут установлены библиотеки libexosip2-4, libosip2-4, libsipwitch0 и libucommon2.

Конфигурация сервера:

Активируем в настройках плагин forward, если планируем задействовать функции для перенаправления соединений для Asterisk или FreeSwitch. В /etc/default/sipwitch заменяем

   PLUGINS="none"

на

   PLUGINS="forward"

или PLUGINS="auto" для загрузки всех доступных плагинов.

Добавляем себя в группу sipwitch:

   sudo usermod -aG sipwitch myname

++ Настройка регистратора SIP Witch

Основная конфигурация SIP Witch находится в файле /etc/sipwitch.conf, в котором описны настройки SIP-стека, план нумерации абонентов и маршрутизация.

Наиболее важные настройки в блоке <registry>:

<prefix> - задает дополнительный префикс локальной нумерации абонентов. Рассмотрим пример присвоения абонентам трехзначных номеров из диапазона 100-699. Блок <range> определяет диапазон доступных номеров. Блок <mapped> задает максимальное число пользовательских агентов, которые могут быть зарегистрированы на сервере.

   <prefix>100</prefix>
   <range>600</range>
   <mapped>700</mapped>

Если сервер планируется использовать для осуществления звонков в другие SIP-сети, например через задействование Asterisk или FreeSwitch, то следует указать параметр <realm>, который определит уникальный идентификатор сервера. Для осуществления вызова абонентов Asterisk в качестве realm нужно прописать значение, указанное в конфигурации sip.conf Asterisk-сервера, например:

   <realm>Asterisk</realm>

иначе, можно указать любой другой идентификатор.

++ Настройка SIP-стека

Рассмотрим блок <stack> в файле /etc/sipwitch.conf, в котором определяются такие параметры как сетевой интерфейс и номер порта для привязки. Большинство настроек можно оставить по умолчанию, обратить внимание стоит на параметры <mapped> и <localnames>.

В <mapped> задается марсимальное число одновременных телефонных вызовов, которое sipwitch может обработать. При превышении данного лимита попытки подключения приведут к выводу сигнала "занято". Для обеспечения возможности одновременной работы всех абонентов, с учетом того, что в каждом локальном вызове фигурирует два локальных номера, значение <mapped> можно установить как половину от величины <mapped> из секции <registry>.

В <localnames> задаются поддерживаемые имена хостов (аналогичные тем, что указаны в настройке "domain" VoIP-клиента twinkle), по умолчанию принимаются все имена.

Например:

   <localnames>sip.test.ru, server.local</localnames>

Для ограничения доступа к серверу только абонентов локальной сети, следует указать:

   <restricted>local</restricted>
   <trusted>local</trusted>

Список локальных подсетей можно указать в блоке <access>, например:

   <access>    
      <local>172.16.59.0/24</local>
   </access>

++ Настройка маршрутизации в SIP Witch

SIP Witch может использоваться для установки на несколько узлов, позволяя построить большую сеть, каждый сервер в которой обслуживает  абонентов со своей нумерацией (например, можно соединить территориально разнесенные офисы предприятия).

Указание информации о дополнительных серверах и задание правил перераправления вызовов производится в секции <routing>.

Например, для перенаправления обращений по номерам с 200 по 299 на другой SIP-сервер с именем server2.local можно использовать следующее правило:

   <routing>
     <redirect pattern="2xx" server="server2.local"/>
   </routing>

Для перенаправления обращений к номерам "3xx" на удаленный сервер можно использовать правило:

   <redirect pattern="3xx" target="sip:local@myserver.somewhere"/>

++ Резервирование номеров для заданных пользователей

Для привязки номеров к абонентам и определения их параметров в директории /etc/sipwitch.d следует создать файл c описанием абонентов. В простейшем виде создадим /etc/sipwitch.d/test.xml в котором заведем несколько номеров:

   <provision>
      <user id="логин1">
        <secret>пароль</secret>
        <extension>101</extension>
        <display>Отображаемое имя абонента 1</display>
      </user>
      <user id="логин2">
        <digest>хэш пароля</digest>
        <extension>102</extension>
        <display>Отображаемое имя абонента 2</display>
      </user>
    </provision>

В поле id указывается логический идентификатор пользователя, например можно указать логин или email. В поле secret/digest задается пароль/хэш для доступа. В поле extension указывается телефонный номер абонента. В поле display указывается имя которое будет отображаться при звонке. Перенаправление вызова можно указать через блок <forward>.
Для формирования хэша пароля можно использовать утилиту (-realm  можно не указывать, тогда будет использован realm текущего сервера):

   sipdigest -realm Реалм_сервера логин пароль

++ Управление сервисом SIP Witch

Запускаем sipwitch:

   sudo /etc/init.d/sipwitch start

Для управления сервисом нужно использовать команду sipwitch, например:

Вывод списка активных звонков:
   sipwitch calls

Список зарегистрировавшихся клиентов:

   sipwitch registry

Статус работы:

   sipwitch status

Статистика по обслуживаемым звонкам:

   sipwitch stats

Применение изменений в файлах конфигурации:

   sipwitch reload

++ Логи

В процессе работы создается три основных лога:

/var/log/sipwitch.log - лог для ошибок и системных событий
/var/log/sipwitch.stats - почасовая статистика звонков
/var/log/sipwitch.calls - полный список всех звонков

Для ротации логов в систему установлен файл /var/logrotate.d/sipwitch
Для формирования почасовой статистики используется скрипт /etc/cron.hourly/sipwitch

++ Подключение SIP-клиентов

Для осуществления звонков подойдет любой SIP-совместимый клиент, для примера настроим Twinkle:

   sudo apt-get install twinkle

В процессе заполнения профиля, указываем приведенный в секции <user id="xxx"> идентификатор (логин) в поле имени пользователя и имени аутентификации, в поле домена вводим sip.test.ru или server.local, в поле realm указываем содержимое поля <realm> (в нашем случае Asterisk). Во вкладке "безопасность" включаем шифрование ZRTP/SRTP.

Соединяемся и проверяем:

   sipwitch registry

    ext user  type profile    use expires address
    101 test1   user *   0    3580 127.0.0.1:5061
    found 1 entries active of 600

URL: http://www.gnutelephony.org/index.php/Howto_Deploy_SIP_Witch...
Обсуждается: http://www.opennet.dev/tips/info/2547.shtml