|
Expiry period \(days\)
|
Enter the expiry period for the feed in days. For example, 180 days.**Note:** Data that is ingested from the source will be expired 180 days after the ingestion.
|
|
Override Source Expiration
|
When enabled, the feed record received will have its expiration time overridden to match the profile’s configuration.
|
|
Use REST Message
|
Select **Use REST Message** check box if you need to use REST Message/REST Method functionality that is provided by ServiceNow AI Platform.If this check box is not selected, then the application uses the endpoint provided in **REST Endpoint URL** to fetch the data from the feed. For more information, see [Outbound REST web service](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/api-reference/web-services/c_OutboundRESTWebService.md) on ServiceNow AI Platform documentation.
**Important:** The REST message and REST method fields are mandatory when you select REST message.
|
|
REST Message
|
Select the REST Message record from the list of REST message records which are already configured in the instance. For more information, see [Outbound REST web service](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/api-reference/web-services/c_OutboundRESTWebService.md) on the ServiceNow AI Platform documentation.**Note:** Select this value when you need to view specific headers, and define the REST related records using the REST message option.
|
|
REST Method
|
Select REST Method from the list of available REST Methods configured for the selected REST Message. For more information, see [Outbound REST web service](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/api-reference/web-services/c_OutboundRESTWebService.md) on the ServiceNow AI Platform documentation.
|
|
REST endpoint URL
|
Enter the REST endpoint URL where the data is hosted by the threat intelligence feed.**Note:** For MISP feed types, the REST endpoint URLs that end with `/manifest.json` are supported.
|
|
Confidence
|
Set the confidence for all the applicable records that are ingested through this specific feed.**Note:** Set the confidence between 0-100 for this source.
|
|
Override Source Confidence
|
When enabled, the feed will have its confidence value overridden to match the profile’s configuration.
|
|
Data Parsing Mechanism
|
Select the appropriate data parsing mechanism option. The available options are:- **Automated IoC Extraction**: This option is selected by default when configuring Text, CSV, or JSON feeds.
- **Custom Field Mapping**: Select this option if you want to define how the specific fields in your feed data should be mapped to the observable attributes.
Once selected, you can configure the mappings in the **Field Mapping** section. For more detailed information on the custom field mapping, see [Configure Custom Field Mapping](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/threat-intelligence-security-center/tisc-field-mapping.md).
**Note:** The data parsing mechanism option is only available for Text, CSV, and JSON feeds, where the feeds **Report Processor** is set to `SimpleFeedDatasourceResponseProcessor`.
|
|
Authentication Required
|
Select this check box if authentication is required for your new threat intelligence feed.**Note:** This is only applicable when REST Endpoint URL is being used to retrieve the data.
|
|
Authentication Type
|
The authentication type for the source feed. Following are the authentication types that are configured and provisioned within the base system for the users:- API ID / API Key
- API ID / API Secret
- API Key
- API Key / API Secret
- API Username / API Password / API Key
- Basic Authentication
|
|
Headers to be passed with request
|
Any headers to be passed with the requests can be provided in Request Header Mapping.- Header should be provided in key-value pair separated by colon\(':'\).
- Each header key value pair should be provided in a new line.
- For providing authentication parameters as header values, enclose the required Authentication Label with '$\{' and '\}$'. For example, x-api-key:$\{API Key\}$.
|
|
Advanced
|
Select this check box to define custom integration script and report processor script.**Note:** When you select this check box, the **Integration script** and **Report Processor** fields will appear for you to select the custom scripts.
|
|
Integration script
|
Integration script invokes a call to the REST Endpoint URL using the authentication parameters and the headers as configured in the feed, and then the script fetches the data that is available from the specific feed.Within the base system following are the custom scripts includes available, which are provisioned within the application for the integrations scripts:
- MITRESourceIntegration: Used for fetching the data from MITRE feeds.
- RSSFeedDatasourceIntegration: Used for fetching the data from RSS feeds.
- SimpleFeedDatasourceIntegration: Used for fetching the data from Simple feeds without authentication or Basic Authentication.
- SimpleMISPFeedDatasourceIntegration: Used for fetching the data from hosted MISP feeds.
The default integration script is based on the feed type that you select. For example, if you select MISP feed type which is a standard format to process and fetch the data then the integrations script is **SimpleMISPFeedDatasourceIntegration**.
**Note:**
For the Custom integration scripts, you can create a script include by extending **FeedDatasourceIntegrationBase** and override the required methods.
|
|
Report processor
|
The report processor script processes data fetched from the feed using the integration script.
The base system includes the following custom scripts, which are provisioned within the application to support report processor script:
- AtomFeedDatasourceResponseProcessor: Used for processing RSS feeds in Atom format.
- MITRECollectionDataProcessor: Used for processing MITRE feeds.
- RSSFeedDatasourceResponseProcessor: Used for processing RSS feeds.
- SimpleDataplaneFeedResponseProcessor: Used for processing Dataplane feeds.
- SimpleFeedDatasourceResponseProcessor: Used for processing Simple feeds using regular expression extraction of observables.
- SimpleFeodotrackerFeedResponseProcessor: Used for processing Feodotracker feeds.
- SimpleMISPFeedDatasourceResponseProcessor: Used for processing hosted MISP feeds.
- TAXIIV2CollectionDataProcessor: Used for processing TAXII Collection data.
The default report processor for MISP feeds is `SimpleMISPFeedDatasourceResponseProcessor`. This processor is preconfigured by the application and cannot be modified or replaced.
|