How seemoo-lab/openhaystack works
Main Components
a. Core Components:
• macOS Application (OpenHaystack)
• Mail Plugin (OpenHaystackMail)
• Mobile Application (Flutter-based)
• Firmware Components (ESP32, Microbit, Linux HCI)
• Apple's Find My Network (external system)
b. Data Components:
• Local Storage (Keychain for keys)
• Apple's Location Reports Database
• Device Configuration Storage
• macOS App | | Mobile App |
• (SwiftUI/AppKit)| | (Flutter) |
• Mail Plugin | | Reports Fetcher |
• (Authentication) | | (Location Data) |
• ESP32 | | Microbit | | Linux |
• Firmware | | Firmware | | HCI |
• Find My Network | | Apple Location |
• (iPhone Network) | | Reports Server |
Data Flow Indicators
• Bluetooth advertisements from accessories to Find My Network
• Encrypted location reports from iPhones to Apple's servers
• Authentication flow from Mail Plugin to Apple's servers
• Location data retrieval from servers to applications
• Key deployment from applications to accessories
• Key Management |
• Public Keys |
• Private Keys |
• Keychain Store |
• Location Process |
• Encryption |
• Decryption |
• Report Parsing |
Integration Points
Interfaces between:
• Mail plugin and Apple's authentication
• Applications and firmware deployment
• Accessories and Find My network
• Applications and location report retrieval
Security Boundaries
• Local device security (keychain)
• Network security (encrypted reports)
• Device security (firmware)