# Mobile Verification Toolkit (MVT) # Copyright (c) 2021-2022 Claudio Guarnieri. # Use of this software is governed by the MVT License 1.1 that can be found at # https://license.mvt.re/1.1/ import io import os import plistlib import sqlite3 from mvt.common.utils import (convert_mactime_to_unix, convert_timestamp_to_iso, keys_bytes_to_string) from ..base import IOSExtraction SAFARI_BROWSER_STATE_BACKUP_RELPATH = "Library/Safari/BrowserState.db" SAFARI_BROWSER_STATE_ROOT_PATHS = [ "private/var/mobile/Library/Safari/BrowserState.db", "private/var/mobile/Containers/Data/Application/*/Library/Safari/BrowserState.db", ] class SafariBrowserState(IOSExtraction): """This module extracts all Safari browser state records.""" def __init__(self, file_path=None, base_folder=None, output_folder=None, fast_mode=False, log=None, results=[]): super().__init__(file_path=file_path, base_folder=base_folder, output_folder=output_folder, fast_mode=fast_mode, log=log, results=results) self._session_history_count = 0 def serialize(self, record): return { "timestamp": record["last_viewed_timestamp"], "module": self.__class__.__name__, "event": "tab", "data": f"{record['tab_title']} - {record['tab_url']}" } def check_indicators(self): if not self.indicators: return for result in self.results: if "tab_url" in result: ioc = self.indicators.check_domain(result["tab_url"]) if ioc: result["matched_indicator"] = ioc self.detected.append(result) continue if "session_data" not in result: continue for session_entry in result["session_data"]: if "entry_url" in session_entry: ioc = self.indicators.check_domain(session_entry["entry_url"]) if ioc: result["matched_indicator"] = ioc self.detected.append(result) def _process_browser_state_db(self, db_path): self._recover_sqlite_db_if_needed(db_path) conn = sqlite3.connect(db_path) cur = conn.cursor() try: cur.execute(""" SELECT tabs.title, tabs.url, tabs.user_visible_url, tabs.last_viewed_time, tab_sessions.session_data FROM tabs JOIN tab_sessions ON tabs.uuid = tab_sessions.tab_uuid ORDER BY tabs.last_viewed_time; """) except sqlite3.OperationalError: # Old version iOS <12 likely cur.execute(""" SELECT title, url, user_visible_url, last_viewed_time, session_data FROM tabs ORDER BY last_viewed_time; """) for row in cur: session_entries = [] if row[4]: # Skip a 4 byte header before the plist content. session_plist = row[4][4:] session_data = {} try: session_data = plistlib.load(io.BytesIO(session_plist)) session_data = keys_bytes_to_string(session_data) except plistlib.InvalidFileException: pass if "SessionHistoryEntries" in session_data.get("SessionHistory", {}): for session_entry in session_data["SessionHistory"].get("SessionHistoryEntries"): self._session_history_count += 1 session_entries.append({ "entry_title": session_entry.get("SessionHistoryEntryOriginalURL"), "entry_url": session_entry.get("SessionHistoryEntryURL"), "data_length": len(session_entry.get("SessionHistoryEntryData")) if "SessionHistoryEntryData" in session_entry else 0, }) self.results.append({ "tab_title": row[0], "tab_url": row[1], "tab_visible_url": row[2], "last_viewed_timestamp": convert_timestamp_to_iso(convert_mactime_to_unix(row[3])), "session_data": session_entries, "safari_browser_state_db": os.path.relpath(db_path, self.base_folder), }) def run(self): if self.is_backup: for backup_file in self._get_backup_files_from_manifest(relative_path=SAFARI_BROWSER_STATE_BACKUP_RELPATH): self.file_path = self._get_backup_file_from_id(backup_file["file_id"]) self.log.info("Found Safari browser state database at path: %s", self.file_path) self._process_browser_state_db(self.file_path) elif self.is_fs_dump: for safari_browserstate_path in self._get_fs_files_from_patterns(SAFARI_BROWSER_STATE_ROOT_PATHS): self.file_path = safari_browserstate_path self.log.info("Found Safari browser state database at path: %s", self.file_path) self._process_browser_state_db(self.file_path) self.log.info("Extracted a total of %d tab records and %d session history entries", len(self.results), self._session_history_count)