Skip to content

Conversation

@tomsonpl
Copy link
Contributor

@tomsonpl tomsonpl commented Nov 7, 2025

Browser History Artifact

This PR adds a new osquery saved query for the Browser History artifact, providing comprehensive browser activity collection across all platforms using the Elastic osquery extension. The query automatically discovers and collects browsing history from Chrome, Edge, Firefox, and Safari without requiring ATC configuration.

Core Forensic Artifacts Coverage

# Artifact OS Query File Description
1 Browser History Windows, macOS, Linux browser_history_elastic b352f3c9 Collects browser history from all supported browsers across all platforms using the Elastic osquery extension

Queries by Platform


🪟🍎🐧 Cross-Platform - Browser History Collection

Description

This query leverages the Elastic osquery extension to collect browser history from all major browsers (Chrome, Edge, Firefox, Safari) across Windows, macOS, and Linux platforms. The extension automatically discovers browser profile locations and queries their history databases without requiring ATC (Automatic Table Construction) configuration.

The query returns the last 7 days of browsing activity, including:

  • Full URLs with domain extraction
  • Page titles and visit timestamps
  • Browser identification
  • User profiles
  • Navigation transition types

Detection Focus:

  • Data Exfiltration Detection: Identify suspicious file upload or cloud storage URLs
  • Credential Phishing: Detect visits to fake login pages or credential harvesting sites
  • Command & Control: Identify visits to known C2 infrastructure or suspicious domains
  • Insider Threat Monitoring: Track access to unauthorized resources or data repositories
  • Policy Compliance: Verify adherence to acceptable use policies

Result

Screenshot 2025-11-07 at 13 20 30

Returns browsing history entries with timestamps, URLs, page titles, browser names, user profiles, and navigation context for the past 7 days.

Platform

windows, darwin, linux (cross-platform)

Interval

3600 seconds (1 hour)

Query ID

browser_history_elastic

ECS Field Mappings

  • url.fullurl
  • event.actiontitle
  • user_agent.namebrowser
  • user.nameuser
  • url.domaindomain
  • event.categoryweb (static)
  • event.typeinfo (static)

SQL Query

-- Browser history from Elastic osquery extension
-- Supports: Chrome, Edge, Firefox, Safari
-- Returns last 7 days of browsing activity
SELECT
  datetime,
  url,
  title,
  browser,
  user,
  domain,
  transition_type
FROM browser_history
WHERE timestamp > (strftime('%s', 'now') - 604800)
ORDER BY timestamp DESC;

Requirements

⚠️ IMPORTANT: This query requires the Elastic osquery extension (osquerybeat). The standard osquery does not include the browser_history table.


@tomsonpl tomsonpl self-assigned this Nov 7, 2025
@tomsonpl tomsonpl marked this pull request as ready for review November 7, 2025 16:29
@tomsonpl tomsonpl requested a review from a team as a code owner November 7, 2025 16:29
@tomsonpl tomsonpl requested review from gergoabraham and pzl and removed request for a team November 7, 2025 16:29
@elasticmachine
Copy link

💚 Build Succeeded

cc @tomsonpl

@andrewkroh andrewkroh added documentation Improvements or additions to documentation. Applied to PRs that modify *.md files. Integration:osquery_manager Osquery Manager labels Nov 7, 2025
"attributes": {
"created_at": "2025-11-07T00:00:00.000Z",
"created_by": "elastic",
"description": "Collects browser history from all supported browsers across all platforms using the Elastic osquery extension. IMPORTANT: Requires the Elastic osquery extension (osquerybeat). Automatically discovers and queries Chrome, Edge, Firefox, and Safari browser histories without ATC configuration. Returns URL history with visit timestamps, page titles, browser names, user profiles, and navigation context. Works on Windows, macOS, and Linux.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does a user need to know about the extension or would it make more sense to just say it requires Agent 9.3.0+?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation. Applied to PRs that modify *.md files. Integration:osquery_manager Osquery Manager

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants