SIP Registration

Overview

SIP Registration is an authentication technique that allows your PBX to connect to the Skyetel network via a Username and Password instead of using IP Authentication. We recommend using IP Authentication over SIP Registration, but we know there are extenuating circumstances where that is not possible. 

Please read the limitations of SIP Registrations below prior to configuring your PBX.

SIP Registration Servers

Inbound Calling

Skyetel supports SIP registration in two regions for inbound calling:

nw1.reg.skyetel.com
se1.reg.skyetel.com

Our network will round robin these two regions with calls destined for your PBX, and so we recommend that you register to both trunks simultaneously. That way your PBX will be redundantly connected to our network, and will not be impacted by a fault in one of our regions. 

Outbound Calling

In order to send Skyetel outbound calls, you will need to create a third trunk using this record:

term.reg.skyetel.com

This will cause your PBX to round robin our gateways for outbound calling in the same way our regular term.skyetel.com configuration will. For added redundancy, you may configure your PBX to send outbound calls in this order:

Priority 1: term.reg.skyetel.com
Priority 2: nw1.reg.skyetel.com
Priority 3: se1.reg.skyetel.com

AuthEngine.io

If you need to hide the Skyetel DNS record from your customers/resellers, you may use these DNS records in lieu of the ones above:

nw1.reg.authengine.io
se1.reg.authengine.io
term.reg.authengine.io

These records will work exactly like their skyetel.com counterparts, and point to the same set of IPs. 

Single Region Registration

While we do not recommend this, it is possible to register your PBX to only one Skyetel SIP Registration Region. When you do this, all of your inbound and outbound calls will be processed through a single region. Please be aware that if you choose to do this, your connection to the Skyetel Network will not be redundant and will have a single point of failure. 

In order to do this successfully, you simply need to configure your PBX to use the region closest to your PBX (if you are in Seattle, use nw1.reg.skyetel.com or if you are in Georgia, use se1.reg.skyetel.com). You do not need to use the term.reg.skyetel.com configuration. 

SIP Credentials

Screen_Shot_2020-11-06_at_8.56.42_AM.pngYou can view your PBX's SIP Credentials in the new "SIP Credentials" view in the Endpoints section of our portal. From here, you can generate new credentials, modify existing ones, and associate a set of credentials to Tenants.

Creating Credentials

Screen_Shot_2020-11-06_at_9.01.00_AM.png

When you create a new set of SIP Credentials, our network will automatically create a Username and Password for you. It is not possible to create custom credentials. In the dialogue, make sure you copy and paste these credentials somewhere safe - it will not be possible to retrieve the Password after this dialogue is closed. 

Tenants

Associating a set of SIP Credentials to a Tenant will associate all of their Outbound traffic that terminate using this set of credentials. It will not associate Inbound traffic to the Tenant.  In order to associate inbound traffic to a Tenant, you must associate the end user's phone number to the Tenant. You can read more about that here (scroll down to the "Associating a phone number with a Tenant" section).

Call Routing

When you create a set of SIP Credentials, you will need to route your phone numbers to that set of SIP Credentials:

Screen_Shot_2020-11-09_at_12.53.47_PM.png

When your route your numbers this way, we will route all inbound calls to that set of SIP Credentials via Round Robin on our two SIP Registration Regions. (Friendly reminder - we recommend that you register to both SIP Registration regions - not just one)

Lets Talk Security

SIP registration is incredibly insecure, and should only be used in circumstances where IP Authentication (the preferred and default authentication method on the Skyetel Network) is impossible. In most PBXs, SIP Credentials are stored in plain text, and if your PBX gets compromised, it is possible for attackers to steal these credentials and use them to gain registration access to your PBX. 

Please note that if your SIP Credentials get compromised, and are used to generate fraudulent traffic, you will still be financially liable for the costs of that traffic - even if it did not originate from your PBX

Limitations

International Calling

The Skyetel SIP Registration gateways do not support High Cost (International) calling. Neither do our High Cost SIP Gateways support SIP Registration. If you have the need to place High Cost calls, you will need to switch to IP Authentication.

Channel Limits

The Skyetel SIP Registration gateways enforces a hard limit of 15 concurrent outbound calls per region - meaning you may only process a maximum of 30 outbound channels per SIP credential. It is not possible increase this limit. If you need more channels for your PBX, you will need to switch to IP Authentication.

PBXs Only

It is not possible to configure a desk-phone or smartphone to work with Skyetel's SIP Registration. Skyetel support will not be able to provide any support on getting a Softphone or Desk Phone to work via SIP Registration. 

UDP Only

SIP Registration only supports UDP. 

Port 5060 Only

SIP Registration only supports communication on UDP port 5060.

One PBX per Credential Set

When you register your PBX to the Skyetel Network via SIP Registration, we route based on the IP Address provided to us in the SIP Registration dialogue. Because of this, You can not register more than one PBX to Skyetel at a time using the same set of credentials. Each PBX should use its own set of credentials.

SIP Registration Timeouts

Skyetel's SIP Registration does not accept registration more frequently than 100 seconds, and automatically expires the registration in 300 seconds. Do not set your PBX to register more frequently than 100 seconds - doing so will cause your PBX to be blocked by our network.

You will see a 429 - Too Many Requests error when this occurs.

Endpoint Alerting is Unsupported

Due to the nature of SIP Registration Timeouts, Skyetel does not support endpoint alerts for PBXs registered via SIP Registration. 

 

Was this article helpful?
3 out of 3 found this helpful
Return to top