Описание файла sip.conf

Общие настройки sip.conf

Данные параметры используются в блоке [general]

  • allowexternalinvites: Если установлено 'no', запрещает INVITE и REFER от внешних (не из localnet) доменов. См domain
  • allowguest: Если 'no', запрещает гостевые(без аутентификации) подключения. По умолчанию sipguest подключения разрешены.
  • allowoverlap: Вкл. или Выкл набор по одной цифре (т.е. каждая набранная цифра будет сразу отправляться в канал)
  • allowsubscribe: Разрешить ли внешним устройствам подписку (SUBSCRIBE) на информацию о статусе екстеншена. По умолчанию - 'yes':
  • allowtransfers: Когда установлено 'no', запрещает любые трансферы, если не переопределено в настройках пира.
  • alwaysauthreject: Если включено, всегда отвечает на INVITE и REGISTER, SIP сообщением 401 Unauthorized, вместо того чтобы сообщить вызывающему о существовании запрашиваемого user или peer. Важная настройка безопасности
  • autodomain: Установите эту опцию 'yes', чтобы добавить локальное HOSTNAME и локальный IP адрес в список доменов:
  • bindaddr and bindport: Эти параметры определяют IP адрес и порт на которых Asterisk будет слушать SIP запросы. Для драйвера канала SIP Asterisk 'chan_sip' можно назначить только один адрес и порт для всех подключений для UDP и один порт для TCP транспорта, в отличии от нового драйвера PJSIP. По умолчанию адрес не задан и лучше так и оставить. Некоторые рекомендуют изменять порт по умолчанию 5060, на другой, в целях безопасности. Но помните, что это только одна из мер безопасности, не самая важная, и не гарантирует вам полной защиты от злоумышленников. Вы можете задать независимые для UDP, TCP и TLS транспорта значения udpbindadd, tcpbindaddr и tlsbindaddr
  • buggymwi: Вкл. эту опцию, чтобы избежать ошибок при сообщении с некоторыми ip телефонами при отправке MWI сообщений.
  • callevents: Установите 'yes', если хотите генерировать информацию о SIP событиях для AMI (asterisk manager interface)
  • checkmwi: Время в секундах, между проверками голосовой почты :
  • compactheaders: Использовать или нет компактные SIP заголовки.
  • defaultexpiry: Срок действия регистрации в секундах для входящих и исходящих регистраций. При входящей регистрации, этот параметр задается клиентской стороной, и заданное здесь значение используется, только если клиент не сообщил свое занчение. Для исходящих регистраций этот параметр сообщается удаленной стороне UAS (user agent server)
  • directrtpsetup: Данная опция позволяет управлять RTP соединением между двумя оконечными точками без re-INVITE(экспериментальная опция, используйте на свой страх и риск).
  • domain: Задает имя домена сервера Asterisk по умолчанию. Командой CLI 'sip show domains' выводится список локальных доменов.
  • dumphistory: Вкл. или Выкл. отчет в завершении SIP диалога. SIP history выводится в DEBUG лог канала.
  • externhost: Когда Asterisk находится за NAT, SIP заголовок обычно использует IP адрес сервера. Если включить данную опцию, Asterisk будет производить периодические DNS опросы для определения имени хоста и заменять IP адрес на 'externhost'.
  • externip: externip содержит IP алрес в качестве аргумента. Если Asterisk находится за NAT, SIP заголовок Contact: содержит внутренний IP адрес сервера, тогда удаленная сторона не знает куда отправлять ответы. Параметр externip вкупе с параметром nat=force_rport модифицирует SIP заголовок, сообщая удаленному SIP серверу адрес на который надо слать ответы:
  • externrefresh: Если все же используется 'externhost', указывает промежуток времени в секундах между запросами DNS.
  • g726nonstandard: Значения: yes/no, по умолчанию: no. Если клиент собирается для сеанса связи «договориться» использовать звуковой кодек G726-32, с использованием компрессии AAL2, вместо RFC3551 (что требуется для аппаратов фирмы Sipura и шлюзов от Grandstream, и может другим). То это противоречит спецификации RFC3551, клиент должен вместо этого «договориться» использовать AAL2-G726-32
  • ignoreregexpire (global): Если ignoreregexpire установлен 'yes', Asterisk сделает одно из двух, в зависимости от настроек пиров:
    • Non-realtime peer Когда регистрация истекает, информация не удаляется из памяти или БД Asterisk и вызовы будут разрешены несмотря на то, что время регистрации истекло.
    • Realtime peers Когда peer сконфигурирован в режиме реального времени, информация о регистрации используется независимо от defaultexpiry
  • jbenable: Вкл. поддержку RTP jitter buffer на принимающей стороне канала SIP. По умолчанию 'no'. Будет работать, только если удаленная сторона поддерживает эту функцию. подробнее о Джиттер
  • jbforce: Принудительное использование jitter buffer принимающей стороной SIP канала.
  • jbimpl: Использовать фиксированный или подстраиваемый (адаптивный) jitter buffer. fixed jitter buffer всегда использует значение из jbmaxsize adaptive может принимать значение больше jbmaxsize По умолчанию 'fixed':
  • jblog: Вкл./выкл jitter buffer frame лог. По умолчанию 'no':
  • jbmaxsize: Установите максимальную длину буфера в миллисекундах:
  • jbresyncthreshold: Джиттер буфер порог синхронизации. По умолчанию 1000:
  • icesupport: Использовать Interactive Connectivity Establishment (ICE) в Asterisk
  • limitonpeers: Применять call-limit только для type=peer Это улучшит использование call-limit для устройств настроенных, как type=friend, отделив ограничение call-limit от входящих вызовов.
  • localnet: укажет серверу Asterisk какие подсети являются локальными, прозрачными для использования IP адресов сервера, SIP запросы к которым не требуют модификации поля Contact: c использованием externip или externhost
  • matchexterniplocally: Сверять 'externip' с 'localnet' и производить подстановку, только если 'externip' из локальной подсети. Не совсем ясно, зачем это может понадобиться? Возможно при очень нестандартной топологии сети.
  • maxexpiry: Максимальная продолжительность регистрации в секундах.
  • minexpiry: Минимальная продолжительность регистрации в секундах.
  • notifymimetype: Указывает MIME тип используемый для message-waiting indication (MWI) в SIP NOTIFY сообщении.
  • notifyringing: Сообщать подписчикам о состоянии вызов (RINGING):
  • notifyhold: Сообщать подписчикам (subscribers) о состоянии удержание (HOLD):
  • pedantic: Скурпулезная проверка SIP сообщений. Устанавливает более строгую проверку по стандартам SIP RFC.
  • realm: Данная установка используется для аутентификации в SIP. Задайте realm полное доменное имя вашего сервера. Имя должно быть совершенно уникальным.
  • recordhistory: Вкл. или Выкл историю sip для всех каналов.
  • registerattempts: Сколько попыток внешних регистраций произведет Asterisk, прежде чем откажется от продолжения. По умолчанию стоит '0', что значит бесконечно.
  • registertimeout: Таймаут между попытками регистрации на другом устройстве.
  • relaxdtmf: Если плохо распознаются DTMF сигналы, включите данную опцию.
  • rtautoclear (global): Конфигурация Realtime Peers Указывает должен ли Asterisk обнулять созданные на лету friends по истечении времени регистрации. Если установлено 'yes', по истечении срока регистрации, удалять friends до нового запроса. Если задано число, то оно используется вместо обычного времени регистрации.
  • rtcachefriends(global):Если rtcachefriends включен, Asterisk будет кэшировать friends(реалтайм пиры), которые приходят из realtime engine, так же, как если бы они сконфигурированы в «sip.conf».
  • rtsavesysname(global): Определяет, должен ли Asterisk сохранить SystemName в базе данных в режиме реального времени во время регистрации:
  • rtupdate(global): Если установлено 'yes' Asterisk будет обновлять IP-адрес, порт и период регистрации пиров при регистрации. По умолчанию 'yes':
  • sipdebug: Указывает, должен или нет Asterisk включать SIP debug сразу при загрузке драйвера канала SIP.
  • sendrpid: Отправлять или нет Remote-Party-ID header:
  • srvlookup: Записи DNS SRV являются одним из способов указания адреса для связи сервером. Используя записи SRV, вы получаете многие преимущества DNS, в то время как отключения SRV DNS лишает вас возможности принимать SIP вызовы на основании доменных имен. В настоящее время поддержка записей SRV в Asterisk несколько хромает. Если несколько записей SRV возвращаются, Asterisk будет использовать только первую запись. Чтобы включить, установите srvlookup = yes в секции [general] файла sip.conf:
  • transport: Задает транспорт по умолчанию. По умолчанию 'udp', но может быть 'tcp', 'tls', 'ws' или 'wss'. Если задано TCP а tcpenable=no будет использован UDP транспорт.
  • tcpenable: Включить поддержку TCP транспорта chan_sip Asterisk.
  • tcpbindaddr: Адрес на котором Asterisk «слушает» TCP подключения.
  • tcpauthtimeout: Указывает максимальное время в секундах данное клиенту на аутентификацию. Если за заданное время клиент не прошел проверку он отключается. (По умолчаннию 30 секунд)
  • tcpauthlimit: Максимальное кол-во неаутентифицированных сессий в момент любой времени.
  • t1min: Минимальная задержка туда-обратно (minimum round-trip) для сообщения контролируемого хоста. По умолчанию 100 миллисеунд:
  • subscribecontext: Ограничить запросы SUBSCRIBE только указанным контекстом, если не переопределено в настройках пира.
  • t38pt_udptl: Установка t38pt_udptl 'yes' вкл. T.38 fax (UDPTL) насквозь (passthrough) для SIP-to-SIP вызовов с поддержкой T.38. Эта настройка включается глобально для всех устройств, но вы можете отключить её для конкретного устройства. T.38 fax passthrough работает только для SIP-to-SIP вызовов, любые local или agent каналы не могут быть использованы. tos_sip, tos_audio, andtos_video Asterisk может установить TOS bits в IP заголовках для помощи маршрутизаторам приотеризации трафика. tos_sip, tos_audio, и tos_video установки управляют TOS битами для SIP сообщений, RTP аудио и RTP видео, соответственно. Поддерживаются: CS0, CS1, CS2, CS3, CS4, CS5, CS6, CS7, AF11, AF12, AF13, AF21, AF22, AF23, AF31, AF32, AF33, AF41, AF42, AF43. Можно также использовать цифровые значения для TOS битов.
  • trustrpid: Доверять или нет Remote-Party-ID header: Asterisk SIP trustrpid
  • useragent: Значение поля useragent в SIP заголовке. По умолчанию версия Asterisk:
  • usereqphone: Опция говорит Asterisk добавить «user=phone» в SIP URIs которые содержат действующий номер телефона:
  • videosupport(both): Вкл. или выкл поддержку видео.

