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

We are working on something new...

A Fresh New Splunkbase
We are designing a New Splunkbase to improve search and discoverability of apps. Check out our new and improved features like Categories and Collections. New Splunkbase is currently in preview mode, as it is under active development. We welcome you to navigate New Splunkbase and give us feedback.

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 IPQualityScore (IPQS) Threat Risk Scoring
SHA256 checksum (ipqualityscore-ipqs-threat-risk-scoring_121.tgz) 1860e5c41c630de8c7c3be8faa97eb8b622d9c602b7d5dedb8291c4b71b778af SHA256 checksum (ipqualityscore-ipqs-threat-risk-scoring_120.tgz) 02a0594a8abb4b2e1404d39adfaba8fee4716d6e8c7d08b19ec5ddc8f81b9caf SHA256 checksum (ipqualityscore-ipqs-threat-risk-scoring_110.tgz) 68a791b004c7c5323935013f72e57cc45b9924f268cc4b98c56445c6bc906d37 SHA256 checksum (ipqualityscore-ipqs-threat-risk-scoring_1011.tgz) 42c03281f095af202ee6220903957033d1ec3925302fecea4e14cd11f34ab4b3 SHA256 checksum (ipqualityscore-ipqs-threat-risk-scoring_109.tgz) 37049e2c5a715c79e10ebbfa8ed1aa5a620fc7fa8801c22abf0b5684b5d45758 SHA256 checksum (ipqualityscore-ipqs-threat-risk-scoring_108.tgz) f7d52eb27cef503f96494c4503927d255f2de62343004b8887bebc5dbed44045
To install your download
For instructions specific to your download, click the Details tab after closing this window.

Flag As Inappropriate

splunk

IPQualityScore (IPQS) Threat Risk Scoring

Splunk Cloud
Overview
Details
Expand intelligence for IP address reputation (including proxy, TOR, & VPN detection), email address risk scoring, domain intelligence, and malicious URL scanning. Tap into the largest honeypot network online featuring the most accurate detection for residential proxies, botnets, compromised devices/websites, private VPN networks, and similar abusive IP addresses. Worldwide coverage ensures high risk users, cyber threats, and suspicious logins can be accurately detected in any region.

Email risk scoring provides additional security for filtering registrations and user details. Detect disposable email services and high risk email addresses recently used for fraudulent behavior online. Abuse monitored by IPQS includes chargebacks, payment fraud, fake accounts, account takeover (ATO), credential stuffing, business email compromise (BEC), bot activity, and similar high risk behavior.

Live URL scanning identifies malicious links including phishing and malware. Detect low reputation domains including parked domains, spammers, and similar threats. Machine learning and artificial intelligence identify suspicious URLs in real-time.

Search data from the dark web including database leaks and user data compromises along with threat data reported by Fortune 500s and the most popular sites online.

This Splunk addon provides custom commands to interact with IPQualityScore REST API. Supported endpoints include:

- IP Reputation - Proxy & VPN Detection API
- Email Validation & Risk Scoring API
- Malicious URL Scanner & Domain Reputation API
- Phone Reputation API

More details on the API can be found at IPQualityScore Documentation page at: https://www.ipqualityscore.com/documentation/overview
Learn more about our threat intelligence feeds: https://www.ipqualityscore.com/threat-intelligence-feed-api

Documentation for the Splunk add-on commands can be found here: https://ta-ipqualityscore.readthedocs.io

IPQS is a leading fraud prevention and cyber threat company providing enterprise grade solutions that fit any sized businesses. Benefit from over 10 years of technology in identifying the latest trends and threats by bad actors online.

Create a free account at: https://www.ipqualityscore.com/create-account/splunk

IPQualityScore (IPQS) Threat Risk Scoring

Table of Contents

OVERVIEW

  • About IPQualityScore (IPQS) Threat Risk Scoring
  • Release notes
  • Support and resources

INSTALLATION

  • Hardware and software requirements
  • Installation steps

USER GUIDE

  • Key concepts
  • Usage (command/lookup documentation)
  • Configuration
  • Troubleshooting

OVERVIEW

About IPQualityScore (IPQS) Threat Risk Scoring

Author IPQualityScore
App Version 1.2.0
Vendor Products IPQualityScore
Has index-time operations false
Create an index false
Implements summarization false

The IPQualityScore fraud detection API suite features a variety of different risk analysis APIs designed to Proactively Prevent Fraud™ with industry leading accuracy to identify fraudulent users, suspicious payments, and abusive behavior. From small and medium sized businesses to enterprise companies and the internet's most popular sites, IPQS has the right solutions to solve your challenges with online fraud prevention and user validation.

