Azure Stack Development Kit – Routing Mode (removing NAT)

When you install Azure Stack Development Kit it is a completely isolated service with multiple networks. It means that your Azure Services (such as ADFS, the portal and AD) are not available outside of the box at all. But what if you wanted to use the Azure Stack DK from multiple computers?  or in our case, use it in conjunction with other Active Directories for login information.  Then you need to remove the NAT from the installation and ensure you have a fully routable connection.

In this post, we will be switching the network mode, so you can have a direct connection into the Azure Stack services from all other computers in your network and therefore be able to use the Portal and other services from various machines.

Let’s look at the architecture first:

The Azure Stack host uses a single network adapter. This adapter is hyper-vised and thus turned into a Hyper-V network. The onboard adapter is then virtualized and given back to the OS as the management adapter.

Let’s call this the external network and your Azure Stack Host is connected to it as well as the AzS-BGPNAT VM with one interface. This VM controls the traffic between the host and the internal VM’s. It has two network interfaces. The second one is connected to the network. The core services network for Azure stack such as Active Directory. The network is also linked back to the host itself. For this a deployment network adapter is created on the host, so the host can now talk directly to all the VM’s in the network. This is used for the deployment and management. Whenever you perform remote administrative tasks directly on the VM’s (or their services) the host uses that particular network adapter.

When you open the portal, all traffic goes via that deployment adapter as we will later see.

The VM’s (in the range) however use the AsZ-BGPNAT VM for all outbound communications. The BGPNAT machine performs NAT translation for all inbound/outbound traffic.

But there is more. While the core services are on the network, the portal, the ADFS website and many other services are also published behind another virtualized network. The inner core of the Azure Stack services. When you ping the portal from the host you will notice that the IP address for that is This subnet range is behind the AzS-SLB01 VM. And as you can see from the routing table on the BGPNAT VM, this VM has an IP address of

In fact when we look at the documentation, it states the following ranges cannot be used outside of the stack box, and thus I’m assuming in these are the networks that can be used internally behind the BGPNAT VM:


So in theory connecting to ADFS goes like:

  • ADFS server has IP
  • DNS record for ADFS is
  • Your external client will try to connect to
  • address is advertised as being behind the SLB ( on the NATBGP
  • Your client goes from: External -> BGPNAT -> SLB
  • SLB then NAT’s the traffic to the endpoint: SLB->ADFS (

Or if you where to like bring it down completely to a (very basic) infographic it’s like:


Your request goes via the BGPNAT (which by default does NAT only for outbound connections and no inbound connections – [which we want to change] then the public IP address of the service (ADFS) is published into the BGPNAT as being on the SLB. Then the SLB does its magic and basically does NAT towards the address.

Back to the deployment network: 

Remember that the host had a deployment network in the 192.168.200.x range, this is so the host can bypass the default NAT translation that the BGPNAT is doing by default. It does not publish the internal services on the public address range (192.168.10x.x) and thus access to Azure Stack Development Kit from the outside is not directly possible. You can install VPN on the host, which essentially brings your into direct contact (routing) of the 192.168.200.x network through the host and thus also the published 192.168.10x.x addresses. But in our case we don’t want to use VPN, we want to downgrade the BGPNAT router, to a BGPROUTER only. It will act as the gateway and basic router for 192.168.200.x and 192.168.10x.x address spaces.

Removing NAT

So now that we know how the network works, we can start switching it to routing mode. This routing mode essentially removes the NAT from the BGPNAT machine and allows direct inbound connections.

Note that you have to make sure that in your network, you don’t use the ranges as per above as we will route it directly into the Azure Stack Development Kit box.

Disclaimer; not sure if this is the appropriate way of doing this and no support can be given obviously… If you are looking at deploying this in a non-hobby network, ask your Microsoft representative..

  • Login to the console of the Azure Stack Development Kit server
  • Open Hyper-V console through administrative tools
  • Login to the AzS-BGPNAT01
  • Type Powershell to go into PowerShell.
  • Type IpConfig and write down the external IP address, subnet and gateway and the interfaceName
  • Get-NetNat  | Remove-NetNat
  • New-NetIPAddress -IPAddress ‘<your external IP>’ -AddressFamily IPv4 -Type Unicast -PrefixLength <your subnet in prefix format> -InterfaceAlias ‘<interfaceName>’ -DefaultGateway <your gateway>

Now, we’ve set the IP address for the BGPNAT router, but we need to enable routing too. We could install routing and remote access and configure it through there, but a faster version is through the Registry Editor.

  • Type REGEDIT (to open registry editor)
  • Go to HKLM\SYSTEM\CurrentControlSet\Services\TcpIP\Parameters
  • Find (or create DWORD) IPEnableRouter
  • Set value to 1
  • Reboot

This completes the routing. Now we have to perform some additional steps for your clients (outside of the Azure Stack Box) to route to the network.

In your switches / other network devices put a forwarder in to ensure you can route to and

If you don’t have a Layer 3 switch or configurable router in your network you can adjust the routing tables in your Windows Client by opening a (administrative) command prompt:

  • route add mask
  • route add mask
  • route add mask
  • route add mask
  • route add mask
  • route add mask

(replace with the IP address you set in the steps above – the external IP for the AsZ-BGPNAT VM)

Next what we need to do is ensure that your Windows client also trusts the Azure Stack certificates. For this we need to add the root certificate of the created CA server into the Trusted Root Certificate store on your client.

The easiest way to retrieve these certificates is on the Azure Stack host. Login and open mmc.exe. Add the certificate snap-in by CRTL-M (of add via file menu). Open the Computer – Local Certificates snap-in and browse to Trusted Enterprise Root certificates.

From there, export the two certificates that are stored and import them into the Trusted Root Certificate Authorities on your Windows Client. If you do not import these certificates, you will receive certificate warning when connecting to the portal, but also, your portal elements will not load correctly.

Finally, we need to set the DNS. Given we have a domain controller in Azure Stack, your Windows Client can use that DNS server for all name resolutions, but if you have a local DNS server you can make a conditional forwarder:

  • DNS forwarding for azurestack.local to
  • DNS forwarding for internal.azurestack.local to
  • DNS forwarding for local.azurestack.external to
  • DNS forwarding for local.cloudapp.azurestack.external (after installing WebApps)

Or set the DNS directly on your client to point to

Note that the local.azurestack.external  and local.cloudapp.azurestack.external domains are actually hosted on, but a conditional forwarder is available on

And that’s it.. you are now fully connected in routing mode to Azure Stack!


Tagged , , ,