Go to the table of contents Go to the previous page You are at the end of the document View or print as PDF
Using DC Agent for Transparent User Identification > Custom configuration for a DC Agent instance
Custom configuration for a DC Agent instance
Using DC Agent | Web Protection Solutions | v8.2.x, v8.3.x | 10-Dec-2016
Many of the DC Agent settings configured in the TRITON console apply to all agent instances in your deployment. You can, however, configure settings unique to a DC Agent instance by creating a configuration file called transid.ini.
1.
Use a text editor to create a file called transid.ini, then save the file in the web protection bin directory (C:\Program Files\Websense\Web Security\bin, by default).
2.
[DCAgent]
3.
AllDollarSign=True
4.
5.
6.
7.
Delete the XidDcAgent.back file from the web protection bin directory.
The file is recreated when you start DC Agent.
8.
Start the Websense DC Agent service.
Note that not all user identification settings can be overridden, and that all parameters and values described in this document are case-sensitive.
Before creating or updating the transid.ini file, please consider that the default values are designed to maximize accuracy and efficiency in most environments. In most cases, it is best to leave the default values as they are.
AllDollarSign
Prompts DC Agent to ignore logon sessions from any user names that contain a dollar sign character ($).
DiscoverInterval
Interval at which the domain auto-discovery process runs, in seconds (equivalent to the Identify domains every value under Domain Discovery in the TRITON Manager). The default is 86400 seconds, or 24 hours.
IgnoreDollarSign
Enables DC Agent to ignore logons from user names containing dollar signs ($).
Used to prevent a problem involving Windows 2000 services that use a machine name followed by a dollar sign (wkstn$) as a user name when contacting the domain controller. DC Agent interprets the service as a new user to whom no policy has been assigned.
When this parameter is set to True, if DC Agent detects a user$ entry in its map, it compares the name to the source machine's name. If these match, DC Agent ignores the logon session entirely, because it knows the logon did not originate from an actual user.
When the parameter is set to False, if DC Agent detects a user$ entry in its map, the agent attempts to replace it with an actual user name from the source machine. If DC Agent does not obtain an actual user name, it records the user$ entry in its map.
IgnoreLocalLogins
Determines whether DC Agent registers local (non-domain) user logons to local client machines.
IgnoreRepeats
Determines whether DC Agent re-records user logon sessions that it already recorded at the time of the previous query.
IPCleanInterval
Interval at which DC Agent checks its cache for stale machine name/IP address pairs, in seconds.
IPCleanLifetime
The amount of time a machine name/IP address pair remains in DC Agent's cache before it is removed, in seconds.
MaxIgnoreListSize
The maximum number of entries (user names, user name/machine name pairs, and machine names) in DC Agent's ignore.txt file.
If you use an ignore.txt file to configure DC Agent to ignore particular users or client machines, this parameter sets an upper limit on the number of entries in the file.
StartDelay
Time period by which to delay DC Agent service initialization to allow diagnostic routines to start first.
UseDNSReverse
Determines whether DC Agent identifies the client hostname in the process of retrieving client IP address information.
UseNetBIOS
Whether to use NetBIOS to perform domain controller machine name lookups.
Set this parameter to True to cause DC Agent to use only NetBIOS to identify domain controllers.
UseUserService
Whether to use User Service or Windows networking calls to communicate with domain controllers. (Equivalent to selecting User Service as the component to use for domain discovery in the TRITON Manager.)
VerifyUserDomain
Whether to make sure that a user exists in a particular domain as indicated by domain controller polling results.
When this parameter is set to False, DC Agent may not update its user map right away if a user account is moved from one domain to another.

Go to the table of contents Go to the previous page You are at the end of the document View or print as PDF
Using DC Agent for Transparent User Identification > Custom configuration for a DC Agent instance
Copyright 2016 Forcepoint LLC. All rights reserved.