Aliases

Add convenient addresses to access your Resources.

Aliases let you add an extra address to any of your Resources. Aliases are accessible to anyone with access to the Resource and do not take the place of the original address. Aliases are only accessible via Twingate and don’t require you to set up any DNS records.

For example, consider a router as a Resource. The Resource’s address is 10.0.0.1 and its alias is router.internal. Users can access the router using either the address, 10.0.0.1, or the alias, router.internal.

Aliases are protocol agnostic, meaning that an alias will work with any protocol. Think of an alias as a pseudo-A record for an address that can only be used via Twingate.

Caveats

HTTPS and aliases

Websites that use HTTPS will cause certificate errors when accessed via an alias. As aliases are protocol agnostic, there’s no built-in support for HTTPS. This may lead to confusion when trying to use an alias with a Resource that uses HTTPS.

In order for HTTPS to work with an alias, you must create and register a TLS certificate for the alias. This can either be done by using a domain you control (e.g. aliasing things to a subdomain of your corporate domain) or by creating and distributing a private certificate for your devices.

Host headers

When connecting to an alias via HTTP, the host header will be set to the alias. For example, when connecting to router.internal, your browser will set Host: router.internal. This may impact some setups, like which virtual host a server might return.

.local TLD

The .local is a special-purpose domain name that’s used for local networking and multicast DNS (mDNS). Current mDNS uses include Apple’s Bonjour, zeroconf on Linux and some limited Windows support. Using .local in an alias may lead to the alias not working properly on many devices. Instead of using .local, consider using a subdomain of a domain you control, like alias.mywebsite.com, or using a private/internal domain name like alias.internal or alias.corp.

Single label domains

Aliases cannot be single label domains. Single label domains don’t have a . in them, e.g. twingate is a single label domain but twingate.com isn’t. Instead of using a single label domain, consider using a subdomain of a domain you control, like router.mywebsite.com, or using a private/internal domain name like router.internal or router.corp.

Last updated 2 months ago