Skip to main content

​
Architecture

We will construct the following architecture. Azure Architecture

​
Prerequisites

​
Create ExpressRoute Circuit

This step is performed on Azure. Azure Prerequisite 1 Azure Prerequisite 2
ParameterValue
RegionChoose the matching available region from the VXC coverage API
Port TypeProvider
ProviderEquinix
Peering locationmatching available region from the VXC coverage API
BandwidthChoose the available bandwidth from the VXC coverage API
SKUStandard
Choose the rest of the parameters at your own discretion. Azure Pre-requisite 3 At the end of this step, the “Provider status” should say “Not provisioned”.

​
Telnyx Network

This step is performed on Telnyx. If you don’t have a network created already, you may follow this guide to create one.

​
Procedure

​
Create a VXC resource

This step is performed on Telnyx.
request
POST /v2/virtual_cross_connects HTTP/1.1
Host: api.telnyx.com
Content-Type: application/json
Authorization: Bearer XXX
Content-Length: 286

{
    "network_id": "{{you network UUID}}",
    "name": "my-first-azure-vxc",
    "cloud_provider": "azure",
    "cloud_provider_region": "Frankfurt",
    "primary_cloud_account_id": "xxxxxx",
    "bgp_asn": 12076
}
ParameterValue
cloud_providerazure
cloud_provider_regionChoose the matching region from the ExpressRoute circuit
primary_cloud_account_id”Service key” on the ExpressRoute created previously
bgp_asnAzure’s bgp asn which is 12076
Take note of the following info in the response; you will need it later.
  • id
  • primary_cloud_ip
  • primary_bgp_key

​
Enable Primary Connection

This step is performed on Telnyx.
request
PATCH /v2/virtual_cross_connects/:vxc_uuid HTTP/1.1
Host: api.telnyx.com
Content-Type: application/json
Authorization: Bearer XXX
Content-Length: 31

{
    "primary_enabled": true
}
You must make sure the VXC status is provisioned before proceeding to the next step. You can poll the status using GET request on the specific VXC.

​
Azure Private Peering

This step is performed on Azure. “Provider status” must show “Provisioned” before performing this step. Azure Private Peering 1 Azure Private Peering 2 Azure Private Peering 3
ParameterValue
Peer ASNTelnyx’s BGP ASN which is 63440
SubnetsIPv4
IPv4 Primary subnetChoose the /30 block that includes primary_cloud_ip
IPv4 Secondary subnetChoose the next /30 block
VLAN IDChoose any number from a valid VLAN range
Shared keyprimary bgp key
Public IP addressCreate new
Public IP address SKUStandard
After saving, you may need to wait for some time before performing the next step. Azure Private Peering 4 At this point, you should see Telnyx IPs advertised in the result after you click into “View route table.” Azure Private Peering 5 At this point, you are all set. Perform the following steps only if you are trying to test things out before putting it into your own production environment.

​
Virtual Network

Azure Virtual Network 1
ParametersValue
RegionMatch that of the virtual network created from the previous step
Next, add a Gateway subnet. Keep all parameters as default. Azure Virtual Network 2

​
Virtual Network Gateways

Azure Virtual Network Gateways 1
ParametersValue
NameSomething meaningful to you
RegionMatch that of the virtual network created from the previous step
Gateway typeExpress Route
SKUStandard
Virtual networkChoose the one created from the previous step
Public IP addressCreate new
Public IP address SKUStandard
The gateway creation will take a while; upward of 20 minutes. In the meantime, you can proceed to the following step.

​
Virtual Machines

Azure Virtual Machines 1
ParametersValue
RegionMatch that of the virtual network created from the previous step
Azure Virtual Machines 2
ParametersValue
Virtual networkChoose the one created from the previous step
You can keep the rest default or choose at your discretion.

​
Add Gateway Connection

This step is performed on Azure. The Virtual Gateway you created must be successfully deployed before this step is performed. Azure Add Gateway Connection 1 Azure Add Gateway Connection 2
ParametersValue
Connection typeExpress Route
Azure Add Gateway Connection 3
ParametersValue
Virtual network gatewayChoose the one created from the previous step
ExpressRoute circuitChoose the one created from the previous step
Routing weight0

​
Validate Connection

This step is performed on Azure. Ensure all of the following are successfully deployed:
  • ExpressRoute
  • Virtual network
  • Virtual network gateway & connection
  • Virtual machine
SSH into the VM and perform a traceroute to sip.telnyx.com and sip.telnyx.eu. You can see the next hop is the next hop indicated on the Azure Private Peering under the express route. Azure Validate Connection