Home

Awesome

Wireless Config

A 802.1x configuration suite for Mac OS X Currently This suite is in testing

Contributing code

Fork the repository to your github account

Click the little button in the corner

Clone your fork of the tool and add remotes

  1. Clone your fork of the repo git clone https://yourusername@github.com/yourusername/WirelessConfig.git

example output:

Cloning into WirelessConfig...
Password:
remote: Counting objects: 361, done.
remote: Compressing objects: 100% (188/188), done.
remote: Total 361 (delta 159), reused 348 (delta 146)
Receiving objects: 100% (361/361), 5.49 MiB | 861 KiB/s, done.
Resolving deltas: 100% (159/159), done.
  1. Add the upstream remote for the main repo (mine) cd WirelessConfig
    git remote add upstream https://github.com/acidprime/WirelessConfig.git

  2. Do not make changes until you create a new branch below

Make a new branch with your changes

  1. Pull any recent updates to the master branch on the upstream repo. cd WirelessConfig
    git pull upstream master

  2. Create a new feature branch cd WirelessConfig
    git checkout -b my_new_feature

  3. Make your changes to a file in the repo cd WirelessConfig
    vim wifiutil.py
    :%s/lookatme/makingchanges/g
    :w
    :!git commit % -m "Now I know how to make commits inside vim"
    :%s/lookatme/makingmorechangessothecommitworksbelow/g
    :x

  4. Commit your changes cd WirelessConfig
    git commit wifiutil.py -m "Now I know how to make commits from the command line"

  5. Replay any changes made to the upstream fork since you started
    git checkout master
    git pull upstream master
    git checkout my_new_feature
    git rebase origin master
    open http://goo.gl/a7QYUI

  6. Push the changes in your branch back to your fork
    git push origin my_new_feature

  7. Head over to github and send a pull request

Sending a Pull request

Usage

wifiutil.py Is a 10.5,10.6,10.7,10.8 Wireless configuration command line tool

example usage:

sudo ./wifiutil.py --username=bob --password=f00b4r --plist='/path/to/wifiutil.settings.plist'

or debug:

sudo ./wifiutil.py --username=bob --password=f00b4r --plist='/path/to/wifiutil.settings.plist' -d

This script has support for removal and addtion of WPA2E networks. Technically it has support for WPA too but this only works really well on 10.6+

##WirelessConfig.bundle: A Casper self service plugin, see this document for scoped installation:

https://jamfnation.jamfsoftware.com/article.html?id=177

Otherwise you can upload through the JSS portal but not recommended while this in Beta.

kcutil: A keychain binary because 10.5 is stupid and I hate it, please upgrade.

wifiutil.settings.plist: Two arrays, to add and remove networks Note this is excluded from the build process, check the downloads section for examples This file MUST BE EDITED for your env settings. Its in the .bundle, so right click and "Show Package Contents" from there its ./Contents/Resources/wifiutil.settings.plist

To Do:

http://stackoverflow.com/questions/9639370/counting-the-length-of-two-nstextfields-not-working

Both issues are already worked around but I'm curious why this is this way

Beta Notes:

Please Make sure to modify your wifiutil.settings.plist with new guids, here is an example of how to generate them

sand-bender:~ acid$ uuidgen | tr '[:upper:]' '[:lower:]'
36afb32f-ee45-46e1-9aa8-8a58d013acad
sand-bender:~ acid$ uuidgen | tr '[:upper:]' '[:lower:]'
3ca519d7-98f2-4f50-b0d2-370473b71985
sand-bender:~ acid$ uuidgen
8A1E81A7-170B-466C-B2B2-BF8209AFF994
sand-bender:~ acid$ uuidgen
84E74439-A169-423B-A509-59EC1A0A2679

These are used for the profile thats created and the keychain items so they should be unique.

Please look through ALL the keys, I will upload a key value guide in the future, but for the moment

please just find and replace SSID and org name, other keys are written directly to plist so modify

with caution. Example is setup for PEAP (key 25) and a ssid called "newNetwork"

Note that newNetwork is listed in the remove and the add, so that password changes can happen