icon/x Created with Sketch.

Splunk Cookie Policy

We use our own and third-party cookies to provide you with a great online experience. We also use these cookies to improve our products and services, support our marketing campaigns, and advertise to you on our website and other websites. Some cookies may continue to collect information after you have left our website. Learn more (including how to update your settings) here.
Accept Cookie Policy

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 RiskIQ Add-on For Splunk
SHA256 checksum (riskiq-add-on-for-splunk_110.tgz) d58a8bb63ee4af0c9a4513fb1a785189ac17a12591b0ebcbe4c87fe170dd4401 SHA256 checksum (riskiq-add-on-for-splunk_100.tgz) 1719acab8b77fc2d6cf4f258189c4a8c513f91a9808416cf90bde1c850d72611
To install your download
For instructions specific to your download, click the Details tab after closing this window.

Flag As Inappropriate

RiskIQ Add-on For Splunk

Splunk AppInspect Passed
Admins: Please read about Splunk Enterprise 8.0 and the Python 2.7 end-of-life changes and impact on apps and upgradeshere.
Overview
Details
The RiskIQ Add-on for Splunk is used to get data from the RiskIQ platform. For the dashboard with RiskIQ data, please install RiskIQ App for Splunk.

RiskIQ Add-on for Splunk

OVERVIEW

The RiskIQ Add-on for Splunk is used to get data from the RiskIQ platform. For the dashboard with RiskIQ data, please install RiskIQ App for Splunk.

  • Author - RiskIQ
  • Version - 1.1.0
  • Build - 18
  • Creates Index - False
  • Prerequisites - RiskIQ API Key, Token, Customer Name for data collection
  • Compatible with:
  • Splunk Enterprise version: 7.2, 7.3
  • OS: Platform independent

RELEASE NOTES

Version 1.1.0

  • Moved and Added lookups and custom commands in TA from main app
  • Updated /event/search API data collection to use parameter scroll instead of offset to resolve the Internal Server Error
  • Added proxy support
  • Bifurcated assets and events data into different source types
  • Provide support for enabling/disabling data inputs
  • Provided support to collect only new and updated assets information
  • Added validation for API credentials in setup page

OPEN SOURCE COMPONENTS AND LICENSES

THIRD PARTY LIBARIES

TOPOLOGY AND SETTING UP SPLUNK ENVIRONMENT

This app has been distributed in two parts.
1. RiskIQ Add-on for Splunk, which collects data from RiskIQ API.
2. RiskIQ App for Splunk helps in visualizing and analyzing RiskIQ data.

This app can be set up in two ways:
1. Standalone Mode:
* Install both the RiskIQ App for Splunk and RiskIQ Add-on for Splunk.
2. Clustered Environment:
* Install the RiskIQ App for Splunk and RiskIQ Add-on for Splunk on search head.
* To setup RiskIQ Add-on for Splunk on the search head follow below setps:
1. On Search head deployer, Go to $SPLUNK_HOME$/etc/shcluster/apps/TA-RiskIQ/local.
2. Create app.conf file and add below stanza.
[install] is_configured = 1
3. Save the file and push the bundle to search head.
* Install the RiskIQ Add-on for Splunk on heavy forwarder.
* User needs to create riqsummary index on the indexer.
* User needs to set up Add-on to start data collection on heavy forwarder.

External Data Sources

  • We are using RiskIQ API for data collection

INSTALLATION

Follow the below-listed steps to install an Add-on from the bundle:

  • Download the App package.
  • From the UI navigate to Apps->Manage Apps.
  • In the top right corner select Install app from file.
  • Select Choose File and select the App package.
  • Select Upload and follow the prompts.

UPGRADE

Follow the below steps when upgrading from TA-RiskIQ 1.0.0 to 1.1.0

  • From the UI navigate to Apps->Manage Apps.
  • In the top right corner select Install app from file.
  • Select Choose File and select the App package.
  • Check the upgrade option.
  • Select Upload and follow the prompts.
  • Restart Splunk.
  • Navigate to Settings->Data Inputs->Scripts and disable the AccessRiskIQ.py.
  • Enable riskiq_events.py and riskiq_assets.py to collect data of events and assets respectively.

