Accept License Agreements

This app is provided by a third party and your right to use the app is in accordance with the license provided by that third-party licensor. Splunk is not responsible for any third-party apps and does not provide any warranty or support. If you have any questions, complaints or claims with respect to this app, please contact the licensor directly.

Thank You

Downloading Cyphort For Splunk
MD5 checksum (cyphort-for-splunk_102.tgz) 29ef1e8f334bab543e4a691ea5d93b7d
To install your download
For instructions specific to your download, click the Details tab after closing this window.

Flag As Inappropriate

Cyphort For Splunk

Splunk Certified
Overview
Details
Cyphort For Splunk allows a Splunk® Enterprise administrator to integrate with the Cyphort Advanced intrusion detection API, and pull the relevant incidents.

Table of Contents

OVERVIEW

  • About Cyphort For Splunk
  • Release notes
  • Performance benchmarks
  • Support and resources

INSTALLATION

  • Hardware and Software Requirements
  • Installation steps
  • Deploy to a Single Server Instance
  • Deploy to a Distributed Deployment
  • Deploy to a Distributed Deployment with Search Head Clustering
  • Deploy to Splunk Cloud

USER GUIDE

  • Data types
  • Lookups
  • Configure Cyphort For Splunk
  • Troubleshooting
  • Upgrade

OVERVIEW

About Cyphort For Splunk

About Cyphort For Splunk
Developer Aplura, LLC
App Version 1.0.2
App Build 204
TA TA-CyphortForSplunk
IA IA-CyphortForSplunk
Folder Name CyphortForSplunk
Vendor Products Cyphort API 3.3.0
Has index-time operations true
Create an index false
Implements summarization false

Cyphort For Splunk allows a Splunk® Enterprise administrator to integrate with the Cyphort Advanced Intrusion Detection API and pull the relevant incidents.

Scripts and binaries

The following list of scripts are used to interact with the data being aquired.

  • $SPLUNK_HOME/etc/apps/CyphortForSplunk/bin/CyphortForSplunk.py
    • The Modular Input used to communicate and consume the API data
  • $SPLUNK_HOME/etc/apps/CyphortForSplunk/bin/ModularInput.py
    • The Modular Input Class to consume and populate Splunk with Data.
  • $SPLUNK_HOME/etc/apps/CyphortForSplunk/RESTClient.py
    • The REST Client Base Class to interact with the Cyphort API.

Release notes

These are the issues that were closed for version 1.0.2.

Release Notes - Cyphort - Version Cyphort-v1.0.2

  • Bug

    • [CYP-49] - API Doesn't Pull Events Correctly
    • [CYP-51] - Fix Display of last_activity_time
    • [CYP-52] - Fix Incident Detail View
    • [CYP-53] - Windows Rest Client Fails
    • [CYP-60] - App Health -- event retrieval results not limited to 24 hours
    • [CYP-62] - Duplicated Events from API
    • [CYP-70] - Custom Cell Renderer Expansion
    • [CYP-71] - Incident Detail Doesn't Display Raw Event Details
  • Improvement

    • [CYP-39] - v1.0.2 Documentation
    • [CYP-40] - App Certification Failures
    • [CYP-48] - Configure View to hide "incident_key" field
    • [CYP-50] - Update Cyphort API Result
    • [CYP-55] - Modular Input - Checkpoint incidents
  • New Feature

    • [CYP-68] - Create 6.5 Monitoring Console Health Checks
  • Task

    • [CYP-63] - Correct issues with the About page
  • Sub-task

    • [CYP-41] - Errors relating to Eventgen
    • [CYP-42] - Modular Input
    • [CYP-43] - Lookups
    • [CYP-44] - Dependency Documentation
    • [CYP-45] - Support Contact Information
    • [CYP-46] - Logging Configurations
    • [CYP-47] - Multiple READMEs
    • [CYP-64] - Remove punctuation in improper places
    • [CYP-65] - Reword instructions for clarification
    • [CYP-66] - README.md formatting issues
    • [CYP-67] - Minor changes to overall document

These are the issues that were closed for version 1.0.1.

  • Bug

    • [CYP-16] - Generate Lookups is failing UI testing
    • [CYP-25] - Discrepancy between data on incident overview and incident detail
    • [CYP-26] - Remove Malware Overview Dashboard
    • [CYP-32] - Last 5 Event Retrieval Doesn't Show Right Timestamp
    • [CYP-33] - Selecting Incident from Top 10 Threats on Overview Doesn't Display Correct on Details
    • [CYP-36] - Unsupported Search Structures in 6.2
    • [CYP-37] - Incident ID search results throws errors in Incident details tab
  • Improvement

    • [CYP-15] - v1.0.1 Documenation
    • [CYP-17] - App Certification Failures
    • [CYP-22] - Convert Panels to Pre-Built Panels
    • [CYP-23] - Update Documentation
    • [CYP-24] - Update Modular Input Validation
    • [CYP-27] - Update documentation for pre-built panels
    • [CYP-28] - Split app health checkpoints panel by host
    • [CYP-29] - Link in configuration menu to data input page
    • [CYP-30] - Add Data Input Dropdown to Incident Overview
    • [CYP-35] - Integer Only Axis Label.
    • [CYP-38] - Remove Administrator Functions
  • Sub-task

    • [CYP-18] - [ failure ] Check that all executable files only exist in the /bin directory of the app.
    • [CYP-20] - [ failure ] Check a valid scheme is returned via the scripts via the scheme command when using a modular input.
    • [CYP-21] - [ failure ] Check the scheme arguments match the inputs.conf.spec file when using a modular input.

