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?