Custom RDP Hostname in the Session Title

Note

Please note that this is a general guide, and specific details may vary depending on your Windows Server setup. Refer to the Windows Server documentation for precise configuration steps.

This use case describes how to configure a custom hostname displayed in the RDP client title bar for sessions started from the User Access Gateway using the Native client option.


This configuration enables clear, user‑friendly RDP session identification by preserving custom hostnames through Fudo Enterprise.

Warning

Wildcard must be created on DNS side. Fudo Enterprise does NOT generate DNS records.

DNS Configuration in Windows DNS Manager

Create Subdomain for Wildcard Usage:

  1. Open the Server Manager application.

  2. Click Tools button on the upper right corner of the window to expand the menu list and select DNS.

../../_images/sso_win_dns.png

  1. Go to Forward Lookup Zones, right click on the domain name (e.g., main.lab) and select New Domain.

  2. Provide the New DNS domain name (e.g., dev).

  3. Click OK.

Create Wildcard A Record:

  1. Right click on the added zone name (dev) and select New Host (A or AAAAA).

  2. In the Name field, type an asterisk (*).

  3. In the IP address field, type the Fudo Enterprise User Access Gateway address (e.g., 10.31.135.180).

  4. Optionally, you can select the Create associated pointer (PTR) record option.

  5. Click Add Host.

Note

You can check the address assigned for User Access Gateway in the Settings > Network Configuration > Interfaces. Ensure that the interface is Active.

Fudo Enterprise Configuration

  1. Select Management > Listeners and click the selected RDP listener’s name to edit it.

  2. In the listener configuration, locate the RDP config domain field.

  1. Enter the domain that should be appended to the generated hostname (e.g., jdoe.dev.main.lab).

  1. Click Save.

Note

  • When the RDP config domain field is configured, the listener uses hostnames from the specified domain. Leave this field empty if you do not want to use custom hostnames for listener.

  • Each RDP listener can use a different custom domain.

Start RDP Connection

  1. Sign in to the User Access Gateway.

  1. Navigate to Resources.

  2. Find desired RDP account and server, hover your mouse over to show more options.

  3. Select the Native client button.

  4. Choose the listener, via which you want to connect.

  5. Click Connect.

  6. Google Chrome will automatically download generated .rdp file.

  1. Open the downloaded .rdp file using your native RDP client (e.g., Remote Desktop Connection for Windows, Windows App for macOS.

Result

When RDP config domain is configured, the generated .rdp file contains a hostname built with that domain in the full address entry. As a result, the RDP client title bar shows a custom hostname that is easier for the user to identify. Session title shows configured hostname (e.g., server-name - 10.0.242.25.jdoe.dev.main.lab:2222).

Note

If the RDP config domain field is left empty, the generated RDP configuration uses the default connection address, as in previous versions.

RDP File Example

full address:s:10.0.234.1.jdoe.dev.main.lab:2222
username:s:<generated_username>
prompt for credentials:i:1

Where:

  • 10.0.234.1 – target server IP

  • jdoe.dev.main.lab – custom hostname

  • 2222 – listener port

  • generated_username – temporary / OTP username from Fudo Enterprise

Note

The custom RDP hostname is a DNS label pointing to the Fudo Enterprise listener, not to the target server itself.


Related topics: