Change Auditor 7.5 - User Guide

Remove-CAITSSEventSubscription

Remove-CAITSSEventSubscription

Use this command to remove an IT Security Search subscription.

Table 18. Available parameters

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

Example: Remove an IT Security Search subscription

Remove-CAITSSEventSubscription -Connection $connection -SubscriptionId $subscriptionId

IT Security Search event subscription wizard

IT Security Search event subscription wizard

From the Event Subscription Wizard you can add and edit an IT Security Search subscription.

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

To create a IT Security Search subscription

1	Click Add | IT Security Search subscription to open the wizard.

Use https://[hostname]:[port]/warehouse/changeauditor/events.

2	Enter the username, password, and domain used to sign into the IT Security Search client.

3	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 collecting and sending events, click Send events starting and select the desired date and time. You can select to send historical data; however, 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.

4	Click Finish.

To edit the event URL for a subscription

1	Select the required subscription and click Edit.

2	Enter the new URL and click Finish.

Managing a Syslog integration

Managing a Syslog integration

To send the rich events gathered by Change Auditor to a Syslog server, 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.

•	Working with Syslog subscriptions through the client

•	New-CASyslogEventSubscription

•	Get-CASyslogEventSubscriptions

•	Set-CASyslogEventSubscription

•	Remove-CASyslogEventSubscription

Working with Syslog subscriptions through the client

Working with Syslog subscriptions through the client

To create a subscription

1	From the Administration Tasks, select Configuration | Event Subscriptions.

2	Click Add Syslog Subscription to enter the required information.

3	Specify the IPv4 address or FQDN (fully qualified domain name) of the computer where the Syslog server is installed.

4	Specify the port number.

5	Specify the message format (LEEF or CEF) and whether TLS encryption is required. By default, this is enabled.

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

▪	Select the subsystems to include in the subscription.

7	Click Finish.

To view existing 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 (Destination), the subscription status (Enabled or Disabled), and when the last event was sent (Last Event).

To edit a 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.

4	If required, select the message format (LEEF or CEF) and whether TLS encryption is required.

5	Click Next.

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

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