IPQualityScore (IPQS) Threat Risk Scoring allows a Splunk® Enterprise administrator to run insight queries from an included dashboard, as well as through search commands.

Release notes

About this release

Version 1.2.0 of IPQualityScore (IPQS) Threat Risk Scoring is compatible with:

Splunk Enterprise versions 9.3, 9.2, 9.1, 9.0, 8.2, 8.1, 8.0
CIM 5.x
Platforms Platform independent
Vendor Products IPQualityScore
Lookup file changes N/A
Features

Version 1.2.0 Released: 2024-December

  • Added Dark Web Leak API command.

  • Added IPQS Account Management Login History API command.

  • Lookup ipdetection command queries from *.ipqs db files.

Support and resources

Support for this app is provided by IPQualityScore. Please send questions to support@ipqualityscore.com

  • Hours: 9AM-5PM Monday-Frday
  • Observed Holidays: Major US Holidays

INSTALLATION AND CONFIGURATION

Hardware and software requirements

Hardware requirements

This app has no hardware requirements.

Software requirements

IPQualityScore (IPQS) Threat Risk Scoring can run on either Windows or Linux.

Splunk Enterprise system requirements

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

Download

Download IPQualityScore (IPQS) Threat Risk Scoring at https://splunkbase.splunk.com/app/5423.

Installation steps

To install and configure this app on your supported platform, follow these steps:

  1. Download app from Splunkbase
  2. Place [app.tar.gz] somewhere on your Search Head
  3. Install using splunk command:
    splunk install app /path/to/app.tar.gz
  4. Set API key. This can be done in Splunkweb by clicking "Setup" in the app's navigation bar.

USER GUIDE

Usage

Once configured, the easiest way to use this app is through the built-in dashboard. Choose a time range, select indicator type and type indicator value and press enter.

IPQualityScore (IPQS) Threat Risk Scoring also comes with multiple commands and a lookup so that you can incorporate queries into your own searches and dashboards. Below is usage documentation for all three of them.

Adaptive response action

If you use Splunk's Enterprise Security product, this app includes an adaptive response action which can be used from the Incident Review view. Select any notable event you wish to run a Insight query against, select "Run Adaptive Response Actions" and then "Insight Lookup". Select the indicator type from dropdown (ip address, domain, email address, url, phone number), type of the value of indicator (eg.1.1.1.1) and any other inputs needed. Click "Run", and then refresh the adaptive responses panel of that notable events. Clicking "Insight Lokup" in that panel will send you to a search containing the output of your lookup.

ipdetection command

Runs a IPQualityScore Proxy Detection & Fraud Prevention API against the given Ioc Value and will return the latest results.
Supported indicator types are IP.

Syntax

... | ipdetection field=<field_name> [strictness=<int>] [user_agent=<string>] [user_language=<string>] [fast=(true|false)] [mobile=(true|false)] [allow_public_access_points=(true|false)] [lighter_penalties=(true|false)] [transaction_strictness=<int>]

Examples

… | ipdetection field=”src_ip” strictness=2 fast=true

emailvalidation command

Runs a IPQualityScore Email Validation API against the given Ioc Value and will return the latest results.
Supported indicator types are Email.

Syntax

… | emailvalidation field=<field_name> [fast=(true|false)] [timeout=<int>] [suggest_domain=(true|false)] [strictness=<int>] [abuse_strictness=<int>]

Examples

… | emailvalidation field=”email_address” strictness=2 timeout=30

urlchecker command

Runs a IPQualityScore Malicious URL Scanner & Domain Reputation API against the given Ioc Value and will return the latest results.
Supported indicator types are Domain.

Syntax

… | urlchecker field=<field_name> [strictness=<int>] [fast=(true|false)] [timeout=<int>]

Examples

… | urlchecker field=”redirect_url” strictness=2 fast=false timeout=2

phonevalidation command

Runs a IPQualityScore Phone Validation & Reputation API against the given Ioc Value and will return the latest results.
Supported indicator types are Phone.

Syntax

… | phonevalidation field=<field_name> [strictness=<int>] [country=<string>][enhanced_line_check=(true|false)] [enhanced_name_check=(true|false)]

Examples

… | phonevalidation field=”phone” strictness=2

leakeddata command

Runs a IPQualityScore Dark Web Leak API against the given Ioc Value and will return the leaked data.
Supported indicator types are Email, Password, Username.

Syntax

_… | leakeddata field=<field_name> field_type=username|password|email

Examples

_… | urlchecker field=”redirect_url” field_type=email

ipqsipreputation command

