Change Auditor 7.3 - User Guide


	NOTE: You can add a group to a search to find all events by the members of that group. Change Auditor must expand and store the membership of the group before all expected events are returned when the search is run. When the search is saved, Change Auditor expands the group if it has not already been expanded. This may take several minutes, depending on your environment. See Group Membership Expansion for the options available regarding group expansion.


	NOTE: Activity performed by an account specified in an Excluded Accounts template is not captured by the agents to which this template is assigned. Change Auditor does not return any audit events for these excluded accounts even if you specify them in your ‘who’ search criteria. For more information about excluding accounts, see Account Exclusion.

The Who tab contains the following information and controls:

Table 3. Who tab: Field and control descriptions

Field and Control

Description

Runtime Prompt

Select this check box to prompt for the ‘who’ criteria when this search runs. That is, when you select Run, the Select Active Directory Object dialog is displayed allowing you to locate and select the users, computers, or groups to search.d

NOTE:

•

When this check box is checked, the Add toolbar buttons are deactivated.

•

You cannot enable alerting for search definitions that use the Runtime Prompt option.

Exclude the Following Selection(s)

Select this check box to specify the users, computers, or groups to exclude from the search. That is, Change Auditor is to search all users, computers, and groups except those listed.

Include Event Source Initiator

Select this check box if you want to include Active Roles or GPOADmin events in the search. Selecting this check box instructs Change Auditor to retrieve all change events made by the specified user account, including those initiated by Active Roles and GPOADmin.

NOTE: An extra column (Initiator UserName) is added to the Search Results grid that contains the user information of who made the change through Active Roles or GPOADmin.

Who list

Contains the individual users, computers and groups to include in the search (or excluded from the search if the Exclude the Following Selection(s) option is checked).

By default, all users, computers, and groups are included in a new search definition and therefore, this list is empty.

To search for events generated by a specific user, computer or group:


	NOTE: By default, each new search searches for change events generated by all users, computers, and groups; therefore, the list box on the Who tab will be empty.

On the Who tab, click Add to add an active user, computer, or group to the ‘who’ list.

On the Select Active Directory Object dialog, use either the Browse or Search page to search your environment to locate and select the user, computer, or group to include.

If required, use the Forest drop-down box to select in which forest the objects reside. Foreign agent forests may require foreign forests credentials which can be entered on the Credentials Required dialog.

Click Add to add it to your selection list.

Repeat to include each additional directory object.

After selecting one or more directory objects, click Select to save your selection and close the dialog.


	NOTE: You can use Add with Events (instead of Add) to select a user, computer, or group that already has an audit event associated with it in the database. The accounts available for selection are based on the ‘when’ clause (When tab) and the search limit (Info tab) specified for the current search. Use this to search for events that are tied to users who have been removed from Active Directory.

Optionally, select Add | Administrator, select Yes or No to include or exclude users with the Administrator right, and click OK.

When this search runs, Change Auditor searches for change events generated by only the selections listed on the Who tab.


	TIP: If you are running Active Roles or GPOADmin and want to include events generated by Active Roles or GPOADmin in the search, select the Include Event Source Initiator check box. For more information, see the Active Roles Integration or GPOADmin Integration sections in the Change Auditor Installation Guide.

To use a wildcard expression to specify a user or group:

On the Who tab, expand Add and select the Add Wildcard Expression option.

On the Add Who dialog, enter the wildcard expression to use to search for a user (domain\user name) or group (domain\group name):

•

Select the comparison operator to use: Like or Not Like.

•

In the field to the right, enter the pattern (character string and * wildcard character) to be used to search for a match. Use the * wildcard character to match any string of zero or more characters.

For example, LIKE *admin* finds all users with the character string ‘admin’ anywhere in the name.

•

By default, the wildcard expression is used to search for a user. To search for a group, select the Group option.


	NOTE: When using the Group option, the Group Membership Expansion option on the Coordinator Configuration page (on the Administration Tasks tab) must be set to Expand all groups.

After entering the wildcard expression to use, click OK to close the dialog and add the wildcard expression to the ‘who’ list.

When this search runs, Change Auditor searches for change events generated by the users (or users that are members of the groups) whose name matches the specified wildcard expression.

What tab

Use the What tab to define ‘what’ entities to inlcude (or exclude) in the search. More specifically, using this tab you can create a search for events based on:

•

•

•

•

