In macOS and OS X, when applications or programs are downloaded from the internet, there is a special attribute set on the file calledcom.apple.quarantine
. This attribute is read by Apple's Gatekeeper defense program at execution time and provides a prompt to the user to allow or deny execution.Apps loaded onto the system from USB flash drive, optical disk, external hard drive, or even from a drive shared over the local network won’t set this flag. Additionally, other utilities or events like drive-by downloads don’t necessarily set it either. This completely bypasses the built-in Gatekeeper check. (Citation: Methods of Mac Malware Persistence) The presence of the quarantine flag can be checked by the xattr command
xattr /path/to/MyApp.app
forcom.apple.quarantine
. Similarly, given sudo access or elevated permission, this attribute can be removed with xattr as well,sudo xattr -r -d com.apple.quarantine /path/to/MyApp.app
. (Citation: Clearing quarantine attribute) (Citation: OceanLotus for OS X)In typical operation, a file will be downloaded from the internet and given a quarantine flag before being saved to disk. When the user tries to open the file or application, macOS’s gatekeeper will step in and check for the presence of this flag. If it exists, then macOS will then prompt the user to confirmation that they want to run the program and will even provide the URL where the application came from. However, this is all based on the file being downloaded from a quarantine-savvy application. (Citation: Bypassing Gatekeeper)
Gatekeeper Bypass via command line
Supported Platforms: macOS
Name | Description | Type | Default Value |
---|---|---|---|
app_path | Path to app to be used | Path | myapp.app |
sudo xattr -r -d com.apple.quarantine #{app_path}
sudo spctl --master-disable