End-of-Life (EoL)

Configure the Palo Alto Networks Terminal Services Agent for User Mapping

Use the following procedure to install and configure the TS agent on the terminal server. To map all your users, you must install the TS agent on all terminal servers that your users log in to.
For information about default values, ranges, and other specifications, refer to Configure User Mapping for Terminal Server Users. For information about the supported terminal servers supported by the TS Agent, refer to “Operating System (OS) Compatibility TS Agent” in the Terminal Services Agent Release Notes.
  1. Download the TS agent installer.
    1. Select
      Software Updates
      from the Manage Devices section.
    2. Scroll to the
      Terminal Services Agent
      section and
      the version of the agent you want to install.
    3. Save the
      file (be sure to select the appropriate version based on whether the Windows system is running a 32-bit OS or a 64-bit OS) on the systems where you plan to install the agent.
  2. Run the installer as an administrator.
    1. Open the Windows
      menu, right-click the
      Command Prompt
      program, and select
      Run as administrator
    2. From the command line, run the .msi file you downloaded. For example, if you saved the .msi file to the Desktop you would enter the following:
      cd Desktop
    3. Follow the setup prompts to install the agent using the default settings. By default, the agent gets installed to the
      C:\ProgramFiles (x86)\Palo Alto Networks\Terminal Server Agent
      folder, but you can
      to a different location.
    4. When the installation completes,
      the setup window.
      If you are upgrading to a TS Agent version that has a newer driver than the existing installation, the installation wizard prompts you to reboot the system after upgrading in order to use the new driver.
  3. Define the range of ports for the TS Agent to allocate to end users.
    System Source Port Allocation Range
    System Reserved Source Ports
    fields specify the range of ports that will be allocated to non-user sessions. Make sure the values specified in these fields do not overlap with the ports you designate for user traffic. These values can only be changed by editing the corresponding Windows registry settings.
    1. Open the Windows
      menu and select
      Terminal Server Agent
      to launch the Terminal Services agent application.
    2. Select
      in the side menu.
    3. Enter the
      Source Port Allocation Range
      (default 20000-39999). This is the full range of port numbers that the TS agent will allocate for user mapping. The port range you specify cannot overlap with the
      System Source Port Allocation Range
    4. (
      ) If there are ports/port ranges within the source port allocation that you do not want the TS Agent to allocate to user sessions, specify them as
      Reserved Source Ports
      . To include multiple ranges, use commas with no spaces, for example:
    5. Specify the number of ports to allocate to each individual user upon login to the terminal server in the
      Port Allocation Start Size Per User
      field (default 200).
    6. Specify the
      Port Allocation Maximum Size Per User
      , which is the maximum number of ports the Terminal Services agent can allocate to an individual user.
    7. Specify whether to continue processing traffic from the user if the user runs out of allocated ports. By default, the
      Fail port binding when available ports are used up
      is selected, which indicates that the application will fail to send traffic when all ports are used. To enable users to continue using applications when they run out of ports, clear this check box. Keep in mind that this traffic may not be identified with User-ID.
  4. Configure the firewalls to connect to the Terminal Services agent.
    Complete the following steps on each firewall you want to connect to the Terminal Services agent to receive user mappings:
    1. Select
      User Identification
      Terminal Server Agents
      and click
    2. Enter a
      for the Terminal Services agent.
    3. Enter the IP address of the Windows
      on which the Terminal Services agent is installed.
      When you configure a TS agent connection, use a static IP address or an FQDN that resolves to a static IP address for the
      and any
      Alternative IP Addresses
      . DHCP is not supported.
    4. Enter the
      number on which the agent will listen for user mapping requests. This value must match the value configured on the Terminal Services agent. By default, the port is set to 5009 on the firewall and on the agent. If you change it here, you must also change the
      Listening Port
      field on the Terminal Services agent
    5. Make sure that the configuration is
      and then click
    6. Commit
      the changes.
    7. Verify that the
      status displays as connected (a green light).
  5. Verify that the Terminal Services agent is successfully mapping IP addresses to usernames and that the firewalls can connect to the agent.
    1. Open the Windows
      menu and select
      Terminal Server Agent
    2. Verify that the firewalls can connect by making sure the
      Connection Status
      of each firewall in the Connection List is
    3. Verify that the Terminal Services agent is successfully mapping port ranges to usernames by selecting
      in the side menu and making sure that the mapping table is populated.
  6. (
    Windows 2012 R2 servers only
    ) Disable Enhanced Protected Mode in Microsoft Internet Explorer for each user who uses that browser.
    This task is not necessary for other browsers such as Google Chrome or Mozilla Firefox.
    To disable Enhanced Protected Mode for all users, use Local Security Policy.
    Perform these steps on the Windows Server:
    1. Start Internet Explorer.
    2. Select
      Internet options
      and scroll down to the Security section.
    3. Clear
      Enable Enhanced Protected Mode
    4. Click
      In Internet Explorer, Palo Alto Networks recommends that you do not disable Protected Mode, which differs from Enhanced Protected Mode.

Recommended For You