Domain
- Ilya Titaev
This resource is designed to create and manage domains and their aliases.
- 1 Authorization order for SIP messages from extensions
- 2 Description of the Domain resource fields
- 3 Description of the Domain Alias resource fields
- 4 Description of the domain Force Source resource fields
- 5 Description of the domain Force Destination resource fields
- 6 Resources section "Admin"
- 6.1 POST /admin/domain/
- 6.2 GET /admin/domain/
- 6.3 PUT /admin/domain/{domain_id}
- 6.4 GET /admin/domain/{domain_id}
- 6.5 DELETE /admin/domain/{domain_id}
- 6.6 POST /admin/domain/{domain_id}/alias/
- 6.7 GET /admin/domain/{domain_id}/alias/
- 6.8 GET /admin/domain/{domain_id}/alias/{id}
- 6.9 DELETE /admin/domain/{domain_id}/alias/{id}
- 6.10 POST /admin/domain/{domain_id}/force_src/
- 6.11 GET /admin/domain/{domain_id}/force_src/
- 6.12 PUT /admin/domain/{domain_id}/force_src/{id}
- 6.13 GET /admin/domain/{domain_id}/force_src/{id}
- 6.14 POST /admin/domain/{domain_id}/force_dst/
- 6.15 GET /admin/domain/{domain_id}/force_dst/
- 6.16 PUT /admin/domain/{domain_id}/force_dst/{id}
- 6.17 GET /admin/domain/{domain_id}/force_dst/{id}
- 6.18 DELETE /admin/domain/{domain_id}/force_dst/{id}
Because the PBX platform is multi-domain, the domain name is a meaningful part of the full extension name. The fully qualified extension name consists of the client prefix, extension number, and domain, and has the following format:
client_prefix*extension_number@domain
For example, 001*100@sip.ringme.ru
Thus, when authorizing a SIP message from extensions, the domain name is also checked from the SIP field “From”. Because some devices send a domain IP address instead of a domain name, it is possible to set up domain aliases. Additionally, there are tools for matching a request to the desired domain based on the IP address of the request source, regardless of what is in the domain part of the From field, as well as tools for matching the request to the desired domain based on the actual content of the domain part of the sent “From” field. The procedure for authorization of SIP messages from extensions is described below.
Authorization order for SIP messages from extensions
Searching for a header using information from the “From” field, matching the domain from the “From” field to the system domains.
If the domain was not found in the previous step, the IP address from the From field is matched against the system's domain aliases. If a match is found, then the actual extension domain is calculated.
If the domain was not found in the previous step, then the IP address of the request source is correlated with the Force Source of the system domains. If a match is found, then the actual extension domain is calculated.
If the domain was not found in the previous step, then the contents of the domain part of the “From” field correspond to the Force Destinations of the system domains. If a match is found, then the actual extension domain is calculated.
Authorization of the request in accordance with the settings of the extension.
Description of the Domain resource fields
Name | Type | Description | Required | Default value |
|---|---|---|---|---|
|
| Domain name. Cannot be changed after the domain has been created. | Yes |
|
|
| Unique domain prefix, must be a string of 5 digits. The domain prefix can be used for client calls from different domains to each other. For such call, dial a number in the format domain_prefix*client_prefix*extension_number | Yes |
|
|
| Comment | No | null |
|
| Unique domain id. Read only. | - | - |
Description of the Domain Alias resource fields
Name | Type | Description | Required | Default value |
|---|---|---|---|---|
|
| A domain alias, which can be in the “From” field in place of the domain. Can be a domain IP address. | Yes |
|
|
| Comment | No | null |
|
| Unique domain alias id. Read only. | - | - |
Description of the domain Force Source resource fields
Name | Type | Description | Required | Default value |
|---|---|---|---|---|
|
| IP address, requests from which will be considered related to this domain. | Yes |
|
|
| Comment | No | null |
|
| Unique domain Force Source id. Read only. | - | - |
Description of the domain Force Destination resource fields
Name | Type | Description | Required | Default value |
|---|---|---|---|---|
|
| The IP address in the “From” field that will map the request to this domain. | Yes |
|
|
| Comment | No | null |
|
| Unique domain Force Destination id. Read only. | - | - |
Resources section "Admin"
POST /admin/domain/
Create a new domain
JSON params
Response fields
GET /admin/domain/
Get a list of domains
Request parameters
Name | Type |
|---|---|
|
|
|
|
|
|
|
|
Response fields
PUT /admin/domain/{domain_id}
Update a domain
URL parameters
Name | Type |
|---|---|
|
|
JSON parameters
Response fields
GET /admin/domain/{domain_id}
Get a domain by its id
URL parameters
Name | Type |
|---|---|
|
|
Response fields
DELETE /admin/domain/{domain_id}
Delete a domain
URL parameters
Name | Type |
|---|---|
|
|
POST /admin/domain/{domain_id}/alias/
Add a domain alias
URL parameters
Name | Type |
|---|---|
|
|
JSON parameters
Response fields
GET /admin/domain/{domain_id}/alias/
Get a list of the domain aliases
URL parameters
Name | Type |
|---|---|
|
|
Response fields
PUT /admin/domain/{domain_id}/alias/{id}
Update a domain alias
URL parameters
Name | Type |
|---|---|
|
|
|
|
JSON parameters
Response fields
GET /admin/domain/{domain_id}/alias/{id}
Get a domain alias by its id
URL parameters
Name | Type |
|---|---|
|
|
|
|
Response fields
DELETE /admin/domain/{domain_id}/alias/{id}
Delete a domain alias
URL parameters
Name | Type |
|---|---|
|
|
|
|
POST /admin/domain/{domain_id}/force_src/
Add a domain force source
URL parameters
Name | Type |
|---|---|
|
|
JSON parameters
Response fields
GET /admin/domain/{domain_id}/force_src/
Get a list of domain force source
URL parameters
Name | Type |
|---|---|
|
|
Response fields
PUT /admin/domain/{domain_id}/force_src/{id}
Update a domain force source
URL parameters
Name | Type |
|---|---|
|
|
|
|
JSON parameters
Response fields
GET /admin/domain/{domain_id}/force_src/{id}
Get a domain force source
URL parameters
Name | Type |
|---|---|
|
|
|
|
Response fields
DELETE /admin/domain/{domain_id}/force_src/{id}
Delete a domain force source
URL parameters
Name | Type |
|---|---|
|
|
|
|
POST /admin/domain/{domain_id}/force_dst/
Add a domain force destination
URL parameters
Name | Type |
|---|---|
|
|
JSON parameters
Domain force destination fields
Response fields
Domain force destination fields
GET /admin/domain/{domain_id}/force_dst/
Get a list of domain force destination
URL parameters
Name | Type |
|---|---|
|
|
Response fields
Domain force destination fields
PUT /admin/domain/{domain_id}/force_dst/{id}
Update a domain force destination
URL parameters
Name | Type |
|---|---|
|
|
|
|
JSON parameters
Domain force destination fields
Response fields
Domain force destination fields
GET /admin/domain/{domain_id}/force_dst/{id}
Get a domain force destination
URL parameters
Name | Type |
|---|---|
|
|
|
|
Response fields
Domain force destination fields
DELETE /admin/domain/{domain_id}/force_dst/{id}
Delete a domain force destination
URL parameters
Name | Type |
|---|---|
|
|
|
|