Ip Authentication with X-Telnyx-Token

In this article we will explain IP authentication with X-Telnyx-Token and when to use them.

David avatar
Written by David
Updated over a week ago

The Token setting can be found under the basic tab of your SIP Connections expert settings.


Why use an X-Telnyx-Token?

You could have an IP phone system with many clients. Telnyx allows you to create multiple IP connections that share the same IP in order to segregate your clients traffic.
​
If you apply a Token you need to make sure that your SIP INVITES include the configured Token in a custom header <X-Telnyx-Token>.
​
​Please note: The INVITES must come from an IP address configured on the same connection as the Token.

A screenshot of SIP Connection Options settings for Chicago.

What is an X-Telnyx-Token?

An X-Telnyx-Token is a string of characters configured to use as the Token in the expert settings of your IP authentication connection.

When you select the Token option, the portal will have a suggestion for the token to use. This suggestion is randomly generated using the connection's name.

For instance this is a suggestion for a connection named Chicago: Chicagoqwhowg6ze2d7o

You can instead use a custom string, if you'd prefer, but it must:

  • Contain only alphanumeric characters and dashes ("-")

  • Be between 12 and 48 characters

  • Be globally unique

Did this answer your question?