SwiftBelt: macOS enumeration tool
SwiftBelt
SwiftBelt is a macOS enumerator inspired by @harmjoy’s Windows-based Seatbelt enumeration tool. It does not utilize any command-line utilities and instead uses Swift code (leveraging the Cocoa Framework, Foundation libraries, OSAKit libraries, etc.) to perform system enumeration. This can be leveraged on the offensive side (i.e., perform enumeration once you gain access to a macOS host) or on the defensive side (i.e., pulling back host info on a compromised machine). I intentionally did not include any functions that cause pop-ups (ex: keychain enumeration).
Download
git clone https://github.com/cedowens/SwiftBelt.git
Use
Steps
You can run the included SwiftBelt mach-o binary in the root directory of this repo or you can edit the Swift code and rebuild a new binary.
To use the included mach-o:
- Note: I did not sign the included mach-o. Therefore you will need to take these steps to remove the quarantine attribute in order to run: Once downloaded, copy to the desired host and clear the quarantine attribute ($ xattr -c SwiftBelt) and set as executable ($ chmod +x SwiftBelt)
- To see the help menu: ./SwiftBelt -h
Help menu:
-SecurityTools –> Check for the presence of common macOS security tools (at least the ones I am familiar with)
-SystemInfo –> Pullback system info (wifi SSID info, open directory node info, internal IPs, ssh/aws/gcloud/azure-cli cred info, basic system info). If present on the host, this tool will display the contents of ssh keys, known hosts file, aws cred files, and gcloud token info
-Clipboard –> Dump clipboard contents
-RunningApps –> List all running apps
-ListUsers –> List local user accounts
-LaunchAgents –> List launch agents, launch daemons, and configuration profile files
-BrowserHistory –> Attempt to pull Safari, Firefox, Chrome, and Quarantine history (note as FYI: if Chrome or Firefox is actively running, the tool will not be able to read the locked database to extract info)
-SlackExtract –> Check if Slack is present and if so read the cookie, downloads, and workspaces info (leverages research done by Cody Thomas)
-BashHistory –> Read bash history content
Usage:
To run all options: ./SwiftBelt
To specify certain options: ./SwiftBelt [option1] [option2] [option3]…
Example: ./SwiftBelt -SystemInfo -Clipboard -SecurityTools …
To edit the Swift code and rebuild your own mach-o:
- Open the xcodeproj file for SwiftBelt in Xcode
- Edit the code in main.swift code as needed in Xcode
- From a terminal cd into the SwiftBelt directory and run: “swift build” to generate the binary. The binary will be dropped in the .build/debug folder inside of the SwiftBelt folder and will be named SwiftBelt
- Copy to the desired host and clear the quarantine attribute ($ xattr -c SwiftBelt) and set as executable ($ chmod +x SwiftBelt)
- Execute
Detection
Though this tool does not use any command-line utilities (which are easy to detect), this tool does read from several files on the system which can be detected by any tools that leverage the Endpoint Security Framework (this file reads, in particular, are captured by ES_EVENT_TYPE_NOTIFY_OPEN events within ESF).
Source: https://github.com/cedowens/