These are the issues that were closed for version 1.0.0.

  • Bug

    • [CYP-13] - Custom Cell Renderer fails on 6.2
  • Improvement

    • [CYP-7] - Documentation
    • [CYP-11] - Update Overview Dashboard
    • [CYP-12] - Update Incidents Overview
  • New Feature

    • [CYP-3] - Admin Panels
    • [CYP-4] - Incident Overview
    • [CYP-5] - Incident Detail
  • Research

    • [CYP-1] - Discover API
  • Task

    • [CYP-2] - Update MI and REST
About this release

Version 1.0.2 (204) of Cyphort For Splunk is compatible with:

Item Value
Splunk Enterprise versions 6.2, 6.3, 6.4, 6.5
CIM 4.3
Platforms <platform independent="">
Vendor Products Cyphort API v3.3.0
New features

Cyphort For Splunk includes the following new features:

  • Incident Overview
  • Incident Details
  • Application Health
Fixed issues

Version 1.0.2 (204) of Cyphort For Splunk fixes the following issues:

  • No Fixed Issues. If you find an error, please contact Cyphort support.
Known issues

Version 1.0.2 (204) of Cyphort For Splunk has the following known issues:

  • No Known Issues.
Support and resources

Questions and answers

Access questions and answers specific to Cyphort For Splunk at https://answers.splunk.com.

Support

Support Offered: Yes
Support URL: https://answers.splunk.com/app/questions/3061.html
Support Email: marketing@cyphort.com

Please visit the Splunk Answers Ask Questions page to submit your question regarding Cyphort For Splunk. Please tag your question with the correct App tag (if not already tagged) and your question will be attended to.

INSTALLATION AND CONFIGURATION

Software requirements

To function properly, Cyphort For Splunk requires the following software:

  • Splunk 6.2, 6.3, 6.4, 6.5
  • Cyphort API v 3.3.0

Splunk Enterprise system requirements

Because this add-on runs on Splunk Enterprise, all of the Splunk Enterprise system requirements apply.

Download

Download Cyphort For Splunk at https://splunkbase.splunk.com/app/3061.

Installation steps

This app has the following inputs pre-configured:

None.

Deploy to single server instance

Follow these steps to install the app in a single server instance of Splunk Enterprise:

  1. Download the Cyphort For Splunk package from splunkbase.splunk.com.
  2. Install the App via the recommended installation methods (CLI, Web GUI)
  3. Restart Splunk.
  4. Configure the Modular Input with the required settings.
Deploy to distributed deployment

Install to search head

  1. Download the Cyphort For Splunk package from splunkbase.splunk.com.
  2. Install the App via the recommended installation methods (CLI, Web GUI, Deployment Server)
  3. Do NOT configure a Modular Input unless there is only 1 (one) single Search Head.

Install to indexers

  1. Download the Cyphort For Splunk package from splunkbase.splunk.com.
  2. Untar the package and locate the TA (Technology Add-On) located in "CyphortForSplunk/appserver/addons". The package will end in ".spl" and should be labeled "TA-CyphortForSplunk".
  3. Install "TA-CyphortForSplunk" onto the indexers per your environment.

Install to Universal Forwarders

  • There is no installation to Universal Forwarders.

Install to Heavy Forwarders

  1. Download the Cyphort For Splunk package from splunkbase.splunk.com.
  2. Untar the package and locate the IA (Input Add-On) located in "CyphortForSplunk/appserver/addons". The package will end in ".spl" and should be labeled "IA-CyphortForSplunk".
  3. Install "IA-CyphortForSplunk" onto a heavy forwarder in your environment.
  4. Configure the Modular Input with the required settings.

Deploy to distributed deployment with Search Head Clustering

  1. Place the App into the "deploy_apps" folder on the Deployer Server.
  2. Follow the instructions to install to a Heavy Forwarder. This Step is REQUIRED in a clustered SH environment!
  3. Deploy the App to the Search Head Cluster. DO NOT install "IA-CyphortForSplunk" to the Cluster!

