Change Auditor 7.5 - User Guide

Set-CAArcSightEventSubscription

Set-CAArcSightEventSubscription

Use this command to modify an ArcSight subscription.

Table 2. Available parameters

Parameter	Description
-Connection	A connection obtained by using the Connect-CAClient command. See the Change Auditor Command Guide for details.
-Subscription	The PSCAArcSightEventSubscriptionStatus object that corresponds to the subscription to modify. This parameter is required if the SubscriptionId parameter is not specified.
-SubscriptionId	The ID of the subscription to modify. This parameter is required if the Subscription parameter is not specified. Use the Get-CAArcSightEventSubscriptions command to find the ID.
-ArcSightHost (Optional)	Specifies the IP address or host name of the computer where ArcSight Logger or the ArcSight connector is installed.
-ArcSightPort (Optional)	The the port number for the ArcSight Logger or the ArcSight connector. The default port is 515.
-BatchSize (Optional)	Specifies the maximum number of events to include in a single notification. The default is 10000 events.
-Enabled (Optional)	Specifies whether the subscription is enabled or disabled. By default it is enabled.
-HeartbeatUrl (Optional)	Specifies where (URL) to send heartbeat notifications. NOTE: If no value is specified, a heartbeat notification is not sent.
-NotificationInterval (Optional)	Specifies how often (in milliseconds) notifications are sent to the computer where ArcSight Logger or the ArcSight connector is installed. By default this is set to 0 which results in a continuous stream of events.
-HeartbeatInterval (Optional)	Specifies how often (in milliseconds) heartbeat notifications are sent to the HeartbeatUrl. By default, this is set to every 5 minutes. Setting this to 0 disables the heartbeat notifications.
-AllowedCoordinators (Optional)	Specifies the DNS or NetBIOS name of the coordinators permitted to send events. By default, any coordinator can send the events. NOTE: The list order does not determine which coordinator is selected to send events.
-Subsystems (Optional)	Specifies an array of event subsystems from which to send events. This can be single or multiple subsystems. NOTE: To obtain an array of subsystems, use the Get-CAEventExportSubsystems command and filter the list to specify the required subsystems. NOTE: The subsystems specified override the current subsystems included in the subscription.
-IncludeO365AADDetails (Optional)	Specifies whether to include the raw JSON event details provided by Microsoft. When set to true, the event will include a field named additionalDetails, containing the raw JSON string for Microsoft 365 and Microsoft Entra ID events. When set to false, the additionalDetails field is not included. By default, this is set to false.

Example: Disable a subscription

Set-CAArcSightEventSubscription -Connection $connection -SubscriptionId $SubscriptionId -Enabled $false

Example: Edit the subsystems included in a webhook subscription

$newSubsystems = Get-CAEventExportSubsystems -Connection $connection | ? { $_.DisplayName -eq "File System" -or $_.DisplayName -eq "Active Directory" }

Set-CAArcSightEventSubscription -Connection $connection -SubscriptionId cd87b774-8e65-46e1-8520-da478c60c4c3 -Subsystems $newSubsystems

Remove-CAArcSightEventSubscription

Remove-CAArcSightEventSubscription

Use this command to remove a subscription.

Table 15. Available parameters

Parameter	Description
-Connection	A connection obtained by using the Connect-CAClient command. See the Change Auditor Command Guide for details.
-Subscription	The PSCAArcSightEventSubscriptionStatus object that corresponds to the subscription to remove. This parameter is required if the SubscriptionId parameter is not specified.
-SubscriptionId	The ID of the subscription to remove. This parameter is required if the Subscription parameter is not specified. Use the Get-CAArcSightEventSubscriptions command to find the ID.

Example: Remove an ArcSight subscription

Remove-CAArcSightEventSubscription -Connection $connection -SubscriptionId $subscriptionId

ArcSight event subscription wizard

ArcSight event subscription wizard

From the Event Subscription Wizard you can add and edit a subscription.

NOTE: Optional subscription settings can be set through PowerShell, see Set-CAArcSightEventSubscription.

To create an ArcSight subscription

1	Click Add | ArcSight subscription to open the wizard.

2	Specify the IPv4 address or FQDN (fully qualified domain name) of the ArcSight instance that will receive the event data.

3	Specifies the port number for your ArcSight instance that will receive the event data. The default port is 515.

4	Click Next to select the events to forward based on subsystem and event date.

▪	By default, events start sending after the subscription is created. To change when to begin sending events, click Send events starting and select the desired date and time. The time cannot be more than 30 days prior to the Change Auditor 7.0 installation date.

▪	Select the subsystems to include in the subscription.

5	Click Finish.

To edit an ArcSight subscription

1	Select the required subscription and click Edit.

2	Enter the server and port and click Next.

3	Click Finish.

Managing a Quest IT Security Search integration (Preview)

Managing a Quest IT Security Search integration (Preview)

Quest IT Security Search is a Google-like, IT search engine that enables IT administrators and security teams to quickly respond to security incidents and analyze event forensics.

To send the rich event gathered by Change Auditor to IT Security Search, you need to create an event subscription with Change Auditor. The subscription contains information about where to send the notifications and heartbeats and the event subsystems to include.

NOTE: The IT Security Search warehouse connector must be configured to receive Change Auditor events. See the IT Security Search Release Notes for details.

NOTE: This feature is supported as of IT Security Search version 11.4.1.

•	Working with a Quest IT Security Search subscriptions through the client

•	New-CAITSSEventSubscription

•	Get-CAITSSEventSubscriptions

•	Set-CAITSSEventSubscription

•	Remove-CAITSSEventSubscription

NOTE: These commands are in preview mode for this release.