Configure the Windows User-ID Agent for User Mapping
Table of Contents
Expand All
|
Collapse All
Next-Generation Firewall Docs
-
-
- Cloud Management of NGFWs
- PAN-OS 10.0 (EoL)
- PAN-OS 10.1
- PAN-OS 10.2
- PAN-OS 11.0
- PAN-OS 11.1 & Later
- PAN-OS 9.1 (EoL)
-
- PAN-OS 10.1
- PAN-OS 10.2
- PAN-OS 11.0
- PAN-OS 11.1 & Later
-
-
-
- Cloud Management and AIOps for NGFW
- PAN-OS 10.0 (EoL)
- PAN-OS 10.1
- PAN-OS 10.2
- PAN-OS 11.0
- PAN-OS 11.1
- PAN-OS 11.2
- PAN-OS 8.1 (EoL)
- PAN-OS 9.0 (EoL)
- PAN-OS 9.1 (EoL)
Configure the Windows User-ID Agent for User Mapping
The Palo Alto Networks Windows User-ID agent
is a Windows service that connects to servers on your network—for
example, Active Directory servers, Microsoft Exchange servers, and
Novell eDirectory servers—and monitors the logs for login events.
The agent uses this information to map IP addresses to usernames.
Palo Alto Networks firewalls connect to the User-ID agent to retrieve
this user mapping information, enabling visibility into user activity
by username rather than IP address and enables user- and group-based
security enforcement.
For information about the server
OS versions supported by the User-ID agent, refer to “Operating
System (OS) Compatibility User-ID Agent” in the User-ID Agent Release Notes.
- Define the servers the User-ID agent will monitor to collect IP address to user mapping information.The User-ID agent can monitor up to 100 servers, of which up to 50 can be syslog senders.To collect all of the required mappings, the User-ID agent must connect to all servers that your users log in to in order to monitor the security log files on all servers that contain login events.
- Open the WindowsStartmenu and selectUser-ID Agent.
- Select.User IdentificationDiscovery
- In theServerssection of the screen, clickAdd.
- Enter aNameandServer Addressfor the server to be monitored. The network address can be a FQDN or an IP address.
- Select theServer Type(Microsoft Active Directory,Microsoft Exchange,Novell eDirectory, orSyslog Sender) and then clickOKto save the server entry. Repeat this step for each server to be monitored.
- (Optional) To enable the Windows User-ID agent to automatically discover domain controllers on your network using DNS lookups, clickAuto Discover. If you have new domain controllers that you want the Windows User-ID agent to discover, clickAuto Discovereach time you want to discover the new domain controllers.Auto-discovery locates domain controllers in the local domain only; you must manually add Exchange servers, eDirectory servers, and syslog senders.
- (Optional) To tune the frequency at which the firewall polls configured servers for mapping information, selectandUser IdentificationSetupEditthe Setup section. On theServer Monitortab, modify the value in theServer Log Monitor Frequency (seconds)field. Increase the value in this field to 5 seconds in environments with older Domain Controllers or high-latency links.Ensure that theEnable Server Session Readsetting is not selected. This setting requires that the User-ID agent have an Active Directory account with Server Operator privileges so that it can read all user sessions. Instead, use a syslog or XML API integration to monitor sources that capture login and logout events for all device types and operating systems (instead of just Windows), such as wireless controllers and Network Access Controllers (NACs).
- ClickOKto save the settings.
- Specify the subnetworks the Windows User-ID agent should include in or exclude from User-ID.By default, the User-ID maps all users accessing the servers you are monitoring.As a best practice, always specify which networks to include and exclude from User-ID to ensure that the agent is only communicating with internal resources and to prevent unauthorized users from being mapped. You should only enable User-ID on the subnetworks where users internal to your organization are logging in.
- Select.User IdentificationDiscovery
- Addan entry to the Include/Exclude list of configured networks and enter aNamefor the entry and enter the IP address range of the subnetwork in as theNetwork Address.
- Select whether to include or exclude the network:
- Include specified network—Select this option if you want to limit user mapping to users logged in to the specified subnetwork only. For example, if you include 10.0.0.0/8, the agent maps the users on that subnetwork and excludes all others. If you want the agent to map users in other subnetworks, you must repeat these steps to add additional networks to the list.
- Exclude specified network—Select this option only if you want the agent to exclude a subset of the subnetworks you added for inclusion. For example, if you include 10.0.0.0/8 and exclude 10.2.50.0/22, the agent will map users on all the subnetworks of 10.0.0.0/8 except 10.2.50.0/22, and will exclude all subnetworks outside of 10.0.0.0/8.If you add Exclude profiles without adding any Include profiles, the User-ID agent excludes all subnetworks, not just the ones you added.
- ClickOK.
- (Optional) If you configured the agent to connect to a Novell eDirectory server, you must specify how the agent should search the directory.
- Selectand clickUser IdentificationSetupEditin the Setup section of the window.
- Select theeDirectorytab and then complete the following fields:
- Search Base—The starting point or root context for agent queries, for example:dc=domain1,dc=example, dc=com.
- Bind Distinguished Name—The account to use to bind to the directory, for example:cn=admin,ou=IT, dc=domain1, dc=example, dc=com.
- Bind Password—The bind account password. The agent saves the encrypted password in the configuration file.
- Search Filter—The search query for user entries (default isobjectClass=Person).
- Server Domain Prefix—A prefix to uniquely identify the user. This is only required if there are overlapping name spaces, such as different users with the same name from two different directories.
- Use SSL—Select the check box to use SSL for eDirectory binding.
- Verify Server Certificate—Select the check box to verify the eDirectory server certificate when using SSL.
- (Strongly recommended) Disable client probing.Palo Alto Networks strongly recommends disabling client probing on high-security networks. Client probing can pose a security threat if not correctly configured. For more information, see client probing.
- On theClient Probingtab, deselect theEnable WMI Probingcheck box if it is enabled.If you must enable client probing, select theEnable WMI Probingcheck box and on theClient Probingtab. Then add a remote administration exception to the Windows firewall for each probed client to ensure the Windows firewall will allow client probing. Each probed client PC must allow port 139 in the Windows firewall and must also have file and printer sharing services enabled.
- Save the configuration.ClickOKto save the User-ID agent setup settings and then clickCommitto restart the User-ID agent and load the new settings.
- (Optional) Define the set of users for which you do not need to provide IP address-to-username mappings, such as kiosk accounts.Save theignore-userlist as a text document on the agent host using the titleignore_user_listand use the .txt file extension to save it to the User-ID Agent folder on the domain server where the agent is installed.List the user accounts to ignore; there is no limit to the number of accounts you can add to the list. Each user account name must be on a separate line. For example:SPAdmin SPInstall TFSReportYou can use an asterisk as a wildcard character to match multiple usernames, but only as the last character in the entry. For example,corpdomain\it-admin*would match all administrators in thecorpdomaindomain whose usernames start with the stringit‑admin. You can also use theignore-userlist to identify users whom you want to force to authenticate using Authentication Portal.After adding entries to the Ignore User list, you must stop and restart the connection to the service.
- Configure the firewall to connect to the User-ID agent.The firewall can connect to only one Windows-based User-ID agent that is using the User-ID credential service add-on to detect corporate credential submissions. See Configure Credential Detection with the Windows User-ID Agent for more details on how to use this service.Complete the following steps on each firewall you want to connect to the User-ID agent to receive user mappings:
- Selectand clickDeviceData RedistributionAgentsAdd.
- Enter aNamefor the agent.
- Add an Agent UsingtheHost and Port.
- Enter the IP address of the WindowsHoston which the User-ID Agent is installed.
- Enter thePortnumber (1-65535) on which the agent will listen for user mapping requests. This value must match the value configured on the User-ID agent. By default, the port is set to 5007 on the firewall and on newer versions of the User-ID agent. However, some older User-ID agent versions use port 2010 as the default.
- SelectIP User Mappingsas theData type.
- Make sure that the configuration isEnabled, then clickOK.
- Committhe changes.
- Verify that theConnected statusdisplays as connected (a green light).
- Verify that the User-ID agent is successfully mapping IP addresses to usernames and that the firewalls can connect to the agent.
- Launch the User-ID agent and selectUser Identification.
- Verify that the agent status showsAgent is running. If the Agent is not running, clickStart.
- To verify that the User-ID agent can connect to monitored servers, make sure the Status for each Server isConnected.
- To verify that the firewalls can connect to the User-ID agent, make sure the Status for each of the Connected Devices isConnected.
- To verify that the User-ID agent is mapping IP addresses to usernames, selectMonitoringand make sure that the mapping table is populated. You can alsoSearchfor specific users, orDeleteuser mappings from the list.