Webroot Threat Review
Overview
Webroot records three kinds of protection events, each with its own tool:
| Event | Tool | Scope |
|---|---|---|
| File detections (threat history) | webroot_threats_list_site, webroot_threats_list_endpoint |
Site or one endpoint |
| Web Threat Shield URL actions | webroot_blockedurls_list |
Site |
| DNS Protection (DNSP) | webroot_dnsp_traffic_summary (all sites), webroot_dnsp_blocked_list (one site) |
Console or site |
All of these are in Conduit's Read group. The command history used in step 5 below is admin-gated.
All three default to the last 24 hours. Always pass startDate and endDate for
anything longer, and state the window in the answer.
Anti-triggers
- Overall health counts (how many infected, stale agents): use endpoint-health.
- Who issued a command or who has console access: use console-audit.
Workflow: an infection alert on one machine
- Find the endpoint:
webroot_endpoints_listwithhostName, thenwebroot_endpoints_getfor last seen, last infected, OS, IPs, current user and isolation status. webroot_threats_list_endpointover the last 7 to 30 days withreturnedInfo=ExtendedInfo. Page whileMoreAvailableis true.- Group the records by file path and malware group. The same file reappearing after it was first seen means it is being re-dropped (a persistence mechanism, a synced folder, or a re-run installer), not that Webroot missed it once.
- Check web and DNS activity on the same site for the same window:
webroot_blockedurls_listandwebroot_dnsp_blocked_list, filtered in your answer to this host or user. A detection that follows a blocked domain or URL often points at the delivery route. - Was it already handled?
webroot_commands_list_endpointwithcommand=scanorcleanupshows whether a technician already issued one and its state (3 executed, 6 failed, 2 not yet received). This tool is admin-gated in Conduit; if the user does not have Admin access to Webroot, say that and skip the step. - Recommend next steps for the GSM console (scan, cleanup, isolate). The plugin cannot issue them.
Workflow: monthly threat summary for a site
webroot_threats_list_sitefor the month (startDate= first day 00:00Z,endDate= last day 23:59:59Z). Page untilMoreAvailableis false.- Count detections, distinct endpoints, and distinct malware groups. List the top endpoints by detection count; one machine with most of the detections is the story.
webroot_dnsp_traffic_summaryfor the same window gives total, blocked and risky DNS requests per site; pick this site's row. Usewebroot_dnsp_blocked_listonly when the user wants the domains.webroot_blockedurls_listfor URL actions blocked or allowed by Web Threat Shield.- Report detections and blocks as evidence the protection is working, and repeat detections on one endpoint as the thing to act on.
Paging and volume
- Threat, URL and DNS lists page with
pageNr+MoreAvailable. webroot_dnsp_blocked_listcan be large:pageSize100 to 10000 (default 1000). For a summary, preferwebroot_dnsp_traffic_summaryand only pull blocked domains on request.- If a response is too large, shorten the date range rather than raising
pageSize.
Gotchas
- DNSP results carry category and block-reason IDs, not names. Report them as IDs unless the user supplies the mapping.
webroot_blockedurls_listleaves out deactivated and hidden endpoints unless you setincludeDeactivatedorincludeHidden. A machine that was deactivated after an incident needsincludeDeactivated= true.- Threat history shows detections, not outcomes. Whether the file was removed is in the endpoint's infection state and the command history, not in the threat record.