/Buckle-Up

Script for running Mac OS X applications in a sandbox and a collection of seatbelt profiles

Primary LanguagePython

Buckle Up!

The aim of this project is raise sensibility of security on OS X and develop seatbelt profiles for all of the common used OSX applications.

The Buckle Up script

Buckle Up is also a python script that assists you in patching your applications to run with seatbelt profiles.

Here is it's help banner:

Buckle Up!
-------
Mac OS X sandboxing helper scripts
by Arturo Filasto' <art@fuffa.org>

Usage: buckleup.py [options]

Options:
  -h, --help            show this help message and exit
  -l, --list            list all application profiles
  -p APP, --patch=APP   patch the desired application
  -a APP, --application=APP
                        explicitly set the application location
  -u APP, --unpatch=APP
                    remove patch from the desired application
  -r APP, --run=APP     run the desired application in sandbox

To list the currently available profiles run ./buckleup.py -l:

[-] Listing Buckle Up sandbox profiles...
      Name: Adium default (APP: adium)
      App Location: /Applications/Adium.app/Contents/MacOS/Adium

      Name: Firefox default (APP: firefox)
      App Location: /Applications/Firefox.app/Contents/MacOS/firefox

You can then either run the application from Buckle Up with ./buckleup.py -r adium or patch it to use seatbelt every time your run it ./buckleup.py -p adium.

To remove the patch you should run ./buckleup.py -u adium

Manually running apps with seatbelt profiles

To run an app with sandboxing enabled all you have to do is:

sandbox-exec -f <sandbox_file>.sb /path/to/the/app

For example to run the Adium sandbox plugin do this:

sandbox-exec -f adium.sb /Applications/Adium.app/Contents/MacOS/Adium

Buckle Up header

Sandbox profiles for Buckle Up include a special header that allows the shell script to offer a pretty output to the user and automagically install the application.

When writing an application profile for Buckle up you should use this format. The header should be on the first line of the sandbox profile:

;:buckleup:<buckleup version number>:<app short name>:<app long name>:<path to executable>:

buckleup version number: (default 0.1) This is the Buckle Up version number for the app profile

app short name: This is the shortname of the profile, it is what the user will provide as arugment to buckle up to patch the application or run it

app long name: This is the full name of the profile, it controls what will show in the list view

path to executable: This is the full path of the executable that should be patched, it is generally something like /Applications/MyApp.app/Contents/MacOS/MyApp

How to write a sandbox profile

You want to start from a basic sandbox profile that contains the bare minimum necessary to start the application. Something along the lines of this is a good starting point:

(version 1)
(debug allow)
(allow process*)
(deny default)

What this does it it allow processes to run and it is a whitelist based profile (i.e. the default policy is to not allow).

The next thing that you want to do is start

tail -f /var/log/system.log

All the denied by policy lines will end up in that file. Then start your application with your sandbox profile:

sandbox-exec -f <sandbox_file>.sb /path/to/the/app

You will then see in the tail -f terminal lines containing something like:

Dec 22 14:58:08 x sandboxd[12281] ([12280]): firefox-bin(12280) deny file-read-data /private/tmp

This is saying, for example, that firefox was denied "file-read-data" access to the file in /private/tmp. You should then evaluate if you want to allow that or not and in the first case add the entry that allows that in your sandbox file, like so:

(file-read-data
    (regex "^/private/tmp")
)

Continue iteratively until you reach a point where your application runs properly and all the error messages are thing you don't want to happen.

Safe hacking and remember to fasten your seatbelt :)

Resources