Getting Started With Proximityd
Proximityd for Mac OS X
Manage your Macs using iBeacons! Run a command, install a package, enforce a policy just by having the Mac in range of a beacon using Proximityd. Just install the package and you can change any setting, install any package, apply any policy based on proximity to any iBeacon.
Proximityd is a daemon that runs on OS X. Once installed, it that listens for beacons and automatically runs scripts in the background based on rules you set up. All configuration is done via Configuration Profiles, so setup is a breeze.
First,purchase iBeacons at store.twocanoes.com. Our beacons (and this project) will support Trusted Beacons, which means that you can know that your iBeacon is not being spoofed. You can use the beacons in standard mode as well and proximityd will work fine with it.
In thedownloads section, grab the latest DMG. Open the disk image and double click on the installer, and following items will be installed:
/Applications/Utilities/Proximity Service Setup.app: Configuration app for generating a configuration profile for use with the daemon.
/Library/PrivilegedHelperTools/proximityd: This is the daemon that gets launched.
/Library/LaunchDaemons/com.twocanoes.proximityd.plist: The configuration file to start up the agent.
The installer will start up the daemon so no restart is required.
All the configuration is done via configuration profiles, either locally or via a MDM server. A sample profile, called 3PackConfig.mobileconfig is included as an example.
When you install this configuration profile, it will do 3 things when leaving/entering 3 beacon ranges:
lpadmin -p DemoInkJetFaxPrinter -v socket://18.104.22.168 -P ’/Library/Printers/PPDs/Contents/Resources/hp color LaserJet 2500.gz’
lpadmin -x DemoInkJetFaxPrinter
UUID: E2C56DB5-DFFB-48D2-B060-D0F5A71096E0 MajorNumber: 1 MinorNumber: 4
profiles -R -F /Library/Application Support/Twocanoes/turnoffsysprefs.mobileconfig ; profiles -I -F /Library/Application Support/Twocanoes/sysprefdock.mobileconfig
profiles -I -F /Library/Application Support/Twocanoes/turnoffsysprefs.mobileconfig ; profiles -R -F /Library/Application Support/Twocanoes/sysprefdock.mobileconfig
UUID: E2C56DB5-DFFB-48D2-B060-D0F5A71096E0 MajorNumber:1 MinorNumber:2
Enter Command: NONE
Creating your own profiles
To create your own configuration profiles, open the configuration app in Utilities called Proximity Service Setup:
When done, click Save Config Profile, and then install that config profile on any Mac that has proximityd installed and the settings will immediately take affect.