This procedure describes how to configure incoming feeds for a particular feed data source, transport type, or content type.
For more information about configuring common options shared across all incoming feeds, see Configure incoming feeds general options.
Proofpoint Email Brand Defense threat API
Domain names, IP addresses, IDS rules (firewall, blocklists), Snort (Suricata-compatible).
Indicators and observables focusing on email threats such as phishing, spoofing, email malware, and impostor email/fraudulent messages.
Retrieve and process information on email threats such as phishing, spoofing, and email malware.
Users need an API key for their own configuration. Sign up and subscribe to the service to obtain the required API key credentials.
Configure the incoming feed
Create or edit an incoming feed.
From the Transport type drop-down menu, select Proofpoint Email Brand Defense threat API.
From the Content type drop-down menu, select Proofpoint Message.
In the API key field, enter your Proofpoint API key.
The API URL field is automatically filled in with the default domain for the endpoint.
You can add a proxy or set up ports according to your needs.
Default value: https://api.emaildefense.proofpoint.com/v1.
In the Likely impact threshold (low) field, e nter an integer value to assess the maliciousness confidence level of processed email threats.
This value sets the minimum maliciousness confidence value to flag a potential email threat as somewhat likely to be malicious.
The lower threshold value needs to be smaller than the highest threshold value.
Enter a value between 0 and 100.
Default value: 60.
In the Likely impact threshold (high) field, e nter an integer value to assess the maliciousness confidence level of processed email threats.
This value sets the minimum maliciousness confidence value to flag a potential email threat as very likely to be malicious.
The higher threshold value needs to be bigger than the lower threshold value.
Enter a value between 0 and 100.
Default value: 90.
Click the Start ingesting from field, and use the drop-down calendar to select an initial date and, where available, an initial time to fetch content from the intelligence provider/data source starting from a specific date in the past.
By default, the max. amount of days in the past per each query/request is set to 60 days.
In the Domain field, enter a domain name to retrieve information on fraudulent email messages sent on behalf of the specified domain.
Returned data includes, when available, the brand a spoofing message uses to trick users, the message subject line, source IP address, source host name, and source email address, as well as any MD5 file hashes, if the malicious email contains attachments.
If you do not specify any domain name, the feed defaults to retrieving a list with the most relevant threats, based on your Proofpoint Email Fraud Defense subscription and account preferences.
The list contains the most relevant fraudulent messages reported in the previous 07 days.
To store your changes, click Save; to discard them, click Cancel.
About impact thresholds
Ingested observables with a lower value than the one you set in Likely impact lower threshold are automatically flagged as Malicious - Low confidence.
Ingested observables whose likely impact value is bigger than the lower threshold and smaller than the higher threshold values are automatically flagged as Malicious - Medium confidence.
Ingested observables with a higher value than the one you set in Likely impact higher threshold are automatically flagged as Malicious - High confidence.
You can use impact threshold values to automatically filter enricher output data, and to instrument external systems and devices, such as a SIEM, to execute follow-up actions.
For example, add all high confidence maliciousness email addresses to a blocklist, or route all ingested Snort rules with a high maliciousness confidence to a Snort instance to trigger rule-driven actions.