====== Spotlight Metadata ======

===== Definition =====
Spotlight Metadata is a Linux or macOS artifact, behavior, or record used to interpret access, execution, configuration, file-system activity, or user context.
In a forensic report, spotlight metadata should be treated as a source of evidence and uncertainty, not as a shortcut to intent. The useful question is what the record supports, what it does not support, and what another source says when asked the same question.

===== Background =====
Unix-like systems reward careful examiners and punish lazy assumptions. Logs move, shells remember selectively, and metadata often keeps the kind of quiet that makes bad reports nervous.
For practitioners, the value is not drama; it is knowing which facts can survive review and which ones need to stay in the notes. Unix artifacts tend to punish anyone who assumes every system kept the same diary.

===== Technical Description =====
Review usually compares logs, account records, shell history, metadata, scheduled jobs, application state, and platform-specific storage behavior.
The analyst should identify which fields are observed directly, which are parsed, and which are inferred from nearby records.

===== Forensic Relevance =====
  * **User activity review:** It may support account or profile context, but only when independent artifacts point the same direction.
  * **Contradiction testing:** It is useful for finding places where logs, metadata, storage behavior, or accounts disagree.
  * **Reporting decisions:** It helps decide how narrow the finding should be when spotlight metadata looks interesting but not conclusive.
  * **Timeline reconstruction:** Spotlight Metadata can help place activity in sequence when the time source and collection conditions are understood.
  * **Recovery analysis:** It can explain why data was recovered, missed, corrupted, or only partially reconstructed.

===== Evidence Sources =====
^ Evidence source ^ What it may show ^ Reliability limits ^ What it cannot prove alone ^
| System logs | May show authentication, service behavior, boot activity, package changes, and errors. | Retention and configuration vary by distribution or deployment. | Do not prove a complete sequence. |
| Shell and account artifacts | May show command history, login context, keys, and user environment. | History can be disabled, edited, truncated, or shared. | Do not prove who typed a command. |
| File metadata | May show ownership, permissions, timestamps, and extended attributes. | Copying, sync, backup, and package managers can change metadata. | Does not prove motive. |
| Platform-specific stores | macOS and Linux keep different records for indexing, quarantine, auditing, and scheduling. | Version differences matter. | Do not support Windows-style assumptions. |

===== Interpretation Limits =====
The most common error is treating spotlight metadata as proof of motive. It may support a technical event, a sequence, or a contradiction, but motive needs stronger ground.
Another bad leap is treating absence as intent. Missing data can come from retention, configuration, collection scope, sync behavior, overwriting, media behavior, or ordinary use.
A tool result should be described as a parsed or recovered record, not as the tool's opinion about what happened. Tools surface evidence; they do not understand it.
Shell history is helpful until it remembers that it is editable.

===== Common Misinterpretations =====
  * Ignoring benign explanations because the suspicious explanation is easier to write.
  * Treating spotlight metadata as proof that a specific user acted, when the artifact only supports system or account context.
  * Treating a timestamp as exact truth without checking timezone, clock drift, and source semantics.

===== Example Scenario =====
During follow-up analysis, system logs becomes the strongest visible record tied to spotlight metadata.
The record may be meaningful, but it has to be compared with shell and account artifacts before the report gets confident.
The analyst preserves the source, exports the relevant records, checks shell and account artifacts, and documents what remains unresolved.

===== Analysis Workflow =====
  - Define the question before opening another parser: what should Spotlight Metadata help answer?
  - Preserve the source evidence and document how the system logs were collected.
  - Record tool versions, input paths, output paths, time settings, and errors.
  - Identify observed facts before writing any interpretation.
  - Normalize time sources and document timezone, clock drift, and collection-time effects.
  - Compare at least two independent artifact families before raising confidence.
  - Consider benign explanations, automated behavior, retention, sync, and storage-device behavior.
  - Write conclusions proportionally: observed fact first, inference second, uncertainty always visible.

===== Reporting Guidance =====
Reporting on spotlight metadata should be precise enough that another analyst can retrace the claim without inheriting the original examiner's confidence.
Avoid wording that converts possibility into intent. The report should not say a user deliberately deleted, hid, wiped, or tampered with evidence unless the evidence actually supports that conclusion.
Report-ready wording:
  * The available system logs are consistent with activity related to spotlight metadata, but they do not independently establish motive or user intent.
  * Recovery was limited under the examined conditions; additional corroboration would be required before concluding deliberate destruction.
  * The finding should be read with the collection scope, time-source limits, and alternate explanations described in this report.

===== Confidence and Reliability =====
^ Confidence level ^ What it looks like for this topic ^ How to report it ^
| Low | System logs exist, but collection scope, time source, or surrounding context is limited. | State the observation and keep interpretation narrow. |
| Moderate | System logs align with Shell and account artifacts, but attribution or intent remains unresolved. | Say the artifacts support the finding, not that they prove it. |
| High | Multiple independent sources agree on sequence, source system, account context, and collection conditions. | Use stronger language, but still separate observed facts from inference. |