•

When criteria is specified on the What tab, Change Auditor retrieves only those events that match the criteria listed on the What tab. When multiple ‘what’ criteria is specified on this tab, Change Auditor uses the ‘AND’ operator to evaluate an event and returns only those events that meet all the specified criteria. However, when multiple subsystems (for example, Active Directory, ADAM and Exchange) are specified, Change Auditor uses the ‘OR’ operator to evaluate these entities, returning events that meet any of the specified subsystem criteria. This also applies when multiple event classes are specified. That is, when multiple event classes are specified, Change Auditor uses the ‘OR’ operator and returns any of the specified events.


	NOTE: By default, all events are included in a new search definition and therefore the list box on the What tab will be empty.

Once criteria is added, the criteria list box contains an expandable view displaying the following information for all the criteria defined for the search definition:

Entity

Lists the entity (subsystem, event class, object class, severity, or result) selected. Expanding the Entity entry displays the specific criteria and any options or restrictions, defined as part of the search criteria.

Exclude

Indicates whether the criteria is included in (False) or excluded from (True) the search definition.

Action(s)

When applicable, this column displays the actions (all, add attribute, delete attribute, modify attribute, rename object, add object, delete object, or other) included in the search definition.


	NOTE: Only displayed when the entity is Active Directory, ADAM, Exchange, File System, Group Policy, Local Account, or Registry.

Transport(s)

When applicable, this column displays the transports (all, SSL/TLS, Kerberos, Simple Bind) included in the search definition.


	NOTE: Only displayed when the entity is Active Directory, ADAM, Exchange, or AD Query.

Port

When applicable, this column displays the port included in the search definition.

Click the expansion box to the left of the Entity field to expand this view to display the following details:

Object

Displays the object selected for auditing.

Restriction

If applicable, this field displays the additional restrictions specified for the search definition.


	NOTE: Only displayed when the entity is an Event Class.

Scope

Indicates the scope specified (All Object, This Object, This Object and Child Objects Only, This Object, All Child Objects, and Members of this group).

Examples of custom searches based on ‘what’ criteria


	NOTE: Only displayed when the entity is Active Directory, ADAM, Exchange, File System, Group Policy, Local Account, or Registry.

NOTE: Only the ‘what’ criteria that does not require a specific license is covered in this section. For more information about ‘what’ criteria that requires a specific license, refer to the appropriate Change Auditor User Guide:

•

Object Class - Change Auditor for Active Directory User Guide

•

Subsystem | Active Directory - Change Auditor for Active Directory User Guide

•

Subsystem | AD Query - Change Auditor for Active Directory Query User Guide

•

Subsystem | ADAM (AD LDS) - Change Auditor for Active Directory User Guide

•

Subsystem | Azure Active Directory - Office 365 and Azure Active Directory Auditing User Guide

•

Subsystem | Exchange - Change Auditor for Exchange User Guide

•

Subsystem | File System - Change Auditor for Windows File Servers User Guide, Change Auditor for EMC User Guide or Change Auditor for NetApp User Guide

•

Subsystem | Group Policy - Change Auditor for Active Directory User Guide

•

Subsystem | Logon Activity - Change Auditor for Logon Activity User Guide

•

Subsystem | Office 365 - Office 365 and Azure Active Directory Auditing User Guide

•

Subsystem | SharePoint - Change Auditor for SharePoint User Guide

•

Subsystem | SQL - Change Auditor for SQL Server User Guide

To search for events based on an event class or facility:

On the What tab, click Add. (Or expand the Add button and select Event Class.)


	NOTE: You can use the Add with Events \| Event Class command (instead of Add \| Event Class) to select an entity that already has an event in the database.

On the Add Facilities or Event Classes dialog, select a single event, click Add, and select Add This Event or Add All Events in Facility.


	NOTE: When multiple events are selected, Change Auditor uses the ‘OR’ operator to evaluate the change events, returning any of the events specified.

Depending on the event class entry selected in the data grid, an extra Restriction pane may display across the middle of this dialog.

For some event classes, use the restriction pane to specify 'from' and/or 'to' value restrictions. To define a restriction, select the appropriate check box and enter the value.

For other event classes (such as DNS Zone, Distribution and Security groups), use the restriction pane to apply filter options for filtering by individual parameter values (for example, auditing of static DNS entries).

