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.4.x | 31-July-2017
Many of the DC Agent settings configured in Forcepoint Security Manager apply to all agent instances in your deployment. You can, however, configure settings unique to a DC Agent instance by editing a configuration file called transid.ini.
1.
Use a text editor to edit transid.ini (in C:\Program Files\Websense\Web Security\bin, by default), then save your edits.
2.
For example, configure the agent to ignore user names that contain a dollar sign:
AllDollarSign=True
3.
4.
5.
6.
Delete the XidDcAgent.back file from the web protection bin directory.
The file is recreated when you start DC Agent.
7.
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 Security Manager). The default is 86400 seconds, or 24 hours.
 
IgnoreDNSFailure
Dictates whether DNS failures are ignored or if the user IP address should be taken directly from the event data if DNS fails.
 
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.
 
StripEmailSign
Determines whether the user name will be stripped off when it appears in an email address.
 
Used only when UseEventSubscriber is enabled, determines whether user names are stripped off and added to the user map when they appear in the "username@company.com\" format.
UseDNSReverse
Determines whether DC Agent identifies the client hostname in the process of retrieving client IP address information.
UseEventSubscriber
Configures DC Agent to register with the domain controllers for a call-back when user logon events occur.
 
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.
UserMapUpdateTime
Establishes the time between updates to the user map.
 
Used only when UseEventSubscriber is on, establishes the interval between updates to the user map.
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 Security 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 2017 Forcepoint. All rights reserved.