File Provider & iCloud Drive Metadata
macOSFilesystem & TimelineDisk Image
Location
~/Library/Application Support/FileProvider/, ~/Library/Application Support/CloudDocs/, and ~/Library/CloudStorage/Common Names
CloudDocsFile ProvideriCloud Drive
Description
Metadata caches and synchronization state for File Provider-backed storage on macOS, including iCloud Drive and other providers that surface content through CloudStorage and File Provider frameworks.
Forensic Value
These stores help determine which cloud-backed documents, folders, and providers were visible to the user even when the actual file contents were not fully hydrated on disk at collection time. They are valuable in exfiltration, insider threat, and cloud storage investigations because they can show file names, sync state, provider identifiers, and timestamps for recently accessed or staged content. They also help distinguish local files from placeholders that were only materialized on demand.
Tools Required
findsqlite3plutilmac_apt
Collection Commands
find
find ~/Library/Application\ Support/FileProvider ~/Library/Application\ Support/CloudDocs ~/Library/CloudStorage -maxdepth 4 -print > /forensics/file_provider_inventory.txt 2>/dev/null
cp
cp -R ~/Library/Application\ Support/FileProvider /forensics/file_provider/ 2>/dev/null && cp -R ~/Library/Application\ Support/CloudDocs /forensics/clouddocs/ 2>/dev/null
plutil
find ~/Library/Application\ Support/FileProvider -name "*.plist" -exec plutil -p {} \; > /forensics/file_provider_plists.txt 2>/dev/nullCollection Constraints
- •Paths, schemas, and permission boundaries vary by macOS release, Full Disk Access state, and whether data came from a live collection, mounted image, or backup source.
- •Hydration state, provider layout, and cache coverage vary by provider and macOS release. Placeholder files may exist without full content, and some metadata is only meaningful alongside provider-specific logs.
MITRE ATT&CK Techniques
T1567.002T1005T1083