To do this, select the Filter by parameter check box and then select from the available parameter values that are enabled (for example, for the DNS Entry Type parameter, you can select Static and/or Automatically expiring).

Once you have defined the restrictions, use either Add or Update Restriction:

•

If the event has not been added to the Selections list box, click Add to add the event to the selection list.

•

If the event was previously added to the Selections list box, click Update Restriction to update the restrictions for the event.


	NOTE: You can also use the Shift and Ctrl keys to add multiple event classes to the selection list. However, the restrictions pane and the Add \| Add All Events in Facility command are not available when multiple event classes are selected.


	NOTE: Select the Exclude the Above Selection(s) check box if you want to search for all event classes and facilities except those listed in the ‘what’ list.


	NOTE: Select the Runtime Prompt check box to prompt for the facility or event class criteria every time the search runs. When this check box is checked, the data grid and buttons on this dialog are disabled. You cannot enable alerting for search definitions that use the Runtime Prompt option.

Once you have made your selections, click OK.

The search criteria listed on the What tab now defines what will be searched for when this search is run.

To search for changes to local users or groups:

On the What tab, expand Add and select Subsystem | Local Account.


	NOTE: You can use the Add with Events \| Subsystem \| Local Account command (instead of Add \| Subsystem \| Local Account) to select an entity that already has an event in the database.

On the Add Local Account dialog, select one of the following options to define the scope of coverage:

•

All Objects - select this option to include all objects

•

This Object - select this option to include individual objects

If you selected This Object, the data grid, which displays a list of all the users and groups in the local SAM databases on the selected Member Server, and associated buttons are enabled.

To add an account, select the account in the data grid and click Add to add it to the selection list at the bottom of the dialog. Repeat to add more accounts.

To replace an account in the selection list, select the ‘new’ account in the data grid, select the ‘old’ account in the selection list and click Update. The entry in the selection list is replaced with the ‘new’ account.

To select a local account on a different computer, click Browse to the right of the Account field. On the Select Active Directory Object dialog, use the Browse or Search pages to locate and select another computer.

Click Select to save your selection and close the dialog.

On the Add Local Account dialog, the local user and group accounts available on the specified computer are displayed in the data grid.


	NOTE: Select the Exclude the Above Selection(s) check box if you want to search for events generated by all local accounts except those listed in the ‘what’ list.


	NOTE: Select the Runtime Prompt check box to prompt for a local account every time the search runs. When this check box is checked, the data grid and buttons on this dialog are disabled. You cannot enable alerting for search definitions that use the Runtime Prompt option.

Once you have selected the local accounts to include in the search, click OK.

When this search is run, Change Auditor searches for events generated by the local accounts listed on the What tab.

To search for changes to registry keys:


	NOTE: Registry auditing is only available when you have applied custom Registry Auditing templates that define the registry changes to be audited. See Registry Auditing for more information about capturing registry events.

On the What tab, expand Add and select Subsystem | Registry.


	NOTE: You can use Add with Events \| Subsystem \| Registry (instead of Add \| Subsystem \| Registry) to select an entity that already has an event in the database.

On the Add Registry Key dialog, select one of the following options to define which system registry keys to include in your search definition:

•

All Registry Keys — include all registry keys

•

This Object — include only the selected objects

•

This Object and Child Objects Only — include the selected objects and its direct child objects

•

This Object and All Child Objects — include the selected objects and all subordinate objects (in all levels)

By default, All Actions is selected meaning that all the registry actions listed are included in the search definition. However, you can clear the All Actions option and select individual actions for auditing.

Select one or more of the following options:

•

All Actions — include all the actions. When this option is selected, all the other options are disabled. (Default)

•

Add Value — include when a new value is added to the selected registry key.

•

Delete Value — include when a registry key value is removed.

•

Modify Value — include when a registry key value is modified.

•

Add Key — include when a new registry key is added.

•

Delete Key — include when a registry key is removed.

When a scope option other than All Registry Keys is selected, the registry key hierarchy is enabled allowing you to locate and select an individual registry key.

Expand the hierarchy to locate and select a registry key. Then click Add to add it to the selection list box at the bottom of the dialog. Repeat to add more registry keys.


	NOTE: If you selected Add With Events, the registry key hierarchy pane is replaced with a data grid listing the registry keys that have an event associated with it in the database.

To replace a registry key in the selection list, select the ‘new’ registry key in the hierarchy, select the ‘old’ key in the selection list and click Update. The entry in the selection list is replaced with the ‘new’ registry key.