===== Related Concepts =====
  * [[wiki:digital_forensics:linux_macos:apfs_snapshots|APFS Snapshots]] - Compare this concept when testing sequence and corroboration.
  * [[wiki:digital_forensics:linux_macos:bash_history|Bash History]] - Compare this concept when testing sequence and corroboration.
  * [[wiki:digital_forensics:linux_macos:cron_jobs|Cron Jobs]] - Compare this concept when testing sequence and corroboration.
  * [[wiki:digital_forensics:linux_macos:extended_attributes|Extended Attributes]] - Often appears nearby in reviews of the same system or behavior.
  * [[wiki:digital_forensics:linux_macos:file_permissions|File Permissions]] - Helps keep the finding grounded in a wider evidence pattern.
  * [[wiki:digital_forensics:linux_macos:fsevents|FSEvents]] - Useful when checking whether another artifact supports the same interpretation.

===== Tools =====
  * [[https://www.osquery.io/|osquery]] - Structured endpoint state collection across operating systems.
  * [[https://www.sans.org/tools/sift-workstation/|SIFT Workstation]] - DFIR workstation distribution and toolset.
  * [[https://github.com/ydkhatri/mac_apt|mac_apt]] - macOS artifact parsing and reporting.
  * [[https://github.com/mac4n6/APOLLO|APOLLO]] - SQLite query framework for Apple artifacts.
  * [[https://docs.velociraptor.app/|Velociraptor]] - Endpoint collection, hunting, and artifact triage.
  * [[https://github.com/log2timeline/plaso|Plaso]] - Timeline extraction and normalization across many artifact types.
  * [[https://github.com/libyal/libyal|libyal]] - Forensic libraries for many evidence formats.
  * [[https://sourceforge.net/projects/dc3dd/|dc3dd]] - Disk imaging and hashing utility.
  * [[https://www.gnu.org/software/ddrescue/|GNU ddrescue]] - Imaging damaged media while preserving recovery logs.
  * [[https://arsenalrecon.com/products/arsenal-image-mounter|Arsenal Image Mounter]] - Mount forensic images for controlled review.
  * [[wiki:tools:start|Forensic Tools]] - Full tool directory for the wiki.

===== Limitations of Tools =====
Tools parse, surface, and organize evidence. They do not create conclusions.
Parser output can be affected by version differences, unsupported formats, corrupted records, timezone handling, partial collection, and storage behavior outside the tool's view.
When a tool produces a strong-looking result, validate it against another tool or source where the stakes justify it. A parser can recover a fragment; it cannot tell you whether the fragment deserves a paragraph in the report.

===== References and Further Reading =====
  * [[https://www.man7.org/linux/man-pages/man8/systemd-journald.service.8.html|systemd-journald manual]] - Linux journal behavior.
  * [[https://support.apple.com/guide/security/welcome/web|Apple Platform Security]] - Apple platform and security reference.
  * [[https://support.apple.com/guide/deployment/welcome/web|Apple macOS deployment reference]] - macOS administration and deployment context.
  * [[https://csrc.nist.gov/publications/detail/sp/800-86/final|NIST SP 800-86]] - Guide to integrating forensic techniques into incident response.
  * [[https://www.nist.gov/itl/ssd/software-quality-group/computer-forensics-tool-testing-program-cftt|NIST CFTT]] - Computer Forensics Tool Testing program.

===== See Also =====
  * [[wiki:digital_forensics:linux_macos:start|Linux Macos]]
  * [[wiki:digital_forensics:linux_macos:apfs_snapshots|APFS Snapshots]]
  * [[wiki:digital_forensics:linux_macos:bash_history|Bash History]]
  * [[wiki:digital_forensics:linux_macos:cron_jobs|Cron Jobs]]
  * [[wiki:digital_forensics:linux_macos:extended_attributes|Extended Attributes]]
  * [[wiki:digital_forensics:linux_macos:file_permissions|File Permissions]]
  * [[wiki:digital_forensics:linux_macos:fsevents|FSEvents]]
  * [[wiki:digital_forensics:linux_macos:gatekeeper|Gatekeeper]]
  * [[wiki:digital_forensics:linux_macos:homebrew_logs|Homebrew Logs]]
  * [[wiki:digital_forensics:linux_macos:keychain_artifacts|Keychain Artifacts]]
  * [[wiki:digital_forensics:linux_macos:launchagents|LaunchAgents]]
  * [[wiki:tools:start|Forensic Tools]]
  * [[wiki:resources:start|Project Resources]]

===== Reader Takeaway =====
Spotlight Metadata is useful when it helps explain what the evidence can support and where the limits begin. Treat spotlight metadata as one part of a corroborated record, not a shortcut to intent. A plist can look tidy while hiding the kind of version detail that ruins an easy paragraph.

===== Use Notes =====
This article is for defensive education and technical reference. It should not be treated as legal, forensic, investigative, compliance, or operational advice without qualified professional judgment.