Encrypting files on MacOSX

Encryption of models and tracking configurations on Mac OS can be either done using the command line tool Crypter, located in the 'tools' directory or using an Automator action.

Prerequisites: Wibu Key runtime-kit and license file

The encryption/decryption system requires an attached WIBU Key, which is a USB dongle. This key should have been shipped to you by metaio.

To set up the Wibu Key, please install the Wibu Key runtime-kit on your system. The installer for this is included in the SDK ( UnifeyeSDKMobile/External ) - otherwise it is available for download here.

The license consists of an XML file and a signature file. These should have been provided to you by metaio. It contains the UDIDs or IMEI numbers of your development and testing phones. We recommend placing the license file into the 'tools' directory.

Using the command line tool directly

The crypter tool takes the following arguments:

Crypter -e <INPUTFILE> <OUTPUTFILE> 03_SDK2.pem 3 <LICENSEFILE>

an example usage for encrypting a tracking configuration could look like this:

Crypter -e TrackingData.xml TrackingData.xml_enc 03_SDK2.pem 3 LicenseFile_Yourcompany.xml

Decryption can be done accordingly using the -d flag and providing the 03_SDK2_public.pem key as argument.

Using automator for encryption

Encrypting files can also be done using an Automator action, that has to be configured once and can be then reused to encrypt all files. The following section will show how to configure the action and how to use it.

Make sure Wibukey driver is installed

• Install the Wibu Key runtime-kit from UnifeyeSDKMobile/External

Set up Automator action

• Locate the 'encrypt' workflow in the UnifeyeSDKMobile/tools directory.
  

• Open the 'encrypt' workflow. This will bring up an Automator window.
  

• Specify the absolute path to your 'tools' directory and the absolute path to your license file. Hint: you can drag-and-drop a path from Finder directly into Automator.
  

• Save the Automator Workflow as an Application by selecting: File -> Save As, enter a filename and select 'Application' as File Format.
  

This will create an executable file that will take a file as input and encrypt it.

How to encrypt files

• Just drag-and-drop your input-files onto the Automator Application that you have created before.
  

• The output of the application will be written into the same directory as the original file.
  

• For convenience you can also position this application in your Dock, so it's easily accessible.
  

How to decrypt files

Follow the steps above, just use the 'Decrypt' workflow instead of the 'encrypt' one.

-- SupportMetaio - 2010-07-07