Registering devices to Pexip Infinity
Pexip Infinity acts as a SIP registrar and H.323 gatekeeper. In addition to SIP and H.323 endpoints, Infinity Connect desktop clients and Infinity Connect Mobile clients for Android can also register to Pexip Infinity Conferencing Nodes. This allows Pexip Infinity to route outbound calls to those registered devices without having to go via a SIP proxy or H.323 gatekeeper, or rely on DNS.
Devices can only register to Pexip Infinity with a permitted alias and by supplying valid credentials (if authentication is required). Allowed aliases and their associated credentials can be configured manually, or they can be bulk provisioned from directory information contained in a Windows Active Directory LDAP server, or any other LDAP-accessible database
Note that devices do not need to be registered in order to make inbound calls to Pexip Infinity. However, you can configure Call Routing Rules so that only registered devices are allowed to make calls via the Pexip Distributed Gateway.
This topic covers:
- Configuration summary for enabling registrations
- How it works
- Configuring the registrar service
- Specifying the aliases that devices are allowed to register with
- Directory (phone book) of devices and VMRs for registered Infinity Connect clients
- Feature extensions via the external policy API
- Troubleshooting and logging
For end-user instructions on how to register a device, see
To configure Pexip Infinity to accept registrations and route calls to registered devices you must:
- Ensure that the Pexip Infinity's registrar service is enabled ( ).
- Configure the aliases that devices are allowed to register to Pexip Infinity ( ).
- Configure appropriate Call Routing Rules ( ). Rules are required in all cases except for when using Manual routing to add a participant to a conference.
Each step is described in more detail below, after the explanation of how Pexip Infinity manages registered devices.
The registrar service on Pexip Infinity is enabled by default. However, a device can only register to Pexip Infinity if the alias it wants to register has been added to Pexip Infinity's list of allowed device aliases ( ).
Device registrations can optionally also be subject to authentication. To enforce authentication, username and password credentials must be included when the alias is added to Pexip Infinity's list of allowed device aliases. When credentials have been included, the device's registration request will be challenged and the device will only be allowed to register with that alias if it provides matching credentials. Pexip Infinity supports Digest authentication only.
A device can register to any Conferencing Node. Pexip Infinity does not apply any form of registration load balancing or failover. Multiple devices can register with the same alias.
- To register a SIP device, use the IP address or FQDN of a local Conferencing Node as the SIP proxy.
To register an H.323 device, use the IP address or FQDN of a local Conferencing Node as the H.323 gatekeeper.
All of the device aliases presented in the H.323 registration request must be in the list of allowed device aliases. If any alias is not present, none of the aliases will be allowed to register. Additionally, if device authentication is being used, all of the aliases presented in the request must use the same credentials.
- If your endpoint supports SIP and H.323, you should register it to Pexip Infinity over just one protocol, either SIP or H.323, but not both.
To register an Infinity Connect client, ensure that either the IP address or FQDN of a local Conferencing Node, or the IP address or FQDN of the reverse proxy, is used as the registration server address (see About Infinity Connect client settings for more information).
Infinity Connect clients register over the WebRTC protocol.
When an Infinity Connect client is registered, as well as being able to receive calls, the user can filter and lookup the contact details (phone book / directory) of other devices or VMRs that are set up on the Pexip Infinity platform, making it easier to call those devices or VMRs. For more information, see Directory (phone book) of devices and VMRs for registered Infinity Connect clients.
After the device has registered it must periodically refresh that registration.
Whenever Pexip Infinity needs to place an outbound call (such as when adding a participant to a conference, or when making a call via the Pexip Distributed Gateway), it will first look through the set of devices currently registered to any of the Conferencing Nodes on the Pexip Infinity platform. If the alias it is trying to call is currently registered, then Pexip Infinity will place the call to that registered device.
When calling a registered device:
- the Conferencing Node to which the device is registered will place the call to the device (media may flow through other nodes, as per the platform's standard distributed conferencing behavior)
- the outbound call is always placed to the registered device over the same protocol that it used to make the registration
- if multiple devices are registered with the same alias, Pexip Infinity will place a call to each device, i.e. it will fork the call.
Requirement for Call Routing Rules
Note that, in most cases, you must also configure a suitable Call Routing Rule that instructs Pexip Infinity to place the outbound call (either to the registered device or to any other non-registered device or system). A Call Routing Rule is required when:
- making a call to another device or system via the Pexip Distributed Gateway
- using Automatic routing when adding a participant to a conference.
A Call Routing Rule is not required when:
- using Manual routing when adding a participant to a conference.
When configuring rules you must define:
- whether the rule applies only to incoming Pexip Distributed Gateway calls, or only to outgoing calls placed from within a Pexip Infinity conference (where Automatic routing has been selected), or to both incoming gateway calls and outgoing calls from conferences
- the destination aliases to be matched — this needs to match the pattern of the registered device aliases
- whether to route the call to Registered devices only (in which case the call will fail if the device is not currently registered), or to Registered device or external system which will route the call to a matching registered device if it is currently registered, otherwise it will attempt to route the call via an external system.
Call Routing Rules that are intended to route calls to devices registered to Pexip Infinity (e.g. Infinity Connect clients) could, depending upon DNS configuration, result in call looping if the destination device alias is not currently registered.
This can occur if the Call Routing Rule handling those calls has its Call target set to Registered device or external system. In this case, if the alias is not currently registered, Pexip Infinity will attempt to place the call via DNS or a call control system. This could result in the call being routed back to Pexip Infinity which would then match the same Call Routing Rule and result in a loop.
To avoid this, we recommend that you configure your Call Routing Rules that match the pattern of registered device aliases to use a Call target of Registered devices only. This ensures that the call will fail cleanly without looping if the device is not currently registered.
To avoid this, we recommend that you configure a Call target of Registered devices only for your Call Routing Rules that match registered device aliases. This ensures that the call will fail cleanly without looping if the device is not currently registered.
Note that in earlier versions of Pexip Infinity before the availability of the Registered devices only option, we previously recommended configuring a SIP proxy with an address of nowhere.invalid. This workaround will still avoid the call looping issue, but if you have any existing rules that use this method, we recommend modifying them to use a Call target of Registered devices only instead.
The stage in Pexip Infinity's call routing logic where it checks if a device is registered is highlighted in the following diagram:
Note that you can configure Call Routing Rules so that only registered devices are allowed to make calls via the Pexip Distributed Gateway.
Devices can only register to Pexip Infinity if the registrar service is enabled.
To configure Pexip Infinity's registrar service, go to . The options are:
Controls whether devices can register to Pexip Infinity. Devices must register with a permitted alias (configured via ).
The registrar service is enabled by default.
|Registration refresh (general)|
|Registration refresh strategy||
Defines which strategy to use when calculating the expiry time of a SIP or H.323 registration:
|Minimum refresh interval (Adaptive strategy)||
The minimum interval in seconds before a device's registration must be refreshed, when using the Adaptive strategy.
Default: 60 seconds.
|Maximum refresh interval (Adaptive strategy)||
The maximum interval in seconds before a device's registration must be refreshed, when using the Adaptive strategy.
Default: 3600 seconds.
|Minimum refresh interval (Basic strategy)||
The minimum interval in seconds before a device's registration must be refreshed, when using the Basic strategy.
Default: 60 seconds.
|Maximum refresh interval (Basic strategy)||
The maximum interval in seconds before a device's registration must be refreshed, when using the Basic strategy.
Default: 300 seconds.
|Registration refresh intervals for SIP endpoints behind NATs|
|Minimum refresh interval (when behind NAT)||
The minimum interval in seconds before a device's registration must be refreshed, for a SIP endpoint behind a NAT.
Default: 60 seconds.
|Maximum refresh interval (when behind NAT)||
The maximum interval in seconds before a device's registration must be refreshed, for a SIP endpoint behind a NAT.
The refresh interval for SIP endpoints behind a NAT typically has to be shorter than the interval for other endpoints. This is to help keep the NAT pinhole alive.
Default: 90 seconds.
- In all circumstances, requests for a value lower than the relevant Minimum refresh delay will result in the registration being rejected.
- The registration refresh strategies apply only to SIP and H.323 endpoints. Infinity Connect clients have a fixed refresh interval of 120 seconds.
Devices can only register to Pexip Infinity with a permitted alias.
You can bulk provision the device aliases from directory information contained in a Windows Active Directory LDAP server, or any other LDAP-accessible database. For more information, see Provisioning VMRs and devices from Active Directory via LDAP.
You can also import device aliases using a CSV file. For more information, see Bulk import/export of device aliases.
To manually configure the aliases that devices are allowed to register to Pexip Infinity, go to . The options are:
The alias URI with which the device must register to Pexip Infinity. The alias must be an exact match; regular expressions are not supported.
|Creation time||This read-only field shows the date and time at which this record was first configured.|
This optional field allows you to assign a unique identifier to this service, which you can then use to track use of the service.
|Description||An optional description of the device.|
|Username and Password||
The username and password credentials with which to authenticate the device. The credentials are optional and the device is not challenged if no credentials are entered.
The username and password are case-sensitive.
|Device origin||The name of the LDAP sync template used to create this device alias; if the device was created by manual input or via the API this will be blank. This field is read-only.|
|Owner's email address||
The email address of the owner of the device alias. Device provisioning messages associated with this alias will be sent to this address.
Pexip Infinity provides a directory search facility to all Infinity Connect clients that are registered to a Conferencing Node.
Upon request from the Infinity Connect client (typically when the user performs a search on their contact list), Pexip Infinity will return a list of device and conference aliases that match the search string entered by the user.
Pexip Infinity checks the supplied search string to see if it is contained within the alias or description of any of its configured services (Virtual Meeting Rooms, Virtual Auditoriums or Virtual Receptions), or within the device aliases that are allowed to register to Pexip Infinity (it does not matter if that device alias is currently registered or not, and no presence information is supplied).
Pexip Infinity returns up to 5 service aliases and up to 5 device aliases.
The directory service can be enabled or disabled via the Enable directory global setting ( ). It is enabled by default.
If you make use of the external policy API, the external system can be used to:
- determine whether a device alias is allowed to register to a Conferencing Node.
- obtain extended directory information — this can replace or be used in addition to the list of local device and VMR aliases supplied to registered Infinity Connect clients.
See Using external and local policy to control Pexip Infinity behavior for more information.
To see a list of all device aliases that are currently registered to the Pexip Infinity platform, go to .
Successful registration requests and expired registrations are recorded in the administrator log.
Failed registration requests (due to, for example, an unknown device alias or authorization failure) and refreshed registrations are recorded in the support log only.
If a call fails to be placed to a registered device, check that an appropriate Call Routing Rule has been configured that has suitable destination alias matching strings for the registered alias (and ensure that call looping cannot occur).