CONFIGURATION

  • After the installation, you'll be asked to restart the Splunk. Click on Restart Now.
  • After the restart, you need to set up the data collection. From the UI navigate to Apps->Manage Apps->RiskIQ Add-on for Splunk->Set up.
  • Enter the following details of your RiskIQ Instance and save it.
  • API Token: RiskIQ API token
  • Key: RiskIQ API key
  • Customer: Customer name
  • Page Size: Number of results to fetch in single API call. Defaults to 500
  • Enable assets data collection: Check this to enable input and collect assets data
  • Enable events data collection: Check this to enable input and collect events data
  • Collect only new and changed assets: If this option is checked, only the new and changed assets will be collected. By default all assets are collected once in a day. To create/use default visuals displaying trend data, ingest all asset data every day by unchecking this option. To get only updated data then select this option.
  • Latest Updated Time :This option is shown when we check collect only new and changed assets. Provide the time in PST Time Zone with format(YYYY-MM-DDTHH:MM:SS.sss)
  • Enable Proxy: Check this option if you have proxy configured in your environment.
  • Proxy Scheme: Provide proxy protocol (http/https/socks4/socks5)
  • IP / Hostname: IP address or hostname of proxy instance.
  • Port: Port used to connect to proxy instance.
  • Require Authentication for Proxy: Check this option if your proxy configuration requires authentication.
  • Username: Provide proxy username
  • Password: Provide proxy password

  • By default, SSL Verification will be true. If you don't want to verify your SSL certificate, follow steps:

  • Go to $SPLUNK_HOME$/etc/apps/TA-RiskIQ/local.
  • Open appsetup.conf file and find the stanza app_config.
  • Update value of verify_ssl from true to false.
  • Save the file and restart Splunk.
    TA RiskIQ is configured and ready to be used.

CUSTOM COMMANDS

  • getcves - This command is used to get CVE(Common Vulnerabilities and Exposures) data from https://cve.mitre.org/data/downloads/allitems.csv.

ADDING SSL CERTIFICATE

If you have used SSL certificate for your domain, you need to add certificate into Splunk. Follow below-listed steps to do the same:
Go to $SPLUNK_HOME$/etc/apps/TA-RiskIQ/bin/lib/certifi.
Open cacert.pem file and add your custom certificate details at the end of the file.
* Save the file and restart the Splunk.

Note: If your vendor has published the SSL certificate publicly, no need to add that manually.

TROUBLESHOOTING

  • Field extractions not working / Search stops because of memory limit reached / Events are getting truncated/ Count mismatch on dashboards.
  • Create a file 'limits.conf' in the following directory $SPLUNK_HOME/etc/TA-RiskIQ/local.
  • Add the following 3 stanzas in the file:
      [kv]
      maxcols  = 1024
      limit    = 750
      maxchars = 50000
      max_extractor_time = 2000
      avg_extractor_time = 1000
      [mvexpand]
      max_mem_usage_mb =9000
      [lookup]
      max_memtable_bytes = 20000000
  1. Restart Splunk
  2. For the cluster environment, User needs to deploy limits.conf file on the Heavy forwarder, Indexer and Search Head.

SUPPORT

Contact - support@riskiq.com

Copyright 2016 - 2019 RiskIQ

Release Notes

Version 1.1.0
Nov. 21, 2019

v1.1.0
* Moved and Added lookups and custom commands in TA from main app
* Updated /event/search API data collection to use parameter scroll instead of offset to resolve the Internal Server Error
* Added proxy support
* Bifurcated assets and events data into different source types
* Provide support for enabling/disabling data inputs
* Provided support to collect only new and updated assets information
* Added validation for API credentials in setup page

Version 1.0.0
Aug. 16, 2019

* Added data collection from RiskIQ's web service and parsing logic for data

45
Installs
85
Downloads
Share Subscribe LOGIN TO DOWNLOAD

Subscribe Share

AppInspect Tooling

Splunk AppInspect evaluates Splunk apps against a set of Splunk-defined criteria to assess the validity and security of an app package and components.

Are you a developer?

As a Splunkbase app developer, you will have access to all Splunk development resources and receive a 10GB 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-2020 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.