Citrix Analytics for Security

Splunk integration

Notes

  • The Splunk integration feature is in preview.

  • Contact CAS-PM-Ext@citrix.com to request assistance for the Splunk integration, exporting data to Splunk, or provide feedback.

Integrate Citrix Analytics for Security with Splunk to export and correlate the users’ data from your Citrix IT environment to Splunk and get deeper insights into your organization’s security posture.

For more information about the benefits of the integration and the type of processed data that is sent to your SIEM, see Security Information and Event Management integration.

Supported versions

Citrix Analytics for Security supports Splunk integration on the following operating systems:

  • CentOS Linux 7 and later
  • Debian GNU/Linux 10.0 and later
  • Red Hat Enterprise Linux Server 7.0 and later
  • Ubuntu 18.04 LTS and later

IMPORTANT

  • Citrix recommends using the latest version of the preceding operating systems or the versions that are still under support from the respective vendors.

  • For the Linux kernel (64-bit) operating systems, use a kernel version that is supported by Splunk. For more information, see Splunk documentation.

You can configure Splunk integration on the following Splunk versions:

  • Splunk Cloud Inputs Data Manager (IDM)

  • Splunk 8.1 (64-bit) and later

Prerequisites

  • The Citrix Analytics add-on for Splunk connects to the following endpoints on Citrix Analytics for Security. Ensure that the endpoints are in the allow list in your network.

    Endpoint United States region European Union region Asia Pacific South region
    Kafka brokers casnb-0.citrix.com:9094 casnb-eu-0.citrix.com:9094 casnb-aps-0.citrix.com:9094
      casnb-1.citrix.com:9094 casnb-eu-1.citrix.com:9094 casnb-aps-1.citrix.com:9094
      casnb-2.citrix.com:9094 casnb-eu-2.citrix.com:9094 casnb-aps-2.citrix.com:9094
  • Turn on data processing for at least one data source. It helps Citrix Analytics for Security to begin the Splunk integration process.

Integrate Citrix Analytics for Security with Splunk

Follow the guidelines mentioned to integrate Citrix Analytics for Security with Splunk:

  • Data export. Citrix Analytics for Security creates a channel and exports risk intelligence. Splunk retrieves this risk intelligence from the channel.

  • Get configuration on Citrix Analytics. Create a password for your pre-defined account for authentication. Citrix Analytics for Security prepares a configuration file required for you to configure the Citrix Analytics add-on for Splunk.

  • Download and install Citrix Analytics add-on for Splunk. Download the Citrix Analytics Add-on for Splunk and upload the add-on in your Splunk to complete the installation process.

  • Configure Citrix Analytics add-on for Splunk. Set up a data input by using the configuration details provided by Citrix Analytics for Security and configure the Citrix Analytics add-on for Splunk.

After the Citrix Analytics configuration file is prepared, see:

After the Citrix Analytics add-on for Splunk is configured, see:

Data export

  1. Go to Settings > Data Sources >Security > DATA EXPORTS.

  2. On the SIEM site card, select Get Started.

    SIEM data export

Get configuration on Citrix Analytics for Security

  1. On the Configuration on Citrix Analytics section, create an account by specifying the user name and a password. This account is used to prepare a configuration file, which is required for integration.

    Configure section

  2. Ensure that the password meets the following conditions:

    SIEM password requirements

  3. Select Configure.

    Citrix Analytics for Security prepares the configuration details required for Splunk integration.

    Configure SIEM

  4. Select Splunk.

  5. Copy the configuration details, which include the user name, hosts, Kafka topic name, and group name.

    You require these details to configure Citrix Analytics Add-on for Splunk in the subsequent steps.

    IMPORTANT

    These details are sensitive and you must store them in a secure location.

    Configuration details

Download and install Citrix Analytics add-on for Splunk

  1. Log on to your Splunk Forwarder or Splunk Standalone environment.

  2. Install the Citrix Analytics add-on for Splunk by either downloading it from Splunkbase or by installing it from within Splunk.

Install app from file

  1. Go to Splunkbase.

  2. Download the Citrix Analytics Add-on for Splunk file.

  3. On the Splunk Web home page, click the gear icon next to Apps.

  4. Click Install app from file.

  5. Locate the downloaded file and click Upload.

    Notes

    • If you have an older version of the add-on, select Upgrade app to overwrite it.

    • If you are upgrading Citrix Analytics Add-on for Splunk from a version earlier than 2.0.0, you must delete the following files and folders located inside the /bin folder of the add-on installation folder and restart your Splunk Forwarder or Splunk Standalone environment:

      • cd $SPLUNK_HOME$/etc/apps/TA_CTXS_AS/bin
      • rm -rf splunklib
      • rm -rf mac
      • rm -rf linux_x64
      • rm CARoot.pem
      • rm certificate.pem
  6. Verify that the app appears in the Apps list.

Install app from within Splunk

  1. From the Splunk Web home page, click +Find More Apps.

  2. On the Browse More Apps page, search Citrix Analytics Add-on for Splunk.

  3. Click Install next to the app.

  4. Verify that the app appears in the Apps list.