Deploy to Splunk Cloud

  • Instruct the Splunk Cloud Support team to follow the instructions above that matches the Cloud environment.

Summary

USER GUIDE

Data types

This app provides the index-time and search-time knowledge for the following types of data from Cyphort:

  • cyphort:api
    • This data feed is the result of the calls to the Cyphort API. If you aren't receiving incidents check here for a possible explanation.
  • CyphortForSplunk:error
    • This data feed is the result of any errors presented during the consumption of Cyhport API data.
  • cyphort:incident
    • This data feed is the output of the Incidents pulled from the Cyphort API data stream.

Pre-Built Panels

Cyphort For Splunk uses pre-built panels on the Incident Overview dashboard. When cloning panels to new/existing dashboards make sure to use
the pre-built panels. Pre-built panels ensure that if a panel is removed and re-added to a dashboard (or if they are added to a new
dashboard) the panel will function as expected. As an example, panels on the incident overview drilldown to the incident detail dashboard.

Procedure to add existing panels to dashboards:

  1. Select the Edit dropdown and choose Edit Panels from the menu.
  2. Click the +Add Panel button.
  3. Check under Add Prebuilt Panel to see if an appropriate panel already exists. If so, select this panel.
  4. Create a new panel by clicking the Add to Dashboard button.
  5. Click the Done button after the panel(s) have been added.

Lookups

Cyphort For Splunk contains no lookup files.

Event Generator

Cyphort For Splunk makes use of an event generator. This allows the product to display data when there are no inputs configured.

There are two samples to be used for event generation. These samples are found in the samples folder of the app.
- cyphort_incident.sample
- cyphort_event.sample

Configure Cyphort For Splunk

  • Install the App according to your environment (see steps above)
  • Navigate to "Settings > Data Inputs > Cyphort For Splunk"

Modular Input

NOTE: You will need to configure a new modular input for each data source.

  1. Navigate to Settings -> Data Inputs
  2. Either click on "Cyphort For Splunk" and then the New button or the Add New link on the same row in the Actions column.
  3. Enter the appropriate infomation in the following fields. Required fields have an asterisk (*) next to them.
  4. Name: Descriptive name for the modular input
  5. Hostname: FQDN of Cyphort appliance
  6. Token: API token issued from the Cyphort appliance for authentication

Note: Click the More Settings checkbox to expose the following options.

  • Interval: The number of seconds before running the command again or a valid cron schedule. Ensure that the interval setting is a minimum of 300 seconds.
  • Set sourcetype: Set to Automatic and should not be changed unless directed to by support.
  • Host: Set the hostname on the events with the entered value.
  • Index: The index setting must be changed to the index where the Cyphort data is to be stored. Failure to change this setting from the default option will result in data being written to the main index.
  • Press the Next button to save the configuration

Troubleshoot Cyphort For Splunk

The best place to start troubleshooting Cyphort For Splunk is using the App Health dashboard under the Administration dropdown. There you will find several panels with information related to errors in the Cyphort For Splunk app.

Additionally the following search may be performed:

eventtype = cyphort_error OR eventtype = cyphort_internal_error

Upgrade Cyphort For Splunk

Upgrade Cyphort For Splunk by re-installing into your environment per Splunk Documentation and your environment (see steps above).

Dependencies

Cyphort For Splunk has dependencies and in this case are all-included within the App.

  1. D3
  2. jQuery
  3. Markdown.js

Knowledge Documentation

The following information is useful to know about how this app handles data.

  1. Summary Indexing: No
  2. Data Model Acceleration: No
  3. Report Acceleration: No

Third-party software attributions

Version 1.0.1 (134) of Cyphort For Splunk incorporates the following third-party software or libraries.
Please see full readme for the Licenses.

Release Notes

Version 1.0.2
Nov. 23, 2016

Bug fixes. Modular Input improvements. See Documentation for full list of updates.

20
Installs
211
Downloads
Share Subscribe LOGIN TO DOWNLOAD

Subscribe Share

Splunk Certification Program

Splunk's App Certification program uses a specific set of criteria to evaluate the level of quality, usability and security your app offers to its users. In addition, we evaluate the documentation and support you offer to your app's users.

Are you a developer?

As a Splunkbase app developer, you will have access to all Splunk development resources and receive a 50GB license to build an app that will help solve use cases for customers all over the world. Splunkbase has 1000+ apps and add-ons from Splunk, our partners and our community. Find an app or add-on for most any data source and user need, or simply create your own with help from our developer portal.

Follow Us:
© 2005-2018 Splunk Inc. All rights reserved.
Splunk®, Splunk>®, Listen to Your Data®, The Engine for Machine Data®, Hunk®, Splunk Cloud™, Splunk Light™, SPL™ and Splunk MINT™ are trademarks and registered trademarks of Splunk Inc. in the United States and other countries. All other brand names, product names, or trademarks belong to their respective owners.