Skip to content

Intel & Detection

Sean McFeely edited this page Apr 6, 2021 · 6 revisions

Intel & Detection

For PSC, you can interface with several intel based APIs:

$ cbinterface intel -h
usage: cbinterface intel [-h] [--json] {watchlists,feeds,alerts,migrate} ...

positional arguments:
  {watchlists,feeds,alerts,migrate}
    watchlists          Interface with PSC Watchlists.
    feeds               Interface with PSC Feeds.
    alerts              Interface with PSC Alerts.
    migrate             Utilities for migrating response watchlists to PSC EDR
                        intel.

optional arguments:
  -h, --help            show this help message and exit
  --json                Return results as JSON.

Watchlists

You can list all watchlists, get a specific watchlist, get a specific watchlist report, delete a watchlist report, and update a watchlist report QueryIOC. Watchlist and Report data can be exported via JSON.

usage: cbinterface intel watchlists [-h] [-lw] [-w GET_WATCHLIST]
                                    [-wr GET_WATCHLIST_REPORT]
                                    [-dr DELETE_WATCHLIST_REPORT]
                                    [--update-ioc-query UPDATE_IOC_QUERY]

optional arguments:
  -h, --help            show this help message and exit
  -lw, --list-watchlists
                        List all watchlists.
  -w GET_WATCHLIST, --get-watchlist GET_WATCHLIST
                        Get watchlist by ID.
  -wr GET_WATCHLIST_REPORT, --get-watchlist-report GET_WATCHLIST_REPORT
                        Get a watchlist report by report ID.
  -wn WATCHLIST_NAME_SEARCH, --watchlist-name-search WATCHLIST_NAME_SEARCH
                        Search for watchlists by name.
  -dr DELETE_WATCHLIST_REPORT, --delete-watchlist-report DELETE_WATCHLIST_REPORT
                        Delete watchlist report by ID.
  --update-ioc-query UPDATE_IOC_QUERY
                        Update a query IOC for the given report ID/IOC id.
                        format: report_id/ioc_id
Example: Update an Watchlist Report IOC Query

Here is an example of updating an IOC Queries in a Watchlist Reports with report ID '0KspU7cfSQ4S4WgsNl7Wg'.

If I do not know the IOC ID of the QueryIOC in the report, I can list the report:

cbinterface intel watchlists -wr 0KspU7cfSQ4S4WgsNl7Wg

------------------------- INTEL REPORT -------------------------
	id: 0KspU7cfSQ4S4WgsNl7Wg
	timestamp: 1617406997
	title: ACE_explorer_cmd_schtasks
	description: Legacy Cb Response Watchlist Description: utilized in CVE-2017-0199
	severity: 5
	link: None
	tags: ['response_migrated_watchlist']
	iocs: None
	iocs_total_count: 1
	visibility: None
	ignored: False
	iocs_v2: 
		id: 1
		match_type: query
		field: None
		link: None
		ignored: False
		ioc_value: (parent_name:explorer.exe process_name:cmd.exe childproc_name:schtasks.exe -process_username:blahUser) -enriched:true

So there is just one IOC in this report. We can edit the query like so:

$ cbinterface intel watchlists --update-ioc-query 0KspU7cfSQ4S4WgsNl7Wg/1
Enter new query: (parent_name:explorer.exe process_name:cmd.exe childproc_name:schtasks.exe -process_username:a277547 -childproc_name:admin-tool1.exe) -enriched:true 
2021-04-05 20:35:19 analysis cbinterface.psc.cli[6386] INFO Query IOC ID=1 of report ID=7cfS4WgsQ0KspU4SNl7Wg successfully updated.

The Carbon Black Cloud server will return an error if the new query does not validate and the Report IOC will not be updated.

Clone this wiki locally