Configure Citrix Analytics add-on for Splunk

Configure the Citrix Analytics add-on for Splunk using the configuration details provided by Citrix Analytics for Security. After the add-on is successfully configured, Splunk starts consuming events from Citrix Analytics for Security.

  1. On the Splunk home page, go to Settings > Data inputs.

    Splunk configuration

  2. In the Local inputs section, click Citrix Analytics Add-on.

    Splunk configuration

  3. Click New.

    Splunk configuration

  4. On the Add Data page, enter the details provided in the Citrix Analytics configuration file.

    Splunk configuration

  5. To customize your default settings, click More settings and set up the data input. You can define your own Splunk index, host name, and source type.

    Splunk configuration

  6. Click Next. Your Citrix Analytics data input is created and the Citrix Analytics add-on for Splunk is configured successfully.

Reset Citrix Analytics configuration password

If you want to reset your configuration password on Citrix Analytics for Security, do the following steps:

  1. On the Configuration on Citrix Analytics page, click Reset Password.

    SIEM reset password

  2. On the Reset Password window, specify the updated password on the NEW PASSWORD and CONFIRM NEW PASSWORD fields. Follow the password rules that are displayed.

    SIEM password requirements

  3. Click Reset. The configuration file preparation is initiated.

    SIEM reset password

Note

After you reset the configuration password, ensure you update the new password when you set up the data input on the Add Data page of your Splunk environment. It helps Citrix Analytics for Security to continue transmitting data to Splunk.

How to consume events in Splunk

After you configure the add-on, Splunk starts retrieving risk intelligence from Citrix Analytics for Security. You can start searching your organization’s events on the Splunk search head based on the configured data input.

The search results are displayed in the following format:

Splunk events consumption

A sample output:

Splunk events consumption

To search and debug issues with the add-on, use the following search query:

Splunk events consumption

The results are displayed in the following format:

Splunk events consumption

For more information about the data format, see Citrix Analytics data format for SIEM.

Citrix Analytics App for Splunk

Note

This app is in preview.

Citrix Analytics App for Splunk enables Splunk Enterprise administrators to view the user data collected from Citrix Analytics for Security in the form of insightful and actionable dashboards on Splunk. Using these dashboards, you get a detailed view of the users’ risky behavior in your organization and take timely actions to mitigate any insider threats. You can also correlate the data collected from Citrix Analytics for Security with other data sources configured on your Splunk. This correlation provides you visibility into the users’ risky activities from multiple sources and takes actions to protect your IT environment.

Supported Splunk version

The Citrix Analytics App for Splunk runs on the following Splunk versions:

  • Splunk 8.2 64-bit

  • Splunk 8.1 64-bit

  • Splunk 8.0 64-bit

  • Splunk 7.3 64-bit

Prerequisites for Citrix Analytics App for Splunk

  • Install the Citrix Analytics add-on for Splunk.

  • Ensure the prerequisites mentioned for the Citrix Analytics add-on for Splunk are already met.

  • Ensure that the data is flowing from Citrix Analytics for Security to Splunk.

Installation and configuration

Where to install the app?

Splunk search head

How to install and configure the app?

You can install the Citrix Analytics App for Splunk by downloading it from Splunkbase or by installing it from within Splunk.

Install app from file
  1. Go to Splunkbase.

  2. Download the Citrix Analytics App for Splunk file.

  3. On the Splunk Web home page, click the gear icon next to Apps.

  4. Click Install app from file.

  5. Locate the downloaded file and click Upload.

    Note

    If you have an older version of the app, select Upgrade app to overwrite it.

  6. Verify that the app appears in the Apps list.

Install app from within Splunk
  1. From the Splunk Web home page, click +Find More Apps.

  2. On the Browse More Apps page, search Citrix Analytics App for Splunk.

  3. Click Install next to the app.

Configure your index and source type to correlate data
  1. After you install the app, click Set up now.

    Set up app

  2. Enter the following queries:

    • Index and source type where the data from Citrix Analytics for Security are stored.

      Note

      These query values must be the same as specified in the Citrix Analytics add-on for Splunk. For more information, see Configure Citrix Analytics add-on for Splunk.

    • Index from which you want to correlate your data with Citrix Analytics for Security.

      Source and index

  3. Click Finish App Setup to complete the configuration.

After you have configured and set up the Citrix Analytics App for Splunk, use the Citrix Analytics dashboards to view the user events on your Splunk.

Turn on or off data transmission

After Citrix Analytics for Security prepares the configuration file, data transmission is turned on for Splunk.

To stop transmitting data from Citrix Analytics for Security:

  1. Go to Settings > Data Sources > Security > DATA EXPORTS.

  2. On the SIEM site card, select the vertical ellipsis (⋮) and then click Turn off data transmission.

    SIEM transmission turn off

To enable data transmission again, on the SIEM site card, click Turn on Data Transmission.

SIEM transmission turn on

Splunk integration