Professional Documents
Culture Documents
CTERA Customizations
CTERA Customizations
CUSTOMIZATION OPTIONS
February 2017
Version 5.5 Feature Pack 2
Copyright © 2009-2017 CTERA Networks Ltd.
All rights reserved. No part of this document may be reproduced in any form or by any means without written permission
from CTERA Networks Ltd.
Information in this document is subject to change without notice and does not represent a commitment on the part of
CTERA Networks Ltd.
CTERA, C200, C400, C800, C800+, Virtual Gateway, P1200, CloudPlug, NEXT3, Cloud Attached Storage, and Virtual Cloud
Drive are trademarks, service marks, or registered trademarks of CTERA Networks Ltd.
All other product names mentioned herein are trademarks or registered trademarks of their respective owners.
The products described in this document are protected by U.S. patents, foreign patents, or pending applications.
CONTENTS
Introduction.................................................................................................. 4
CTERA Agent and Cloud Storage Gateway Customizations ............................ 5
CTERA Agent Installation Customization Options .............................................................. 5
Local Interface Customization Options .............................................................................. 7
New User Setup Wizard Customization Options .............................................................. 10
Web Interface Customization Options ............................................................................. 13
Outlook Plugin Customization Options ............................................................................ 16
Preconfiguration Options ................................................................................................. 17
CTERA Portal
CTERA Portal customizations are performed by your technical team, using files supplied by CTERA.
In order to customize the CTERA Portal, you need to prepare the following:
• A list of desired customizations
• The company logo in PNG format. The recommended size is 210x70 pixels.
You will also need to open a ticket at www.ctera.com/support and request the latest SKIN files.
CTERA Mobile
CTERA Mobile customizations can be performed for the following.
• CTERA Mobile 5.5 for Apple iOS
• CTERA Mobile 5.5 for Android
This can be changed to the name of your product in both the window title and the screen title.
• Language
By default, the agent will use the language that is currently defined as the operating system's
active language pack. In the following example, the active language pack is English, so the wizard
is displayed in English.
If desired, the language can be preconfigured and fixed. The supported languages are: English
(United States), French, German, Italian, Portuguese (Brazil), or Spanish (Spain, International Sort).
• Default installation folder
By default, the Select Installation Folder dialog box displays the default installation path, which
includes CTERA\CTERA Agent.
The part of the path following "C:\Program Files (x86)\" can be changed to any path you prefer.
This can be changed to a graphic that suits your company's branding and color scheme.
• Default CTERA Portal
By default, the Sign in page's Server field is empty.
You can pre-fill this field with the hostname of your company's CTERA Portal.
• Default advanced settings
By default, the Advanced Settings fields are empty.
You can pre-fill these fields with your company's proxy settings.
• Product name in shell extensions
By default, the text "CTERA Agent" is displayed in the right-click menu for files and folders,
enabling users to select an item for file-level backup to the CTERA Portal.
This can be changed to the name of your product. The icon next to it can be changed, as well.
• Product tray icon menu
By default, the product tray icon menu is similar to the local interface.
The logo, fonts, font colors, action buttons, product name, language, background images, and
icons can by changed.
• Color scheme
To customize the agent to your company’s look and feel, you can change the color scheme from
its default settings to your preferred ones. This is true for the following:
• Fonts
• Highlighted items
• Selected items
• Action buttons
• Line separators
• Toolbars
• Icons
• Background
PRECONFIGURATION OPTIONS
It is possible to preconfigure the CTERA Agent with certain settings that will take effect immediately
upon installation. These settings include:
• SSO (Single Sign On)
Single Sign On is available when using Active Directory users. After the initial sign in, the user will
be able to log in without entering their user and password again.
• Language
By default, the language is set to English. It is possible to preconfigure the language of your choice
for all users.
• Server
By default, the Server field in the Welcome to CTERA Agent screen is empty, and the value must
be entered manually. It is possible to preconfigure this field for all users.
• Cloud Drive path
In single user mode, the CTERA Agent Cloud Drive folder is located under the following path on
Windows: volume:\ProgramData\CTERA\CTERA Agent\CloudDrive
Where volume is the volume name.
On Linux and Mac, the path is: /usr/local/cloud
In multiuser installation mode, the Cloud Drive folder is located under the user's home folder. For
example, in Windows: volume:\Users\User1\CloudDrive
By default, the user’s home folder, usually called "myfiles", is synced to this location, as well as any
other cloud folders that were configured for synchronization. It is possible to specify a different
Cloud Drive path, such as the following path on Windows:
volume:\office\storage\CloudDrive
• Mapped cloud folder
It is possible to preconfigure the CTERA Agent to set up a mapped network drive that uses
WebDAV. The CTERA Agent installer will also install a WebDAV client and will connect to the cloud
folder after connecting to the CTERA Portal.
• Online help link
By default, the Help link in the CTERA Agent Web interface leads to a help page on CTERA's
website.
It is possible to change this link, so that it leads to your own help page. The changed link will be in
the following format: your-website/help/agent/product-version/
Where:
• The layout of the End User Portal's Web interface and the team portal's Administration Control
Panel cannot be changed.
The interface colors, as well as the background image, can be changed to suit your company's
preference.
The End User Portal's Login page can be completely customized via the login.html file. For example:
Note: In addition to the customizations available via the base skin, you can customize the End User
Portal interface – including language, support URL, and more – via the CTERA Portal's Settings
> Virtual Portal Settings page. For information, refer to the CTERA Portal Administrator
Guides, Configuring Virtual Portals.
You can completely customize the End User Portal's Web interface via the skins.css file under
ctera_basic_skin/EndUser/css/.
The team portal Administration Control Panel can be completely customized via the skins.css file.
For example:
CUSTOMIZING SKINS
To customize a skin:
1 Contact CTERA Support and request the base skin file ctera_base_skin.skin.
This is a standard CTERA skin.
2 Change the .skin suffix to .zip and extract the files to a folder.
3 To customize different css attributes, edit skins.css as desired.
4 To customize images that the base skin uses, change the image files located under
ctera_base_skin/EndUser/img, or add new ones and reference them in your code.
5 To customize the Login page, edit ctera_base_skin/EndUser/login.html as desired.
Note: Do not change the following files
• ctera_base_skin/EndUser/css/css.css or ctera_base_skin/css/css.css
• The js scripts located under ctera_base_skin/EndUser/js or ctera_base_skin/js
6 When done making customizations, edit MANIFEST.MF, and set the value of name= to the name
of your skin.
For example: name=myFirstSkin
7 Select all of the files and folders under the extracted folder and compress then into a ZIP file with
the name of your skin.
Note: Do not zip the extracted folder. Zip the contents of the extracted folder.
The name of the ZIP file must be identical to the name of the skin specified in the
MANIFEST.ME file.
8 Change the .zip suffix to .skin.
9 Upload the skin file to the CTERA Portal in the Settings > Skins page.
Note: Only a global administrator can upload a skin file to a CTERA Portal.
10 Mark the newly added skin as current.
11 Refresh the portal to apply the customizations.
Customization Options
Upon starting the branding process, you will receive a zip file that contain all of the icons, splash
screens, and images that you may want to customize to match you company’s look & feel.
Note: The following cannot be customized:
• File names
• File formats
• Files sizes (in pixels)
• Folder hierarchy
The following customizations can be made to CTERA Mobile for iOS:
• App display name
By default, "CTERA M" is used as the app name.
• Color palette
The CTERA app uses three main colors throughout its interface screens. By default, these are the
CTERA colors:
then the Server Address field will be replaced by of a text field where one can enter "portalA" or
"portalB", followed by a drop-down list with two options: firstportal.com and secondportal.com.
• Welcome screen
By default, the CTERA cover picture and graphics is displayed on the Welcome screen.
The notifications and bottom action bar have the following customizable elements:
• Action icons
• Background color
• Passcode screen
By default, the CTERA interface is displayed in the passcode screen on the device.
• During the process of publishing the app, you must upload an Encryption Registration (ERN)
approval.
The CTERA app encrypts the data stored on the device, in order to prevent random access to the
user's data. Apple requires all apps that use cryptography to have an ERN approval from the
Bureau of Industry and Security (BIS); therefore, you will need to obtain an ERN approval as
described in Obtaining an ERN Approval from BISand upload it to iTunes Connect as described in
Uploading the ERN Approval to iTunes Connect.
For more information about ERN approvals, visit
http://www.bis.doc.gov/index.php/policy-guidance/encryption.
• In order to distribute the app on the App Store, you must sign it with a distribution certificate as
described in Signing the App with a Distribution Certificate.
While the app provided by CTERA comes signed with a distribution certificate, it is only a temporary
certificate. It is therefore necessary to re-sign the app with your own distribution certificate. CTERA
provides a tool that enables you to easily re-sign the app with your own certificates.
Note: The tool must be run on the Mac machine from which you intend to upload the app to the App
Store.
The user running the tool must have access to the Mac machine's keychain, specifically to the
signing authority within the keychain. The Mac machine must have xcode installed as well as
the apple developers account’s official certificate and private key.
The tool supports Mac OS X v10.5 or later.
To sign the app:
1 Extract the provided iOSresign.zip file to a local folder on the Mac machine.
2 Run ./genResignInfo.sh
Usage: ./genResignInfo.sh "BundleID" "AppPrefix" “SigningCertName"
Where:
• BundleID is the bundle ID.
• AppPrefix is the app prefix taken from SigningCertName.
• SigningCertName is the signing certificate name, which can be obtained as follows: Under
KeyChain > MyCertificates, double click on iPhone Distribution, and copy the Common name
field.
Example: ./genResignInfo.sh "com.babagam.mobileWebDav" "DX8CKVFKYL"
"iPhone Distribution: BABAGAM LTD (DX8CKVFKYL)"
This generates the resignInfo.plist file for the resigning process.
3 Make sure you have four different App IDs for the process, where the main ID is the one you used
to generate resignInfo.plist.
Note: If you need to create new App ID you can do it in Apple’s member center site.
CTERA recommends providing suffixes for the three other App IDs similar to Document Picker, file
Provider and Share as in the following example.
For each App ID, the App group feature must be enabled.
4 Click Edit at the bottom of the App ID settings to enable the App group.
5 Click Edit and choose the App Group ID of the main App ID, as in the following example.
6 Create four different iOS Distribution provisioning profiles. Each profile must use a different App
ID.
• The profile that uses the main App ID.
• The names of the three others use suffixes similar to the following:
• DocumentPicker, for example CTERACloudDocumentPicker.
• FileProvider, for example CTERACloudFileProvider.
• Share, for example CTERACloudShare.
7 Download the four provisioning profiles into the local folder you created on step 1.
8 Make sure your folder has these four files:
• resignInfo.plist that was re-signed in step 2.
• CTERA_Mobile_XXX_Y.Z.W.ipa provided by CTERA Networks Ltd.
• ctera-resign-ux.sh provided by CTERA Networks Ltd.
• All four provisioning profiles
9 From the local folder you created on step 1 run the following command.
./ctera-resign-ux.sh [-i CTERA.ipa] [-p Profile] [-d Profile]
[-f Profile] [-s Profile]
Options
-i – A .ipa file provided by CTERA Networks Ltd.
-p – A provisioning profile for signing the app.
-d – A provisioning profile for signing the 'Document Picker' app extension.
-f – A provisioning profile for signing the 'File Provider' app extension.
-s – A provisioning profile for signing the 'Share' app extension.
Example:
./ctera-resign-ux.sh -i CTERA_Mobile_Company_5.7.19.ipa \
-p Company.mobileprovision \
-d CompanyDocumentPicker.mobileprovision \
-f CompanyFileProvider.mobileprovision \
-s CompanyShare.mobileprovision
10 The new re-signed file is located in the folder created in step 2.
Signed_CTERA_Mobile_XXX_Y.Z.W.ipa
This is the re-signed file to use with Application Loader.
Customization Options
Upon starting the branding process, you will receive a zip file that contain all of the icons, splash
screens, and images that you may want to customize to match you company’s look & feel.
Note: The following cannot be customized:
• File names
• File formats
• Files sizes (in pixels)
• Folder hierarchy
The following customizations can be made to CTERA Mobile for Android:
• App display name
By default, "CTERA" is used as the app name.
CTERA colors:
• Welcome screen
By default, the CTERA cover picture and graphics is displayed on the Welcome screen.
The notifications and bottom action bar have the following customizable elements:
• Action icons
• Background color
• Passcode screen
By default, the CTERA interface is displayed in the passcode screen on the device.