Change Auditor 7.5 - User Guide

Set-CAQRadarEventSubscription

Set-CAQRadarEventSubscription

NOTE: A new extension must be created if the -QRadarHost or -QRadarPort has been changed.

Use this command to modify a QRadar 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 PSCAQRadarSubscriptionStatus 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-CAQRadarEventSubscriptions command to find the ID.
-QRadarHost	Specifies the IPv4 address or FQDN (fully qualified domain name) of your QRadar instance that will receive the event data.
-QRadarPort (Optional)	Specifies the port number for your QRadar instance that will receive the event data. The default port depends on whether the existing subscription is sending encrypted or unencrypted events. When TlsEnabled is set to true the default port is 6514; when set to false the default port is 514.
-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 QRadar instance. 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-CAQRadarEventSubscription -Connection $connection -QRadarHost $QRadarHost -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-CAQRadarEventSubscription -Connection $connection -QRadarHost $QRadarHost -SubscriptionId cd87b774-8e65-46e1-8520-da478c60c4c3 -Subsystems $newSubsystems

Remove-CAQRadarEventSubscription

Remove-CAQRadarEventSubscription

Use this command to remove a QRadar subscription.

Table 11. Available parameters

Parameter	Description
-Connection	A connection obtained by using the Connect-CAClient command. See the Change Auditor Command Guide for details.
-Subscription	The PSCAQRadarSubscriptionStatus 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-CAQRadarEventSubscriptions command to find the ID.

Example: Remove a QRadar subscription

Remove-CAQRadarEventSubscription -Connection $connection -SubscriptionId $subscriptionId

QRadar event subscription wizard

QRadar 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-CAQRadarEventSubscription.

To create a QRadar subscription

1	Click Add | QRadar subscription to open the wizard.

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

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

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 Next to create the required extension to import to your QRadar instance. The file instructs QRadar on how to read and present Change Auditor events. Specifically, it defines the log source (coordinator) and maps Change Auditor event columns to QRadar event columns.

NOTE: If you have previously configured your QRadar instance for Change Auditor, you can select My QRadar instance is already configured and click Finish to complete the subscription setup.

6	Specify the file path and name for the file and click Generate extension.

NOTE: If you have created a new extension, the subscription is created in the disabled state. After you have imported and applied the extension in QRadar, you need to enable the subscription.

7	Click OK in the confirmation dialog. Copy the file path to import the extension to your QRadar instance.

8	Click Finish.

To edit the QRadar subscription

1	Select the required subscription and click Edit.

2	Enter the server and port and click Next.

3	If required, you can generate a new extension.

4	Click Finish.

Managing a Micro Focus Security ArcSight Logger and Enterprise Security Manager (ESM) integration

Managing a Micro Focus Security ArcSight Logger and Enterprise Security Manager (ESM) integration

You can take advantage of the rich data gathered by Change Auditor and use it with ArcSight Logger and ArcSight Enterprise Security Manager (ESM). To begin sending event data, you need to create an ArcSight event subscription with Change Auditor.

To send encrypted Change Auditor events to ArcSight ESM or ArcSight Logger, you must set the ArcSight host and port to match the host and port of the ArcSight connector configured to receive syslog messages over TCP.

When sending encrypted events, communication between the coordinator and connector is unencrypted, however, communication between the connector and ArcSight is encrypted. For improved security:

•	Install the connector on the same computer as the coordinator sending events.

•	Ensure that the coordinator is the only coordinator permitted to send events to the connector using the AllowedCoordinators parameter.

The subscription contains information about where to send the notifications and heartbeats and the event subsystems to include.

•	Working with Change Auditor data within ArcSight

•	Working with ArcSight subscriptions through the client

•	New-CAArcSightEventSubscription

•	Get-CAArcSightEventSubscriptions

•	Set-CAArcSightEventSubscription

•	Remove-CAArcSightEventSubscription