IntelFinder CDF
The web format of this guide reflects the most current release. Guides for older iterations are available in PDF format.
Integration Details
ThreatQuotient provides the following details for this integration:
Current Integration Version | 1.0.0 |
Compatible with ThreatQ Versions | >= 4.21.0 |
Support Tier | ThreatQ Supported |
Introduction
IntelFinder is operated by Inteller ltd, an expert in web intelligence automation. They productized their proprietary technology, which has been used to serve Fortune 500 companies and government agencies for over 5 years, to create the world’s first fully automated and scalable threat intelligence solution.
The IntelFinder CDF provides the following feed:
- IntelFinder Alerts -
https://dash.intelfinder.io/api.php
The CDF ingests reports and report attributes into the ThreatQ platform.
Installation
This integration can be installed in the My Integration section of your ThreatQ instance. See the Adding an Integration topic for more details.
Configuration
ThreatQuotient does not issue API keys for third-party vendors. Contact the specific vendor to obtain API keys and other integration-related credentials.
To configure the integration:
- Navigate to your integrations management page in ThreatQ.
- Select the Commercial option from the Category dropdown (optional).
If you are installing the integration for the first time, it will be located under the Disabled tab.
- Click on the integration entry to open its details page.
- Enter the following parameter under the Configuration tab:
Parameter Description API Key The IntelFinder API Key for the account whose alerts will be fetched. - Review any additional settings, make any changes if needed, and click on Save.
- Click on the toggle switch, located above the Additional Information section, to enable it.
ThreatQ Mapping
IntelFinder Alerts
POST https://dash.intelfinder.io/api.php
Sample Response:
{
"code": 0,
"alerts_number": 1,
"alerts": [
{
"_id": "5d9dd07c1d41c80c1864b4a6",
"subscription": "Domain Expiration",
"priority": 3,
"status": 1,
"added_on": "2019-10-05 12:15:12",
"last_update": "2019-10-05 12:15:12",
"keyword": "google.com",
"title": "A Domain is About to Expire",
"description": "Please note that one of your domains is about to expire.",
"details": "%elements%",
"recommendation": "We recommend renewing the domain.",
"base_elements": [
{
"label": "Domain",
"value": "google.com"
},
{
"label": "Expiration Date",
"value": "September 30th, 2019"
}
],
"comments": [],
"updates": [],
"elements": [
{
"label": "Domain",
"value": "google.com"
},
{
"label": "Expiration Date",
"value": "September 30th, 2019"
}
]
}
]
}
ThreatQuotient provides the following default mapping for this feed:
Feed Data Path | ThreatQ Entity | ThreatQ Object Type or Attribute Key | Published Date | Examples | Notes |
---|---|---|---|---|---|
.alerts[]._id | Report.Value, Report.Attribute | N/A | .alerts[].added_on | 5d9dd07c1d41c70c1864b4a6 | Report.Value Formatted as {{.alerts[]._id}} - {{.alerts[].title}} ; Report.Attribute unformatted |
.alerts[].title | Report.Value | N/A | .alerts[].added_on | A Domain is About to Expire | Formatted as {{.alerts[].id}} - {{.alerts[].title}} |
.alerts[].description | Report.Description | N/A | N/A | Please note that one of your domains is about to expire. | |
.alerts[].subscription | Report.Attribute | Subscription | N/A | Domain Expiration | |
.alerts[].priority | Report.Attribute | Priority | N/A | Medium | Formatted as [Very Low, Low, Medium, High, Urgent] from 1-5 |
.alerts[].indicator_status | Report.Attribute | Status | N/A | Active | Formatted as [Active, Active, Expired, Expired, Whitelisted] from 1-5 |
.alerts[].keyword | Report.Attribute | Keyword | N/A | google.com | |
.alerts[].images | Report.Attribute | Image | N/A | ||
.alerts[].link | Report.Attribute | Link | |||
.alerts[].elements[].value | Report.Attribute | .alerts[].elements[].label | September 30th, 2019 | Attribute Key is dynamically set according to response data |
Average Feed Run
Object counts and Feed runtime are supplied as generalities only - objects returned by a provider can differ based on credential configurations and Feed runtime may vary based on system resources and load.
IntelFinder Alerts
Metric | Result |
---|---|
Run Time | < 1 minute |
Reports | 25 |
Report Attributes | 400 |
Change Log
- Version 1.0.0
- Initial release
PDF Guides
Document | ThreatQ Version |
---|---|
IntelFinder CDF Guide v1.0.0 | 4.21.0 or Greater |