File Fabric Mac Tools Packager

The File Fabric Mac Tools Packager is an application that enables companies to customize features and branding of the File Fabric Mac App suite to create a specific version for their end users.

The Packager is wizard driven to enable customization of logs / icons and specific features that can be turned on/off.

This guide walks you through the various prerequisites and usage of the Packager.

You will need to begin by downloading the Packages application.

This can be downloaded from here

The XCode Commandline Tools will be required. To install these, from your Terminal, run the following command:

xcode-select --install 

You will need an active Apple Mac Developer Program account. To click here and then follow the steps to enroll.

When the account has been created, use your Apple ID to Sign In to Apple's Developer platform.

From your Account select Certificates, IDs & Profiles.

Select the + button to create a new certificate.

From the list of options under Software select Developer ID Application.

Follow Apple's instructions to generate the Developer ID Application Certificate. This process will involve creating a Certificate Signing Request. The Apple Documentation on the interface will guide you through this process.

Once you have uploaded your Certificate Signging Request to Apple, Apple will provide you with a valid Certificate. You should click Download and save this locally.

Once the Certificate has downloaded. Right-click the file, and select to open with the Keychain Access application. When Keychain Access opens, under the Certificates category, you should see the “Developer ID Application” certificate in the list. Double clicking the certificate will show more details.

Following the same steps as before, navigate to the Certificates, Identifiers & Profiles screen on the Apple Developer site, and click the + button again. This time select Developer ID Installer from under Software

When prompted to select the Certificate Signing Request, upload the Certificate Signing Request that you created for the previous certificate.

Download the generated certificate, Right Click an oepn with Keychain Access.

Reviewing your Keychain Access Certificates you should now also see a “Developer ID Installer” certificate.

In both the Developer ID Installer and Developer ID Application certificates, they should both have expandable arrows to the left, and when expanded, you should see the Private Key. It is imperative to ensure that this is the case.

To further confirm that the Developer ID Application & Installer certificates are installed, you can run the following command:

security -v find-identity |grep Developer\ ID |cut -c 47-

Since the release of macOS Catalina, Notarization of the generated application is required at the end of the process.

In order to notorize your application, the Packager requires the Sign-In Credentials for your Developer Account in order to Notorize the application with Apple.

You will need to generate an app-specific password using the following guide

You will need to retain this App-specific password for use whe building the Packaged tools

You can enter name for the new tools to be generated in this field

Here you enter the appliance URL/endpoint proceeding with “/api”

Appliance URL should be entered here.

Enter the link for your company’s terms of use here

If the following options are checked, then by default these options will be enabled in the Tools:

When checked, this option will enable the cloud drive for use. An icon will appear in the menu bar, from where the drive can be star

If checked this will show Cloud action options in Finder»Services»System Preferences.

This option if checked will ensure that on login to the machine the drive will start automatically

With automatic sync enabled users can sync local folder with cloud folder without any intervention.

Here you can provide the path for the quick upload option

If checked a search icon will appear in the menu bar to provide search for your user appliance account search.

When selected, on download the files will be automatically decrypted using the provided passphrase

When selected, on upload the files will be automatically encrypted using the provided passphrase

In this field enter the default encryption/decryption passphrase

If checked then user will only be able to access the appliance using secure connection.

From the dropdown, select how you want the tools to handle deleted files during sync. There are three options:

• Ask user what to do (default)
  • If a file is deleted in the sync pair, then the sync will not proceed without user intervention
• Delete the file
  • If a file is deleted in the sync pair, then the sync will delete the file from the corresponding sync pair folder
• Reinstate the file
  • If a file is deleted in the sync pair, then the sync will reinstate the file to the folder it was deleted from.

If checked then any hidden files present in the sync pair will not be synced.

In this field enter the file extensions you want to ignore on sync

If checked then the tools default state will be OFF.

If enabled, user will see the share icon in the ribbon when the tools are started.

For branding replace the SME default icons with you company branded icons. When creating icons, you should be aware of their compatibility with Mac OS X.

This replaces the Tools icon in System Preferences.

This icon is displayed in menu bar when the drive is offline

This icon is displayed in menu bar when the drive is started and is online.

This icon is displayed in front of the locked files in the drive.

This icon is displayed in the finder window. When users access their account using the drive.

This icon is displayed in the menu bar for the search add-on

This icon is displayed in menu bar when sync is running

This icon is displayed in menu bar when sync is paused

This icon is displayed in menu bar if the sync fails

This is the SME mail add-in icon that appears on the top left when user composes a new email.

This icon is displayed in the menu bar for the share tool add-on

This image will be displayed as the background for the tools installer.

Here you can provide instruction and links for the users to see when installing the tools.

Here you can provide links for your company Terms of use, privacy policy or any other company policy that the users will/can see during the installation of the tools.

Once these configurations have been setup, you can click on Generate installer button and to generate the tools.

At the bottom of the Packager configuration are 4 fields:

• Code Signing Identity
• Package signing identity
• Username for notarization
• Password for notarization

For the “Code Signing Identity” and “Package Signing Identity” you should select the Developer ID Application and Developer ID Installer Certificates retrospectively. As these certificates work in pairs, it's important to ensure that the identifier of the certificate (in brackets at the end) match in both dropdowns.

For the username and passwords, you will need to enter your Apple ID email and the App-specific password you generated in the earlier steps.

Please refer to this page.