Splunk integration

Previously, users were unable to correlate information about their organization’s security risk capabilities such as risk indicators, user profiles, and risk scores. Hence, users were unable to gain actionable insights to this information. To meet this requirement, Citrix Analytics allows users to integrate with Splunk.

Splunk integration helps you to export data analyzed for risky events from Citrix Analytics into your Splunk environment. You can search, collect, and analyze data from multiple data sources on a single platform. Using this data, you can troubleshoot and monitor the events.

Benefits of Splunk integration

  • Greater visibility of security alerts in a centralized place.

  • Centralized approach to detect potential security threats for organizational risk analysis capabilities such as risk indicators, user profiles, and risk scores.

  • Ability to combine and correlate the Citrix Analytics risk intelligence information of a user account with external data sources, within Splunk.

Prerequisites

Turn on data processing for at least one data source. It helps Citrix Analytics to begin the Splunk integration process.

How to integrate Citrix Analytics with Splunk

Follow the guidelines mentioned to integrate Citrix Analytics with 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 > DATA EXPORTS.

  2. On the Splunk site card, select Get Started. You get redirected to the Configure Splunk Integration page.

    Data export

  3. On the Configure Splunk Integration page, navigate to the Configuration on Citrix Analytics section.

Get configuration on Citrix Analytics

  1. Create a password for your pre-defined account by updating the PASSWORD and CONFIRM PASSWORD fields. Ensure you follow the password rules displayed.

    Citrix Analytics configuration

  2. Click Configure. Citrix Analytics starts preparing a configuration file required for Splunk integration. You receive a notification when the file is prepared. Details such as user name, host, topic name, and group name are provided in the CONFIGURATION DETAILS section.

    Citrix Analytics configuration

Download Citrix Analytics add-on for Splunk

  1. Go to the Citrix Analytics Add-on for Splunk Download page (logon is required).

  2. Click Download File.

    Citrix Analytics configuration

  3. On the End-User License Agreement screen, read the terms and conditions, and then select Yes, I accept. The download process is initiated.

    Citrix Analytics configuration

  4. On the Download Agreement screen, read the terms and conditions. To acknowledge, select the I have read and certify that I comply with the above Export Control Laws check-box.

  5. Click Accept.

    Citrix Analytics configuration

Install Citrix Analytics add-on for Splunk

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

    Splunk installation

  2. Navigate to Apps.

    Splunk installation

  3. Click the Manage Apps icon that is displayed next to Apps.

    Splunk installation

  4. On the Apps page, click Install app from file.

    Splunk installation

  5. In the Upload an app section, select the TA_CTXS_AS.tar.gz app. If there is an app upgrade, click Upgrade app. Checking this will overwrite the app if it already exists.

    Splunk installation

  6. Click Upload. You receive a notification message on the Apps page that the add-on is installed. The Citrix Analytics Add-on for Splunk app is displayed in the Apps list.

    Splunk installation

Configure Citrix Analytics add-on for Splunk

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

  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, follow the steps mentioned below:

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

    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.

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

    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 to continue transmitting data to Splunk.

Turn on or turn off data transmission

After the Citrix Analytics configuration file is prepared, data transmission is turned on for Splunk. Citrix Analytics can transmit risk intelligence information to Splunk.

To stop transmitting data from Citrix Analytics:

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

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

    Data transmission

  3. To confirm, click Turn off data transmission.

    Data transmission

How to consume events in Splunk

After you configure the add-on, Splunk starts retrieving risk intelligence from Citrix Analytics. 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 is provided below:

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

Supported versions

Citrix Analytics supports Splunk integration on the Ubuntu 18.04.1, Red Hat Enterprise Linux Server 7.x, Debian GNU/Linux 9, CentOS Linux 7.x, and SUSE Linux Enterprise Server 12 operating systems.

You can configure Splunk integration on the following Splunk versions:

  • Splunk 7.2 64-bit
  • Splunk 7.1 64-bit
  • Splunk 7.0 64-bit
  • Splunk 6.6 64-bit
  • Splunk 6.5 64-bit