Change Auditor for Active Directory 7.2


	NOTE: As of Active Roles version 7.3.3, you can monitor a single server from multiple installations of Change Auditor. To ensure that the Active Roles server EventSource is created and registered in the Change Auditor database, you need to deploy the Active Roles integration script from each Change Auditor installation. See Deploying Change Auditor/Active Roles integration scripts.

This section covers the following topics for Active Roles integrations:

•

Requirements

•

Deploying Change Auditor/Active Roles integration scripts

•

Client components added to Change Auditor

•

Removing deployed Change Auditor/Active Roles integration scripts

•

Troubleshooting Tips

Requirements

Refer to the Release Notes for the list of minimum system requirements.

Deploying Change Auditor/Active Roles integration scripts

For Active Roles to retrieve the name of the user that was logged in to the Active Roles console and forward this information to Change Auditor, you must first deploy the integration scripts to an Active Roles server.


	NOTE: If the Active Roles scripting module has been deployed in a previous Change Auditor version, see the following knowledge base article which details the process to move to the updated version of these scripting modules that are available in Change Auditor 6.x and 7.x: https://support.quest.com/change-auditor/kb?k=119136


	NOTE: The Quest certificate used to sign the deployed scripts is added to the current user trusted publishers certificate stored on the Active Roles server.

To deploy Change Auditor/Active Roles integration scripts:

Open the Deployment page.

Select a server where Active Roles is installed.

Expand Advanced Options and select one of the following options:

•

ActiveRoles Integration | Deploy Scripts Only

•

ActiveRoles Integration | Deploy Scripts and Excluded Account

If you select the Deploy Scripts Only option, Change Auditor copies and runs the Active Roles integration PowerShell script on the Active Roles server which triggers Active Roles to retrieve the initiator information for all users and pass this information onto Change Auditor.

If you select the Deploy Scripts and Excluded Accounts option, the Select Active Directory Objects dialog is displayed. Use either the Browse or Search page to locate and select a user or computer to exclude. Change Auditor then deploys the integration script that signals Active Roles to retrieve the initiator information for all accounts except for those specified for exclusion.

Once successfully deployed, Success is displayed in the Deployment Results cell for the server.


	NOTE: If errors are encountered during the deployment process, corresponding error messages are displayed in the Deployment Results cell. Fix the errors reported and then redeploy the scripts.

Client components added to Change Auditor

After you have deployed the integration script, the initiator information retrieved from Active Roles can be viewed on the Search Results page in Change Auditor. Use the following to display additional information:

•

A field on the Event Details pane that displays the additional information retrieved from Active Roles.

•

A built-in report that retrieves all Active Directory changes, including changes initiated by Active Roles. Running this report also displays the Initiator UserName and EventSource columns in the search results.

•

Columns on the Layout tab that allow you to add the event source and initiator information to other search definitions.

•

Option on the Who tab that allows you to create a custom search to search for events initiated by a specific user, including events initiated by Active Roles.

•

Email tags to include the additional information in alert email notifications.

Event Details pane

A Source field in the Event Details pane displays the name of the application from which the change event was generated (Change Auditor, Active Roles, or GPOADmin). For change events generated by Active Roles or GPOADmin, the name of the user account that initiated the change is displayed in parentheses.


	NOTE: If the Source field displays ‘ActiveRoles’ (instead of ‘ActiveRoles Server’) you are not using the latest integration scripts. To take advantage of the additional events and initiator account information captured using the integration scripts, ensure that you are running Active Roles 6.9 (or higher) with Change Auditor for Active Directory 6.0 (or higher).

All Active Directory events including Active Roles/GPOADmin initiator built-in report

A built-in report is available which retrieves events for all Active Directory changes, including events initiated by Active Roles or GPOADmin. The search definition for this report also includes the initiator information (Initiator UserName and EventSource columns) in the search results.

To run the built-in Active Roles search:

Open the Searches page.

To display the available built-in searches, expand and select the Shared | Built-in | All Events folder.

Locate the All Active Directory Events Including ActiveRoles/GPOAdmin Initiator search and select the search definition and click Run.

A new Search Results page is displayed populated with the audited events that met the search criteria, including the Initiator UserName and EventSource information.

Layout tab

The Change Auditor database includes columns to record Active Roles and GPOADmin information. The columns are not displayed by default on a Search Results page for most searches. However, using the Layout tab you can add the following information for all searches:

•

EventSource — for all events, the name of the application from which the event was generated (Change Auditor, Active Roles, or GPOADmin).

•

Initiator Mail — for all generated by Active Roles or GPOADmin, the email address of the user that initiated the change.

•

Initiator SID — for events generated by Active Roles or GPOADmin, the SID of the user that initiated the change.

•

Initiator UserName — for events generated by Active Roles or GPOADmin, the name of the user that initiated the change.

To add a column to the search results:

Open the Layout tab.

Locate the columns (EventSource, Initiator Mail, Initiator SID, or Initiator UserName) in the Unselected Columns table.

Select the columns to add and use the right arrow button to move them to the Selected Columns table.

The column is added to the bottom of the list or beneath the highlighted column in the Selected Columns table.

You can also ‘drag’ a column to the Selected Columns table.

The Selected Columns table also displays the order the columns are presented. To rearrange columns, use the up and down arrow buttons located to the right of the Selected Columns table.

You can also ‘drag’ columns within this table to define the order.

Who tab

When using the Who tab to retrieve change events initiated by a specific user, changes initiated by Active Roles are not automatically included in the search. A check box is available on the Who tab which instructs Change Auditor to retrieve all change events initiated by the specified user, including those made through Active Roles and GPOADmin.

To include Active Roles initiated events:

Open the Searches page

In the explorer view (left pane), expand and select the folder where you want to save your search (for example, Shared or Private).

Click New to enable the Search Properties tabs.

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

On the Select one or more Directory Objects dialog, use either the Browse or Search page to locate the user, computer, or group to include.

Once you have located the directory object, select it and click Add to add it to your selection list.

Repeat this step to include each additional directory object.

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

Back on the Who tab, select the Include Event Source Initiator check box.


	NOTE: Including the event source initiator, may have a noticeable effect on the search performance, depending on the size of the database and the number of results returned in the search.

When this search runs, Change Auditor retrieves all events made by the specified user account, including events initiated by Active Roles.

In addition, when the Include Event Source Initiator option is selected the Initiator UserName column is added to the Search Results grid for this search. For events initiated by Active Roles, this column contains the user account that was logged in to the Active Roles console.

Email tags

Change Auditor/Active Roles integration email tags are available which can be added to the event details of alert email notifications. These new email tags are:

•

%EVENTSOURCE% - indicates the application where the change event came from: Change Auditor, Active Roles, or GPOADmin.

•

%INITIATORMAIL% - for events generated by Active Roles or GPOADmin, the email address of the user that initiated the event.

•

%INITIATORSID% - for events generated by Active Roles or GPOADmin, the SID of the user that initiated the event.

•

%INITIATORUSERNAME% - for events generated by Active Roles or GPOADmin, the name of the user that initiated the event.

See the Change Auditor User Guide for more information about how to configure and enable email notifications and customize email content.