Домен
Данный ресурс предназначен для создания и управления доменами и их псевдонимами.
Поскольку платформа АТС является многодоменной, доменное имя является значимой частью полного имени добавочного. Полное имя добавочного состоит из префикса клиента, номера добавочного и домена и имеет следующий формат:
префикс_клиента*номер_добавочного@домен
Например, 001*100@sip.ringme.ru
Таким образом, при авторизации SIP-сообщения от добавочных, осуществляется, в том числе, и проверка доменного имени из SIP-поля From. Поскольку некоторые устройства посылают IP-адрес домена вместо доменного имени, существует возможность настроить псевдонимы домена. Дополнительно существуют инструменты для соотнесения запроса с нужным доменом исходя из IP-адреса источника запроса, независимо от того, что стоит в доменной части поля From, а также инструменты для соотнесения запроса с нужным доменом исходя из фактического содержимого доменной части присланного поля From. Порядок авторизации SIP-сообщений от добавочных описан ниже.
Порядок авторизации SIP-сообщений от добавочных
- Производится поиск добавочного по информации из поля From, домен из поля From соотносится c доменами системы.
- Если домен не был найден в предыдущем шаге, IP-адрес из поля From соотносится c псевдонимами доменов системы. Если совпадение найдено, то вычисляется фактический домен добавочного
- Если домен не был найден в предыдущем шаге, то IP-адрес источника запроса соотноситcя с Force Source доменов системы. Если совпадение найдено, то вычисляется фактический домен добавочного.
- Если домен не был найден в предыдущем шаге, то содержимое доменной части поля From соотноситcя с Force Destinations доменов системы. Если совпадение найдено, то вычисляется фактический домен добавочного.
- Производится авторизация запроса в соответствии с настройками добавочного.
Описание полей ресурса Домен (Domain)
Имя | Тип | Описание | Обязательное | Значение по умолчанию |
|---|---|---|---|---|
|
| Доменное имя. Не может быть изменено после создания домена. |
| |
|
| Уникальный префикс домена, должен представлять из себя стороку из 5 цифр. Префикс домена может быть использован для звонков клиентов разных доменов между собой. Для такого вызова необходимо набирать номер в формате префикс_домена*префикс_клиента*номер_добавочного |
| |
|
| Комментарий |
| null |
| id |
| Уникальный идентификатор домена. Поле только для чтения. |
| - |
Описание полей ресурса Псевдоним домена (Domain Alias)
Имя | Тип | Описание | Обязательное | Значение по умолчанию |
|---|---|---|---|---|
|
| Псевдоним домена, который может быть в поле From на месте домена. Может быть IP-адресом домена. | да | |
|
| Комментарий |
| null |
|
| Уникальный идентификатор алиаса домена. Поле только для чтения. |
| - |
Описание полей ресурса Force Source домена
| Имя | Тип | Описание | Обязательное | Значение по умолчанию |
|---|---|---|---|---|
|
| IP-адрес, запросы с которого будут считаться относящимися к данному домену. | да | |
|
| Комментарий |
| null |
|
| Уникальный идентификатор Force Source домена. Поле только для чтения. |
| - |
Описание полей ресурса Force Destination домена
| Имя | Тип | Описание | Обязательное | Значение по умолчанию |
|---|---|---|---|---|
|
| IP-адрес в поле From, который будет соотносить запрос с данным доменом. | да | |
|
| Комментарий |
| null |
|
| Уникальный идентификатор Forse Destination домена. Поле только для чтения. |
| - |
Ресурсы раздела "Администратор"
POST /admin/domain/
Добавить домен
Параметры JSON
Поля ответа
GET /admin/domain/
Получить список доменов
Параметры запроса
Имя | Тип |
|---|---|
|
|
|
|
|
|
|
|
Поля ответа
PUT /admin/domain/{domain_id}
Обновить домен
Параметры URL
Имя | Тип |
|---|---|
|
|
Параметры JSON
Поля ответа
GET /admin/domain/{domain_id}
Получить домен по его идентификатору
Параметры URL
Имя | Тип |
|---|---|
|
|
Поля ответа
DELETE /admin/domain/{domain_id}
Удалить домен
Параметры URL
Имя | Тип |
|---|---|
|
|
POST /admin/domain/{domain_id}/alias/
Добавить псевдоним домена
Параметры URL
Имя | Тип |
|---|---|
|
|
Параметры JSON
Поля ответа
GET /admin/domain/{domain_id}/alias/
Получить список псевдонимов домена
Параметры URL
Имя | Тип |
|---|---|
|
|
Поля ответа
PUT /admin/domain/{domain_id}/alias/{id
Обновить псевдоним домена
Параметры URL
Имя | Тип |
|---|---|
|
|
|
|
Параметры JSON
Поля ответа
GET /admin/domain/{domain_id}/alias/{id}
Получить псевдоним домена по его идентификатору
Параметры URL
Имя | Тип |
|---|---|
|
|
|
|
Поля ответа
DELETE /admin/domain/{domain_id}/alias/{id}
Удалить псевдоним домена
Параметры URL
Имя | Тип |
|---|---|
|
|
|
|
POST /admin/domain/{domain_id}/force_src/
Добавить force source домена
Параметры URL
Имя | Тип |
|---|---|
|
|
Параметры JSON
Поля ответа
GET /admin/domain/{domain_id}/force_src/
Получить список force source домена
Параметры URL
Имя | Тип |
|---|---|
|
|
Поля ответа
PUT /admin/domain/{domain_id}/force_src/{id}
Обновить force source домена
Параметры URL
Имя | Тип |
|---|---|
|
|
|
|
Параметры JSON
Поля ответа
GET /admin/domain/{domain_id}/force_src/{id}
Получить force source домена
Параметры URL
Имя | Тип |
|---|---|
|
|
|
|
Поля ответа
DELETE /admin/domain/{domain_id}/force_src/{id}
Удалить force source домена
Параметры URL
Имя | Тип |
|---|---|
|
|
|
|
POST /admin/domain/{domain_id}/force_dst/
Добавить force desination домена
Параметры URL
Имя | Тип |
|---|---|
|
|
Параметры JSON
Поля ответа
GET /admin/domain/{domain_id}/force_dst/
Получить список force desination домена
Параметры URL
Имя | Тип |
|---|---|
|
|
Поля ответа
PUT /admin/domain/{domain_id}/force_dst/{id}
Обновить force desination домена
Параметры URL
Имя | Тип |
|---|---|
|
|
|
|
Параметры JSON
Поля ответа
GET /admin/domain/{domain_id}/force_dst/{id}
Получить force desination домена
Параметры URL
Имя | Тип |
|---|---|
|
|
|
|
Поля ответа
DELETE /admin/domain/{domain_id}/force_dst/{id}
Удалить force desination домена
Параметры URL
Имя | Тип |
|---|---|
|
|
|
|