To select a registry key on a different computer, click Browse to the right of the Path field. On the Select a Directory Object dialog, use the Browse or Search pages to locate and select another computer.

Click Select to save your selection and close the dialog.

On the Add Registry Key dialog, the system registry keys associated with the specified computer will then be displayed in the hierarchy view.


	NOTE: Select the Exclude the Above Selection(s) check box if you want to search for events in all registry keys except those listed in the ‘what’ list.


	NOTE: Select the Runtime Prompt check box to prompt for a registry key every time the search runs. When this check box is checked, the data grid and buttons on this dialog are disabled. You cannot enable alerting for search definitions that use the Runtime Prompt option.

Once you have selected the registry keys to include in the search, click OK.

When this search runs, Change Auditor searches for the selected events (actions) in the registry keys listed on the What tab.

To search for changes to services:


	NOTE: Service auditing is only available when you have applied custom Service Auditing templates that define the services to audit. See Service Auditing for more information about capturing service events.

On the What tab, expand Add and select Subsystem | Service.


	NOTE: You can use Add with Events \| Subsystem \| Service (instead of Add \| Subsystem \| Service) to select an entity that already has an event in the database.

On the Add Service dialog, select one or more services from the list at the top of the dialog and click Add to move them to the selection list box at the bottom of the page.

You can also click Add All to include all the listed services in the search definition.

To select services on a different computer, click Browse to the right of the You are viewing services on field. On the Select a Directory Object dialog, use the Browse or Search pages to locate and select another computer.

Click Select to save your selection and close the dialog.

On the Add Services dialog, the services found on the specified computer will then be displayed.


	NOTE: Select the Exclude the Above Selection(s) check box if you want to search for events to all services except those listed in the ‘what’ list.


	NOTE: Select the Runtime Prompt check box to prompt for a service every time the search runs. When this check box is checked, the data grid and buttons on this dialog are disabled. You cannot enable alerting for search definitions that use the Runtime Prompt option.

Once you have selected the services to include in the search, click OK.

When this search is run, Change Auditor searches for change events to the services listed on the What tab.

TTo search for events based on severity:

On the What tab, expand Add and select Severity.


	NOTE: You can use Add with Events \| Severity (instead of Add \| Severity) to select a severity that already has an event associated with it in the database.

On the Add Severities dialog, select one or more severity levels and click Add to add them to the selection list box at the bottom of the dialog.


	NOTE: Select the Exclude the Above Selection(s) check box if you want to search for all events except those assigned a severity level that is listed in the ‘what’ list.


	NOTE: Select the Runtime Prompt check box on this dialog to prompt for a severity every time the search is run. When this check box is checked, the data grid and buttons on this dialog are disabled.

Once you have defined the severity levels to include in the search, click OK.

When this search is run, Change Auditor searches for events with the severity levels included on the What tab.

To search for events based on result:

On the What tab, expand Add and select Result.


	NOTE: You can use Add with Events \| Result (instead of Add \| Result) to select an entity that already has an event associated with it in the database.

On the Add Results dialog, select one or more results (none, success, protected or failed) and use Add to add them to the selected list box at the bottom of the dialog.


	NOTE: Select the Exclude The Above Selection(s) check box if you want to search for all events except those with the selected result.


	NOTE: Select the Runtime Prompt check box on this dialog to prompt for a result every time the search is run. When this check box is checked, the data grid and buttons on this dialog are disabled.

Once you have defined the results to include in the search, click OK.

When this search is run, Change Auditor searches for events with the results included on the What tab.

Where tab

The Where tab allows you to specify which agents to include (or exclude) in the search definition. You can select individual agents, all agents in a specific domain, or a given site. When multiple ‘where’ criteria is added to this tab, Change Auditor uses the ‘OR’ operator to evaluate change events, returning events captured by any of the specified agents, domains, or sites.

The Where tab contains the following information and controls:

