Chat now with support

Get Live Help
Complete Registration

Sign In

Request Pricing

Contact Sales

Change Auditor 7.2 - SIEM Integration User Guide

Table of Contents

Integrating Change Auditor and SIEM Tools

Webhooks in Change Auditor Webhook terminology Subscription configuration process

Subscription Management

Adding the PowerShell module Viewing available commands and help Connecting to Change Auditor Managing subscriptions

New-CAEventWebhookSubscription Get-CAEventWebhookSubscriptions Set-CAEventWebhookSubscription Remove-CAEventWebhookSubscription Get-CAEventExportSubsystems

Working with event subscriptions in the client Managing a Splunk integration

Working with Splunk subscriptions through the client New-CASplunkEventSubscription Get-CASplunkEventSubscriptions Set-CASplunkEventSubscription Remove-CASplunkEventSubscription

Managing an IBM QRadar integration

Working with QRadar subscriptions through the client New-CAQRadarExtension New-CAQRadarEventSubscription Get-CAQRadarEventSubscriptions Set-CAQRadarEventSubscription Remove-CAQRadarEventSubscription

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

Working with Change Auditor data within ArcSight Working with ArcSight subscriptions through the client New-CAArcSightEventSubscription Get-CAArcSightEventSubscriptions Set-CAArcSightEventSubscription Remove-CAArcSightEventSubscription

Managing a Quest IT Security Search integration (Preview)

Working with a Quest IT Security Search subscriptions through the client New-CAITSSEventSubscription Get-CAITSSEventSubscriptions Set-CAITSSEventSubscription Remove-CAITSSEventSubscription

Managing a Syslog integration

Working with Syslog subscriptions through the client New-CASyslogEventSubscription Get-CASyslogEventSubscriptions Set-CASyslogEventSubscription Remove-CASyslogEventSubscription

Webhook technical insights

Handling webhook responses

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

Working with Change Auditor data within ArcSight

The following table describes how Change Auditor event details are mapped to the event details provided in ArcSight’s Common Event Format (CEF) extensions. All other Change Auditor columns not listed here will display as custom columns in ArcSight.


	NOTE: Columns that do not contain any event data will not display in ArcSight.

Table 12. Mapping information
Change Auditor column	ArcSight column
Subsystem	deviceEventClassId
Event	name
Severity	agentSeverity
Action	categoryBehaviour
Result	categoryOutcome
Server FQDN	deviceHostName
IP Address	deviceAddress
ID	eventId
Origin IPv4	sourceAddress
Origin IPv6	c6a2
Origin	sourceHostName
User SID	sourceUserId
User	sourceUserName
Description	message
Time Detected	endTime
Time Detected	startTime


	NOTE: Some Change Auditor events exceed ArcSight’s recommended supported event data length. If a Change Auditor event exceeds this limit, the event data is continued in new ArcSight events to ensure all data is stored.

Working with ArcSight subscriptions through the client

To create an ArcSight subscription

1

From the Administration Tasks, select Configuration | Event Subscriptions.

2

Click Add ArcSight Subscription to open the event subscription wizard.

3

Specify the IPv4 address or FQDN (fully qualified domain name) of the computer where ArcSight Logger or the ArcSight connector is installed.

4

Specify the port number for the ArcSight Logger or the ArcSight connector. The default port is 515.

5

Click Next to select the events to forward based on subsystem and event date. Once the subscription is created the starting event date and time cannot be changed.

•

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 installation date.

•

Select the subsystems to include in the subscription.

6

Click Finish.

To view existing ArcSight subscription details:

1

From the Administration Tasks, select Configuration | Event Subscriptions.

2

Expand the required subscription.

The summary page displays the type of subscription (Target), where the events are being sent, the subscription status (Enabled or Disabled), and when the last event was sent (Last Event).

To edit the ArcSight subscription

1

From the Administration Tasks, select Configuration | Event Subscriptions.

2

Select the required subscription and click Edit.

3

If required, enter the server and port and click Next.

4

If required, add and remove the subsystems included in the subscription.

5

Click Finish.

To remove a subscription

1

From the Administration Tasks, select Configuration | Event Subscriptions.

2

Select the required subscription and click Delete.

3

Confirm the removal.

To enable and disable a subscription

•

When viewing the summary information, select the status column and choose to enable or disable the subscription as required.

To refresh the summary information

1

From the Administration Tasks, select Configuration | Event Subscriptions.

2

Click Refresh.

New-CAArcSightEventSubscription

Use this command to create the subscription required to send Change Auditor event data to ArcSight.

Table 2. Available parameters

A connection obtained by using the Connect-CAClient command. See the Change Auditor Command Guide for details.

Specifies the IP address or host name of the computer where ArcSight Logger or the ArcSight connector is installed.

-ArcSightPort (Optional)

The port number for the ArcSight Logger or the ArcSight connector. The default port is 515.

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.

-StartTimeUTC (Optional)

Specifies date and time from which events should be sent. The default is to start sending events from the time when the subscription is created.

•

20 July, 2020 12:01 PM uses local time

•

2020-07-20 12:10:00Z uses UTC time

The time will be local unless you specify the required flag to convert to UTC.

NOTE: The time cannot be more than 30 days prior to the Change Auditor installation date.

-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. Heatbeat notifications cannot be sent directly to ArcSight. To use this parameter, you must use a previously created webhook URL.

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 message.

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

-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 Office 365 and Azure Active Directory events. When set to false, the additionalDetails field is not included.

By default, this is set to false.

Example: Create a subscription to send all subsystems event data to a computer where ArcSight Logger or the ArcSight connector is installed

$allSubsystems = Get-CAEventExportSubsystems -Connection $connection

New-CAArcSightEventSubscription -Connection $connection -ArcSightHost $ArcSightHost -Subsystems $allSubsystems

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating

© ALL RIGHTS RESERVED. Terms of Use Privacy Cookie Preference Center