Runs a IPQualityScore Proxy Detection & Fraud Prevention API against the given Ioc Value and will return the latest results.
Supported indicator types are IP.

Syntax

... | ipdetection value=1.1.1.1 [strictness=<int>] [user_agent=<string>] [user_language=<string>] [fast=(true|false)] [mobile=(true|false)] [allow_public_access_points=(true|false)] [lighter_penalties=(true|false)] [transaction_strictness=<int>]

Examples

… | ipqsipreputation value=1.1.1.1 strictness=2 fast=true

ipqsemailvalidation command

Runs a IPQualityScore Email Validation API against the given Ioc Value and will return the latest results.
Supported indicator types are Email.

Syntax

… | ipqsemailvalidation value=abc@test.com [fast=(true|false)] [timeout=<int>] [suggest_domain=(true|false)] [strictness=<int>] [abuse_strictness=<int>]

Examples

… | ipqsemailvalidation value=abc@test.com strictness=2 timeout=30

ipqsurlscanner command

Runs a IPQualityScore Malicious URL Scanner & Domain Reputation API against the given Ioc Value and will return the latest results.
Supported indicator types are Domain.

Syntax

… | ipqsurlscanner value=google.com|https://google.com [strictness=<int>] [fast=(true|false)] [timeout=<int>]

Examples

… | urlchecker value=google.com strictness=2 fast=false timeout=2

ipqsphonevalidation command

Runs a IPQualityScore Phone Validation & Reputation API against the given Ioc Value and will return the latest results.
Supported indicator types are Phone.

Syntax

… | ipqsphonevalidation value=91 9999900000 [strictness=<int>] [country=<string>][enhanced_line_check=(true|false)] [enhanced_name_check=(true|false)]

Examples

… | ipqsphonevalidation value=91 9999900000 strictness=2

ipqsleakeddata command

Runs a IPQualityScore Dark Web Leak API against the given Ioc Value and will return the leaked data.
Supported indicator types are Email, Password, Username.

Syntax

_… | ipqsleakeddata value=abc@test.com value_type=username|password|email

Examples

_… | ipqsleakeddata value=abc@test.com value_type=email

ipqsloginhistory command

Runs a IPQS Login History API that provides detailed insights into recent and historical login events and authentication attempts on your IPQS account, enabling you to track unauthorized access attempts, detect suspicious activity, and conduct thorough security audits.

Syntax

_… | ipqsloginhistory

Configure IPQualityScore (IPQS) Threat Risk Scoring

The only configuration needed for this app is setting an API key. This can be done in Splunkweb by clicking "Set up" on the "Manage apps" page, or through commandline by editing password.conf.

For IPQS Reputation Database

Please provide the URL path for IPQS Local Database search in the 'IPQS IPV4 DB File URL' and 'IPQS IPV6 DB File URL' accordingly.

Troubleshooting

Problem
App returns error "Authorization failed. Check API key".

Cause
API Key is missing or incorrect.

Resolution
Check that your API key is entered correctly.

Problem
App returns error "Query limit reached".

Cause
You have reached your query limit.

Resolution
Wait until your limit reset (probably daily at midnight) until making more queries.

Release Notes

Version 1.2.1
April 4, 2025

App reload after upgrade.

Version 1.2.0
Dec. 31, 2024

Version 1.2.0 Released: 2024-December

  • Added Dark Web Leak API command.

  • Added IPQS Account Management Login History API command.

  • Lookup ipdetection command queries from *.ipqs db files.

Version 1.1.0
Dec. 21, 2023
About this release

Version 1.1.0 Released: 2023-December
* Added Phone Validation & Reputation API command.

  • Application with search commands and enrichment dashboard, provided with various validations.
Version 1.0.11
June 1, 2022

Version 1.0.11

  • Additional logging to debug instances where all events do not contain the field specified
  • Updated ipdetection command with the following new features
    -- Added alternative field "ip_field" to supply IP Address to the command
    -- Changes the user_agent and user_language to a user provided field name instead of the static strings
Version 1.0.9
April 15, 2022
  • Bug fix to add missing options of user_agent and user_language to ipdetection command
  • Updated for Splunk 8.2.5 compliance
Version 1.0.8
June 9, 2021
  • Bug fix to resolve issue with non repeating items
  • Update for compliance with jQuery 3.5

Subscribe Share

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 from Splunk, our partners and our community. Find an app for most any data source and user need, or simply create your own with help from our developer portal.

Follow Us:
Splunk, Splunk>,Turn Data Into Doing, Data-to-Everything, and D2E are trademarks or registered trademarks of Splunk LLC in the United States and other countries. All other brand names,product names,or trademarks belong to their respective owners.