Proofpoint Threat Insights 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 | >= 5.6.0 |
Support Tier | ThreatQ Supported |
Introduction
The Proofpoint Threat Insights CDF enables analysts to automatically ingest blog posts from the Proofpoint website in order to stay up-to-date on advisories, bulletins, and analyses from the Proofpoint team.
The integration provides the following feed:
- Proofpoint Threat Insights - ingests blog posts into ThreatQ.
The integration ingests Reports and Indicator type objects.
Installation
Perform the following steps to install the integration:
The same steps can be used to upgrade the integration to a new version.
- Log into https://marketplace.threatq.com/.
- Locate and download the integration yaml file.
- Navigate to the integrations management page on your ThreatQ instance.
- Click on the Add New Integration button.
- Upload the integration yaml file using one of the following methods:
- Drag and drop the file into the dialog box
- Select Click to Browse to locate the file on your local machine
- Select the individual feeds to install, when prompted and click Install.
ThreatQ will inform you if the feed already exists on the platform and will require user confirmation before proceeding. ThreatQ will also inform you if the new version of the feed contains changes to the user configuration. The new user configurations will overwrite the existing ones for the feed and will require user confirmation before proceeding.
The feed(s) will be added to the integrations page. You will still need to configure and then enable the feed.
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 OSINT 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 parameters under the Configuration tab:
Parameter Description Parsed IOC Types Select the IOC types to automatically parse from the content. As of this publication, the only available option is CVE. Ingest CVEs As Set how to ingest CVEs as. Options include: Indicators and Vulnerabilities. This field is only displayed if you have selected CVE for the Parse IOC Type.
Verify SSL Enable or disable SSlL certificate verification. Disable Proxies Enable this option to have the feed ignore proxies set in the ThreatQ UI.
- 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
Proofpoint Threat Insights
The Proofpoint Threat Insights feed periodically pulls blog posts from the Proofpoint website, and ingests them into ThreatQ as Report Objects.
GET https://www.proofpoint.com/us/blog/threat-insight
The output of this request is HTML, which is parsed for links to the actual API containing information on the blog posts.
Once we get the links to the actual API, we need to fetch the blog post metadata from it.
POST https://{{ app_id }}-dsn.algolia.net/1/indexes/*/queries
Sample Body:
{"requests": [{"indexName": "blog","params": "filters=search_api_language%3Aen%20AND%20category%3A10346distinct=truefacetingAfterDistinct=truehitsPerPage=25"}]}
The response data will give us links to the actual blog posts so we can fetch their content using the following request
GET https://www.proofpoint.com/{{ uri }}
ThreatQuotient provides the following default mapping for this feed:
Feed Data Path | ThreatQ Entity | ThreatQ Object Type or Attribute Key | Published Date | Examples | Notes |
---|---|---|---|---|---|
.title |
Report.Title | N/A | N/A | TA444: The APT Startup Aimed at Acquisition (of Your Funds) |
From the API request |
.date |
Report.Published_At | N/A | N/A | N/A | From the API Request |
.url |
Report.Attribute | External Reference | N/A | https://www.proofpoint.com//us/blog/threat-insight/ta444-apt-startup-aimed-at-your-funds |
Parsed from HTML |
.date_formatted |
Report.Attribute | Published At | N/A | February 21, 2023 |
From the API Request |
.author |
Report.Attribute | Author | N/A | Greg Lesnewich and the Proofpoint Threat Research Team |
From the API Request |
N/A | Report.Description | N/A | N/A | <HTML content> |
Parsed from the HTML |
N/A | Related.Indicator | CVE | N/A | CVE-2023-41232 |
Parsed from HTML |
N/A | Related.Vulnerability | N/A | N/A | CVE-2023-41232 |
Parsed from HTML |
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.
Metric | Result |
---|---|
Run Time | 1 minute |
Reports | 14 |
Report Attributes | 42 |
Indicators | 2 |
Known Issues / Limitations
- In order to avoid reingesting the same IPs, the feed will request IPs based on the
since
date of the last run. At a minimum, the feed will fetch the last day's worth of data. - If you'd like to fetch more data, you can run the feed manually, setting the
since
date to the desired date. The feed will then fetch data from that date until the current date. - The max posts the feed will return is 25.
Change Log
- Version 1.0.0
- Initial release
PDF Guides
Document | ThreatQ Version |
---|---|
Proofpoint Threat Insights CDF Guide v1.0.0 | 5.6.0 or Greater |