Configure Context Hub Data Source Settings
After you have configured the required data sources you can customize the settings for the data sources based on your requirement.
To access and configure settings:
-
Go to (Admin) > Services.
The services view is displayed.
-
In the Services panel, select the Context Hub service and click > View > Config.
The Services Config view of Context Hub is displayed.
-
Select the data source for which you want to configure the settings and click in the Actions column.
The following screenshot is an example of the NetWitness Endpoint settings dialog:
The following screenshot is an example of the REST API settings dialog: -
Configure the following fields:
Field Description Enable This option is enabled by default (checked) and can be used to enable or disable the response from the selected data source. Cache Settings Any lookup from Context Hub can be stored in the Context Hub cache for a configured time. Response to any subsequent matching request will be fetched from the Context Hub cache.
Use this section to define the following cache settings for query lookup:- Cache Enabled: By default, this checkbox is selected and the query response is cached.
- Cache Expiration (Minutes): The maximum time the query lookup is retained in cache. The default time is 30 minutes and maximum is 7200 minutes that you can configure.
List value Expiration
Enable: Select Enable to define the number of days the list values must be available. By default, this option is disabled and the values are retained.
Time to Live (Days): Enter the number of days you want to the list values to be retained.
Meta Mapping
Any list stored in Context Hub should be made available for a lookup. The lookup in Context Hub is performed based on meta type or entities. Examples IP, HOST, MAC ADDRESS, DOMAIN, FILE_NAME, FILE_HASH, USER.
Meta Type: Entities available in Context Hub.
Context Hub Fields: Column headers from CSV file you have added when creating a list.
Meta and Field Mapping
Response Preview: You can view the live response for the REST API configured, using the test meta value as a placeholder.
Copy: Copies the response preview.
Meta Mapping: Any REST API stored in Context Hub should be made available for a lookup. The lookup in Context Hub is performed based on meta type or entities selected. Examples IP, HOST, MAC ADDRESS, DOMAIN, FILE_NAME, FILE_HASH, USER.
Meta Type: Entities available in Context Hub.
Field Mapping: Add friendly display name for the response field which is displayed during the context lookup.
- Add a field mapping.
- Delete a field mapping.
Field- Enter the path for which you want to add a friendly name.
Value (from Preview)- The value is filled automatically based on the path.
Display Name- Enter friendly name.
Minimum IIOC Score The minimum IIOC score to be considered for fetching contextual information of NetWitness Endpoint modules. Query Last (Days)
The duration (in days) for which the Context Data must be queried.
Limit The maximum number of records to be displayed when Context Lookup is performed. Recur Every
Configure recurring schedule to fetch and store contextual data for the required intervals.
-
Click any one of the following options:
- Cancel - select this option to cancel the changes.
- Save - select this option to save the changes.
-
Save and Close - select this option to save and close the dialog.
To access and configure settings for STIX data sources
- Go to (Admin) > Services and select Context Hub service.
- Click > View > Config > STIX tab.
-
Select the data source for which you want to configure the settings and click in the Configurations column.
- For REST Server, the following fields are displayed.
Configure the following fields for REST Server.Field Description Recur Every Specify the time frequency in minutes, hours, days or weeks to retrieve the content from the data source. - For TAXII Server, the following fields are displayed.
Configure the following fields for TAXII Server.Field Description Retention Period Specify the number of days the content retrieved from the taxi data source must be retained before it is automatically deleted. Recur Every Specify the time frequency in minutes, hours, days or weeks to retrieve the content from the data source .
Based on the data source you select, the Response Groups differ. The following table describes the response groups for every data source.
Data Source (Connection) | Response Supported Groups | Field Settings | ||||||
---|---|---|---|---|---|---|---|---|
List | List |
Meta Mapping Settings Cache Settings |
||||||
Archer | Archer |
Cache Settings Settings Export Attributes Configuration Export Attributes Schedule Recurrence |
||||||
Active Directory | Users |
Meta Mapping Meta Type Context Hub Fields Settings Data Prefetch Settings Schedule Recurrence List Value Expiration Cache Settings Cache Enabled Cache Expiration (Minutes)[Min is 30 minutes Max is 7200 minutes] |
||||||
NetWitness Endpoint |
|
|
||||||
Respond |
|
Context Panel Settings Cache Settings |
||||||
File Reputation Server | File Reputation Server | Cache Settings Cache Enabled Cache Expiration (Minutes) |
||||||
TI |
Displays information for STIX data sources. |
IP address, email address, domain, filename, URL's, and file hash. Note: The context lookup for email address and URL will be displayed only if these metas are mapped. To map the metas, navigate to (Configure) > System > Investigation > Context Lookup. |
||||||
REST API |
REST API |
|
Note: After you configure the data source settings, you can configure the Context Hub configuration parameters by navigating to (Admin) > Services> View > Explore view. Make sure you restart the Context Hub service if you make any configuration changes in the Explore view.