Настройки пиров в sip.conf

Для asterisk нет понятия внутреннего и внешнего абонента, все вызовы совершаются через каналы.

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

[имя_пира]
type=peer, user или friend
параметр1=значение
параметр2=значение

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

  • peer: SIP пир, который Asterisk может использовать для совершения исходящих вызовов.
  • user: SIP пир, для входящих вызовов Asterisk
  • friend: Запись, которая одновременно и user и peer. Этот тип наиболее подходит для телефонов и других устройств. Для SIP пользователей этого типа Asterisk создаст два объекта, один типа peer и один типа user, с одинаковыми именами.

Ниже приведены некоторые опции:

  • accountcode: Пользователь может быть ассоциирован с неким кодом доступа (accountcode). Используется для билинга.
  • allow - disallow: Разрешенные и запрещенные кодеки.
  • amaflags: Категория для CDR записей. Можно выбрать: default, omit, billing, documentation. Смотри: билинг в Asterisk.
  • allowoverlap: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: yes. Установка в "no" запрещает поддержку "overlap dialing".
  • allowsubscribe: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no. Установка в "no" запрещает отслеживание состояние (subscriptions) данного клиента.
  • allowtransfer: Начиная с версии 1.4.x. Разрешить (yes) или запретить (no) перевод вызова для этого пользователя.
  • auth: Начиная с версии 1.4.x. Ссылка на запись из секции [authentication] (только для типа peer).
  • autoframing: Начиная с версии 1.4.x. Включение (yes) или выключение (no) autoframing'a.
  • buggymwi: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no. Cisco SIP firmware не полностью поддерживает RFC для индикации наличия новой голосовой почты (MWI). Установите значение этого параметра в "yes", чтобы не получать сообщения об ошибке, при отправке MWI телефонам с данной проблемой.
  • callgroup: Определяет группу вызовов (call group) для вызовов через это устройство.
  • callingpres: Начиная с версии 1.4.x. Режим публикации CallerId, значения смотри в файле doc/callingpres.txt из дистрибутива asterisk.
  • call-limit: Начиная с версии 1.4.x__. Ограничение на кол-во вызовов для пользователя. Для типа "peer" - на исходящие, для "user" - на входящие.
  • canreinvite: Включайте, если только на клиенте поддерживается функция: SIP re-invites.
  • cid_number: Начиная с версии 1.4.x. Номерная часть поля CallerID.
  • context: Контекст плана набора, в который попадают вызовы, поступающие от данного клиента.
  • defaultip: IP адрес клиента по умолчанию, когда host= определен, как DYNAMIC. Используется, если клиент еще не зарегистрировался, при необходимости его вызова.
  • dtmfmode: Как клиент обрабатывает сигнализацию DMTF?.
  • fromuser: Указываем имя пользователя для поля "from", когда происходит вызов с использованием этой записи.
  • fromdomain= : Установка домена по умолчанию в поле From:, SIP сообщений, когда происходит вызов с использованием этой записи.
  • fullname: Начиная с версии 1.4.x. Часть с именем, поля CallerID.
  • g726nonstandard: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no. Если клиент собирается для сеанса связи "договориться" использовать звуковой кодек G726-32, с использованием компрессии AAL2, вместо RFC3551 (что требуется для аппаратов фирмы Sipura и шлюзов от Grandstream, и может другим). То это противоречит спецификации RFC3551, клиент _должен_ вместо этого "договориться" использовать AAL2-G726-32 :-(
  • host: Как нам найти нашего клиента - IP адрес или имя хоста. Если Вам нужно, чтоб телефон самостоятельно зарегистрировался, используйте значение dynamic вместо IP адреса или имени хоста.
  • incominglimit and outgoinglimit: Ограничение на число одновременных соединений с нашим SIP клиентом. Эти параметры устарели, в версии 1.4.x - не используются.
  • insecure: very|yes|no|invite|port : Определяет как обрабатывать соединения с пирами. По-умолчанию значение 'no' (аутентификация для всех соединений включена). (invite и port добавлено в версии 1.2.x).
  • language: Код языка, которые определены в файле indications.conf? - где определяется язык приветствий и специфичные для каждой страны настройки сигналов телефонов.
  • mailbox: Екстеншен голосового ящика (для работы индикатора новых сообщений)
  • maxcallbitrate: Начиная с версии 1.4.x. Максимальный битрейт для видео в kbit/s. По умолчанию: 384 kbit/s.
  • mohsuggest: Начиная с версии 1.4.x. Назначение см. в sip.conf.
  • md5secret: MD5-Hash строки: ":asterisk:" (может использоваться вместо параметра secret).
  • musiconhold: Устанавливает класс музыки ожидания (musiconhold) для вызовов с данного SIP телефона. Для вызовов, которые поступают на данный телефон, задание этого класса необходимо делать командой SetMusicOnHold, расположенной выше по приоритету (меньшее значение приоритета в плане набора), чем команда Dial в плане набора. Параметр MusicOnHold устанавливается для совершаемых вызовов, а не для телефонов, и если для обработки вызова для екстеншена используется команда SetMusicOnHold, то она переопределит, заданное этим параметром значение, для этого вызова.
  • nat: Эта переменная изменяет образ действия сервера Asterisk для клиентов находящихся за файрволом с трансляцией адресов (NAT). Но этот параметр не решает проблемы, если сам Asterisk находится за таким файрволом, а клиент снаружи (в сети internet с нормальным IP адресом).
  • outboundproxy: Адрес прокси сервера для исходящих вызовов (только для типа peer).
  • permit, deny: Ограничения по IP адресу и IP сети для клиента. Примечание: в версии 1.4.x параметр mask уже не используется.
  • pickupgroup: Группа для "pickup" вызовов поступающих вашим сослуживцам, используя комбинацию "*8" и приложение Pickup() для работы с екстеншеном *8.
  • port: SIP порт клиента.
  • progressinband: Начиная с версии 1.4.x. Значения: yes/no/never, по умолчанию: never. Должен ли asterisk генерировать самостоятельно звуковой сигнал вызова для вызывающего абонента (in-band ringing). Используйте значение 'never', чтобы никогда не производилась генерация этого сигнала, даже в случае, когда некоторые странные устройства не могут генерировать его самостоятельно.
  • promiscredir: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no. Если установлено в значение "yes", то этим мы разрешаем отправлять SIP сообщения с кодом 302 или сообщения для переадресации вызова, для SIP клиентов с не локальными IP адресами. Стоит отметить, что поведение promiscredir при совершении переадресации вызова, который производиться в локальной системе, может привести к зацикливанию вызова, т.к. Asterisk не умеет обрабатывать "hairpin" вызовы.
  • qualify: Периодическая проверка доступности клиента.
  • restrictcid: (yes/no) Этот параметр не используется, вместо него используйте callingpres.
  • rfc2833compensate: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no. Включение компенсации передачи DTMF сигналов с других серверов asterisk версии до 1.4.*. В данных случаях, Вы должны включить эту функцию или прием DTMF сигналов не будет работать должным образом.
  • rtptimeout: Прерывать вызов, если нет активности RTP медиапотока более чем x секунд и если линия не находиться в режиме удержания (hold).
  • rtpholdtimeout: Прерывать вызов, если нет активности RTP медиапотока более чем x секунд, в режиме удержания линии (hold) (значение должно быть больше, чем rtptimeout)
  • secret: Если Asterisk выступает в роли SIP сервера, тогда данный SIP клиент должен автризироваться с данным паролем (shared secret). Если же Asterisk выступает в роли SIP клиента, работающим с удаленным SIP сервером, для которого требуется авторизация для запросов "SIP INVITE", тогда это поле будет использовано для авторизации в сообщениях "SIP INVITE", которые наш Asterisk будет отправлять удаленному SIP серверу.
  • sendrpid: Отправлять или нет заголовок Remote-Party-Id? этому SIP клиенту. Значения: yes/no, по умолчанию: yes.
  • setvar: Начиная с версии 1.4.x. В значении указывается пара "переменная=значение" для переменной канала, при вызовах с данного девайса.
  • subscribecontext: Начиная с версии 1.4.x. Указывается название контекста, в котором будут обрабатываться SIP запросы SUBSCRIBE.
  • subscribemwi: Начиная с версии 1.4.x. Значения "yes" и "no". Назначение см. sip.conf.
  • t38pt_udptl: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no. Включить/выключить поддержку T.38 для данного клиента.
  • trustrpid: Значения: yes/no, по умолчанию: no. Устанавливается в "yes", если можно доверять полученному от SIP клиента Remote-Party-ID.
  • type: Тип клиента - только исходящие вызовы, только входящий или все вместе?
  • useclientcode: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no.
  • usereqphone: Начиная с версии 1.4.x. Значения "yes" и "no". Добавить или нет ";user=phone" в URI, которое содержит нормальный вызываемый номер.
  • username: Если Asterisk выступает в роли SIP клиента, работающим с удаленным SIP сервером, для которого требуется авторизация для запросов "SIP INVITE", тогда это поле будет использовано для авторизации в сообщениях "SIP INVITE", которые наш Asterisk будет отправлять удаленному SIP серверу. А также, для пиров, которые регистрируются на нашем сервере Asterisk, если это имя пользователя используется в сообщениях INVITE, до тех пор, пока он зарегистрирован на сервере.
  • videosupport: Значения: yes/no, по умолчанию: yes. Параметр для включения поддержки SIP видео. Вам может понадобиться включить поддержку видео для конкретного SIP клиента, если, например, в глобальной части конфигурации она выключена, и Вы хотите выборочно ее включить только для конкретных пользователей.
  • vmexten: Начиная с версии 1.4.x. Назначение см. sip.conf (только для типа peer). accountcode: Пользователь может быть ассоциирован с неким кодом доступа (accountcode). Используется для билинга.
  • allow - disallow: Разрешенные и запрещенные кодеки.
  • amaflags: Категория для CDR записей. Можно выбрать: default, omit, billing, documentation. Смотри: билинг в Asterisk.
  • allowoverlap: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: yes. Установка в "no" запрещает поддержку "overlap dialing".
  • allowsubscribe: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no. Установка в "no" запрещает отслеживание состояние (subscriptions) данного клиента.
  • allowtransfer: Начиная с версии 1.4.x. Разрешить (yes) или запретить (no) перевод вызова для этого пользователя.
  • auth: Начиная с версии 1.4.x. Ссылка на запись из секции [authentication] (только для типа peer).
  • autoframing: Начиная с версии 1.4.x. Включение (yes) или выключение (no) autoframing'a.
  • buggymwi: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no. Cisco SIP firmware не полностью поддерживает RFC для индикации наличия новой голосовой почты (MWI). Установите значение этого параметра в "yes", чтобы не получать сообщения об ошибке, при отправке MWI телефонам с данной проблемой.
  • callgroup: Определяет группу вызовов (call group) для вызовов через это устройство.
  • callingpres: Начиная с версии 1.4.x. Режим публикации CallerId, значения смотри в файле doc/callingpres.txt из дистрибутива asterisk.
  • call-limit: Начиная с версии 1.4.x__. Ограничение на кол-во вызовов для пользователя. Для типа "peer" - на исходящие, для "user" - на входящие.
  • canreinvite: Включайте, если только на клиенте поддерживается функция: SIP re-invites.
  • cid_number: Начиная с версии 1.4.x. Номерная часть поля CallerID.
  • context: Контекст плана набора, в который попадают вызовы, поступающие от данного клиента.
  • defaultip: IP адрес клиента по умолчанию, когда host= определен, как DYNAMIC. Используется, если клиент еще не зарегистрировался, при необходимости его вызова.
  • dtmfmode: Как клиент обрабатывает сигнализацию DMTF?.
  • fromuser: Указываем имя пользователя для поля "from", когда происходит вызов с использованием этой записи.
  • fromdomain= : Установка домена по умолчанию в поле From:, SIP сообщений, когда происходит вызов с использованием этой записи.
  • fullname: Начиная с версии 1.4.x. Часть с именем, поля CallerID.
  • g726nonstandard: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no. Если клиент собирается для сеанса связи "договориться" использовать звуковой кодек G726-32, с использованием компрессии AAL2, вместо RFC3551 (что требуется для аппаратов фирмы Sipura и шлюзов от Grandstream, и может другим). То это противоречит спецификации RFC3551, клиент _должен_ вместо этого "договориться" использовать AAL2-G726-32 :-(
  • host: Как нам найти нашего клиента - IP адрес или имя хоста. Если Вам нужно, чтоб телефон самостоятельно зарегистрировался, используйте значение dynamic вместо IP адреса или имени хоста.
  • incominglimit and outgoinglimit: Ограничение на число одновременных соединений с нашим SIP клиентом. Эти параметры устарели, в версии 1.4.x - не используются.
  • insecure: very|yes|no|invite|port : Определяет как обрабатывать соединения с пирами. По-умолчанию значение 'no' (аутентификация для всех соединений включена). (invite и port добавлено в версии 1.2.x).
  • language: Код языка, которые определены в файле indications.conf? - где определяется язык приветствий и специфичные для каждой страны настройки сигналов телефонов.
  • mailbox: Екстеншен голосового ящика (для работы индикатора новых сообщений)
  • maxcallbitrate: Начиная с версии 1.4.x. Максимальный битрейт для видео в kbit/s. По умолчанию: 384 kbit/s.
  • mohsuggest: Начиная с версии 1.4.x. Назначение см. в sip.conf.
  • md5secret: MD5-Hash строки: ":asterisk:" (может использоваться вместо параметра secret).
  • musiconhold: Устанавливает класс музыки ожидания (musiconhold) для вызовов с данного SIP телефона. Для вызовов, которые поступают на данный телефон, задание этого класса необходимо делать командой SetMusicOnHold, расположенной выше по приоритету (меньшее значение приоритета в плане набора), чем команда Dial в плане набора. Параметр MusicOnHold устанавливается для совершаемых вызовов, а не для телефонов, и если для обработки вызова для екстеншена используется команда SetMusicOnHold, то она переопределит, заданное этим параметром значение, для этого вызова.
  • nat: Эта переменная изменяет образ действия сервера Asterisk для клиентов находящихся за файрволом с трансляцией адресов (NAT). Но этот параметр не решает проблемы, если сам Asterisk находится за таким файрволом, а клиент снаружи (в сети internet с нормальным IP адресом).
  • outboundproxy: Адрес прокси сервера для исходящих вызовов (только для типа peer).
  • permit, deny: Ограничения по IP адресу и IP сети для клиента. Примечание: в версии 1.4.x параметр mask уже не используется.
  • pickupgroup: Группа для "pickup" вызовов поступающих вашим сослуживцам, используя комбинацию "*8" и приложение Pickup() для работы с екстеншеном *8.
  • port: SIP порт клиента.
  • progressinband: Начиная с версии 1.4.x. Значения: yes/no/never, по умолчанию: never. Должен ли asterisk генерировать самостоятельно звуковой сигнал вызова для вызывающего абонента (in-band ringing). Используйте значение 'never', чтобы никогда не производилась генерация этого сигнала, даже в случае, когда некоторые странные устройства не могут генерировать его самостоятельно.
  • promiscredir: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no. Если установлено в значение "yes", то этим мы разрешаем отправлять SIP сообщения с кодом 302 или сообщения для переадресации вызова, для SIP клиентов с не локальными IP адресами. Стоит отметить, что поведение promiscredir при совершении переадресации вызова, который производиться в локальной системе, может привести к зацикливанию вызова, т.к. Asterisk не умеет обрабатывать "hairpin" вызовы.
  • qualify: Периодическая проверка доступности клиента.
  • restrictcid: (yes/no) Этот параметр не используется, вместо него используйте callingpres.
  • rfc2833compensate: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no. Включение компенсации передачи DTMF сигналов с других серверов asterisk версии до 1.4.*. В данных случаях, Вы должны включить эту функцию или прием DTMF сигналов не будет работать должным образом.
  • rtptimeout: Прерывать вызов, если нет активности RTP медиапотока более чем x секунд и если линия не находиться в режиме удержания (hold).
  • rtpholdtimeout: Прерывать вызов, если нет активности RTP медиапотока более чем x секунд, в режиме удержания линии (hold) (значение должно быть больше, чем rtptimeout)
  • secret: Если Asterisk выступает в роли SIP сервера, тогда данный SIP клиент должен автризироваться с данным паролем (shared secret). Если же Asterisk выступает в роли SIP клиента, работающим с удаленным SIP сервером, для которого требуется авторизация для запросов "SIP INVITE", тогда это поле будет использовано для авторизации в сообщениях "SIP INVITE", которые наш Asterisk будет отправлять удаленному SIP серверу.
  • sendrpid: Отправлять или нет заголовок Remote-Party-Id? этому SIP клиенту. Значения: yes/no, по умолчанию: yes.
  • setvar: Начиная с версии 1.4.x. В значении указывается пара "переменная=значение" для переменной канала, при вызовах с данного девайса.
  • subscribecontext: Начиная с версии 1.4.x. Указывается название контекста, в котором будут обрабатываться SIP запросы SUBSCRIBE.
  • subscribemwi: Начиная с версии 1.4.x. Значения "yes" и "no". Назначение см. sip.conf.
  • t38pt_udptl: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no. Включить/выключить поддержку T.38 для данного клиента.
  • trustrpid: Значения: yes/no, по умолчанию: no. Устанавливается в "yes", если можно доверять полученному от SIP клиента Remote-Party-ID.
  • type: Тип клиента - только исходящие вызовы, только входящий или все вместе?
  • useclientcode: Начиная с версии 1.4.x. Значения: yes/no, по умолчанию: no.
  • usereqphone: Начиная с версии 1.4.x. Значения "yes" и "no". Добавить или нет ";user=phone" в URI, которое содержит нормальный вызываемый номер.
  • username: Если Asterisk выступает в роли SIP клиента, работающим с удаленным SIP сервером, для которого требуется авторизация для запросов "SIP INVITE", тогда это поле будет использовано для авторизации в сообщениях "SIP INVITE", которые наш Asterisk будет отправлять удаленному SIP серверу. А также, для пиров, которые регистрируются на нашем сервере Asterisk, если это имя пользователя используется в сообщениях INVITE, до тех пор, пока он зарегистрирован на сервере.
  • videosupport: Значения: yes/no, по умолчанию: yes. Параметр для включения поддержки SIP видео. Вам может понадобиться включить поддержку видео для конкретного SIP клиента, если, например, в глобальной части конфигурации она выключена, и Вы хотите выборочно ее включить только для конкретных пользователей.
  • vmexten: Начиная с версии 1.4.x. Назначение см. sip.conf (только для типа peer).

Настройка SIP по шаблону

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

[template](!)
host=dynamic
type=friend
context=internal
nat=no
disallow=all
allow=ulaw
allow=alaw
permit=192.168.1.0/255.255.255.0

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

[101](template)
username=101
secret=P@sswoRd
callerid=101
[102](template)
username=102
secret=P@sswoRd
callerid=102