Table 4. Where tab: Field and control descriptions
Field and Control	Description
Runtime Prompt	Select this check box to prompt for the ‘where’ criteria whenever the search is run. That is, when Run is selected, the Select Active Directory Objects dialog is displayed allowing you to locate and select the agents, domains, or sites to include in the search definition. NOTE: When this check box is checked, Add is deactivated. NOTE: You cannot enable alerting for search definitions that use the Runtime Prompt option.
Exclude the Following Selection(s)	Select this check box to specify the agents, domains, or sites to exclude from the search. That is, Change Auditor is to return events generated from all agents except those listed in the Where list.
Where list	By default, all agents are included in a new search and therefore this list box is initially empty. Once criteria is selected, this list box contains the agents, domains, sites, and server type (if specified) to include in the search (or exclude from the search if the Exclude the Following Selection(s) option is checked).

To search for events captured by a specific agent, domain or site:


	NOTE: By default, all agents are included in a new search, therefore the list box on the Where tab is empty.

Open the Where tab and click Add.

Use the Browse or Search pages to locate and select an individual agent, a domain, or a site.


	NOTE: You can also select the Grid View option to select an agent from a list rather than using the Explorer View to locate it within your environment.

Click Add to add your selection to the selection list box at the bottom of the page.


	NOTE: You can use Add With Events (instead of Add) to select an agent, domain, or site which already has an event associated with it in the database.

Once you have selected the agents, domains and sites to include in the search, click OK.

The agents, domains and sites listed on the Where tab now defines where the search will be conducted when this search is run.

To use a wildcard expression to specify a domain, site or agent:

On the Where tab, expand Add and select Add Wildcard Expression.

Enter the wildcard expression to use to search for an agent (NetBIOS name), domain, or site:

•

Select the comparison operator to use: Like or Not Like.

•

In the field to the right, enter the pattern (character string and * wildcard character) to be used to search for a match. Use the * wildcard character to match any string of zero or more characters.

For example, LIKE *local finds all agents with a NetBIOS name that ends in ‘local’.

•

By default, the wildcard expression is used to search for an agent. To search for a domain or site, select the Domain or Site option.

After entering the wildcard expression to use, click OK to close the dialog and add the wildcard expression to the ‘where’ list.

When this search runs, Change Auditor searches for change events generated on the domains, sites, or agents whose name matches the specified wildcard expression.

To filter based on server type:

On the Where tab, expand Add and select Add Server Types.

Select to include Domain Controllers, Member Servers, Workstation Servers, Exchange Servers as required.

Click OK to close the dialog and add the server type to the ‘Where’ list.

When this search runs, Change Auditor searches for events generated on the specified domains, sites, or agents for the specified server type.

When tab

The When tab allows you to limit the returned results of the search by date and time. By default, a new search is set to include the change events captured this week. The When tab contains the following information and controls:


	NOTE: All dates and times are based on the client’s current local date and time. The format used to display the date and time is determined by the local computer’s regional and language setting.

Table 5. When tab: Field and control descriptions

Field and Control

Description

Runtime Prompt

Select this check box to prompt for the date and time interval whenever the search is run. That is, when Run is selected, the When dialog is displayed allowing you to specify the date and time range to be used in your search.

NOTE: When this check box is checked, Add is deactivated.

NOTE: You cannot enable alerting for search definitions that use the Runtime Prompt option.

Date Interval

Check one of the following options to change the default setting and define a different date range to limit your search.

From/To

Select this check box and enter the date range.

•

From: Enter the start date for your date range; or click the arrow control to display a calendar from which to select the start date. Only events that occurred on or after this date are included in the search.

•

To: Enter the end date for your date range; or click the arrow control to display a calendar from which to select the end date. Only events that occurred before or on this date are included in the search.

Last

Select this check box and the appropriate relative date and value (that is, number of minutes, hours, days, weeks, months, quarters, or years).

NOTE: Relative dates are calculated based on the actual date and time when the search is started.

This

Select this check box and click the arrow control to select the appropriate date and time interval:

•

This Day: Start parameter is TODAY at midnight local time; end parameter is the current date and time.

•

This Week: Start parameter is midnight local time on the day specified in the First Day of Week parameter (Regional and Location setting) on the local machine (for example, SUNDAY); end parameter is the current date and time. (Default for new searches.)

•

This Month: Start parameter is the first day of the current month at midnight local time; end parameter is the current date and time.

Time Interval

Use this pane to specify a time range to further limit your search.

From

Use the arrow controls to select or enter the starting time for your time range. Only events that occurred at or after this time are included in the search.

Use the arrow controls to select or enter the ending time for your time range. Only events that occurred before or at this time are included in the search.

Reset

Use to clear the time interval settings.

To search for events generated during a specific date and time range: