Pulse Secure Client Branding Guide

  • View
    219

  • Download
    0

Embed Size (px)

Text of Pulse Secure Client Branding Guide

  • Pulse Secure Client Customization Developer Guide

    Product Release 5.1

    Document Revision 1.0 Published: 2015-02-10

  • 2015 by Pulse Secure, LLC. All rights reserved 2

    Pulse Secure, LLC 2700 Zanker Road, Suite 200 San Jose, CA 95134 http://www.pulsesecure.net

    2015 by Pulse Secure, LLC. All rights reserved

    Pulse Secure and the Pulse Secure logo are trademarks of Pulse Secure, LLC in the United States. All other trademarks, service marks, registered

    trademarks, or registered service marks are the property of their respective owners.

    Pulse Secure, LLC assumes no responsibility for any inaccuracies in this document. Pulse Secure, LLC reserves the right to change, modify, transfer, or

    otherwise revise this publication without notice.

    Pulse Secure Client Customization Developer Guide

    The information in this document is current as of the date on the title page.

    END USER LICENSE AGREEMENT

    The Pulse Secure product that is the subject of this technical documentation consists of (or is intended for use with) Pulse Secure software. Use of such

    software is subject to the terms and conditions of the End User License Agreement (EULA) posted at http://www.pulsesecure.net/support/eula. By

    downloading, installing or using such software, you agree to the terms and conditions of that EULA.

    http://www.pulsesecure.net/http://www.pulsesecure.net/support/eula

  • 2015 by Pulse Secure, LLC. All rights reserved 3

    Table of Contents

    About This Guide ----------------------------------------------------------------------------------------------------------------------------------- 5

    Objectives ------------------------------------------------------------------------------------------------------------------------------------------ 5

    Audience -------------------------------------------------------------------------------------------------------------------------------------------- 5

    Document Conventions ----------------------------------------------------------------------------------------------------------------------- 5

    Requesting Technical Support -------------------------------------------------------------------------------------------------------------- 5

    Self-Help Online Tools and Resources --------------------------------------------------------------------------------------------------- 6

    Opening a Case with PSGSC ------------------------------------------------------------------------------------------------------------------- 6

    Customizing the Pulse Secure Desktop Client ---------------------------------------------------------------------------------------------- 7

    Customizing Pulse Secure Client Overview ------------------------------------------------------------------------------------------- 7

    BrandPackager Workflow ------------------------------------------------------------------------------------------------------------------- 9

    Setting Up the Pulse Secure Client Customization Environment ----------------------------------------------------------- 10

    Initializing the Pulse Secure Client Customization Environment -------------------------------------------------------- 11

    Importing an Existing Customized Pulse Secure Client Package -------------------------------------------------------- 12

    Editing Pulse Secure Client User Interface Labels ------------------------------------------------------------------------------ 13

    Editing Pulse Secure Client Messages ------------------------------------------------------------------------------------------------- 17

    Adding Custom Graphics to Pulse Secure Client--------------------------------------------------------------------------------- 18

    Customizing Pulse Secure Client for Windows Online Help ----------------------------------------------------------------- 20

    Customizing Pulse Secure Client for Apple OSX Online Help ---------------------------------------------------------------- 21

    Validating Customizations to the Pulse Secure Client --------------------------------------------------------------------------- 22

    Building the New Pulse Secure Client Package ---------------------------------------------------------------------------------- 22

    Testing the Pulse Secure Client Package --------------------------------------------------------------------------------------------- 22

    Installing or Upgrading Pulse for Windows with a Branding Package --------------------------------------------------- 23

    Installing or Upgrading Pulse for Apple OSX with a Branding Package ------------------------------------------------ 23

    Installing a Branding Package Only --------------------------------------------------------------------------------------------------- 25

    Index---------------------------------------------------------------------------------------------------------------------------------------------------- 27

  • 2015 by Pulse Secure, LLC. All rights reserved 4

    Pulse Secure Client Customization Developer Guide

  • 2015 by Pulse Secure, LLC. All rights reserved 5

    Pulse Secure Client Customization Developer Guide

    About This Guide

    Objectives

    The Pulse Secure Client Customization Developer Guide describes how to use the Pulse Secure branding tool to customize the Pulse Secure client interface.

    Audience

    The Pulse Secure Client Customization Developer Guide is for developers who are responsible for customizing Pulse Secure client software.

    Document Conventions

    Table 1 on page vii defines notice icons used in this guide.

    Table 1 Notice Icons

    Informational note Indicates important features or instructions.

    Requesting Technical Support

    Technical product support is available through the Pulse Secure Global Support Center (PSGSC).

    If you have a support contract, then file a ticket with PSGSC.

    Product warrantiesFor product warranty information, visit http://www.pulsesecure.net.

    http://www.pulsesecure.net/

  • 2015 by Pulse Secure, LLC. All rights reserved 6

    Pulse Secure Client Customization Developer Guide

    Self-Help Online Tools and Resources

    For quick and easy problem resolution, Pulse Secure, LLC has designed an online self-service portal called the Customer Support Center (CSC) that provides you with the following features:

    Find CSC offerings: http://www.pulsesecure.net/support

    Search for known bugs: http://www.pulsesecure.net/support

    Find product documentation: http://www.juniper.net/techpubs/

    Find solutions and answer questions using our Knowledge Base:

    http://www.pulsesecure.net/support

    Download the latest versions of software and review release notes: http://www.pulsesecure.net/support

    Search technical bulletins for relevant hardware and software notifications: http://www.pulsesecure.net/support

    Open a case online in the CSC Case Management tool: http://www.pulsesecure.net/support

    To verify service entitlement by product serial number, use our Serial Number Entitlement

    (SNE) Tool: http://www.pulsesecure.net/support

    Opening a Case with PSGSC

    You can open a case with PSGSC on the Web or by telephone.

    Use the Case Management tool in the PSGSC at http://www.pulsesecure.net/support.

    Call 1-888-314-5822 (toll-free in the USA, Canada, and Mexico).

    For international or direct-dial options in countries without toll-free numbers, see

    http://www.pulsesecure.net/support.

    http://www2.juniper.net/kb/http://www2.juniper.net/kb/http://www.juniper.net/techpubs/http://www.pulsesecure.net/supporthttp://www.juniper.net/customers/csc/software/http://www.juniper.net/customers/csc/software/https://www.juniper.net/alerts/https://www.juniper.net/alerts/http://www.juniper.net/cm/http://www.pulsesecure.net/supporthttp://www.pulsesecure.net/support

  • 2015 by Pulse Secure, LLC. All rights reserved 7

    Pulse Secure Client Customization Developer Guide

    Customizing the Pulse Secure Desktop Client

    Customizing Pulse Secure Client Overview

    The Pulse Secure client customization tool (BrandPackager) enables you to

    customize the appearance of the Pulse Secure client Windows and Apple OS X

    clients. You can add your own identity graphic to the Pulse splash screen, to the

    program interface, and to Windows credential provider tiles. Figure 1 shows graphic

    customizations applied to the Pulse for Windows client. You can also customize error

    and informational message text, the text that appears in dialog boxes and on buttons,

    and make limited changes to Pulse online Help. For example, you might want to add

    your help desk phone number to Pulse error messages and the Pulse online Help.

    BrandPackager runs on Windows only, but you use it to create the package files for

    Pulse Windows and Pulse OS X clients. A package file contains your edits to Pulse

    resource files. The edited resource files are installed into a special folder on the client.

    When the Pulse client needs to access a particular file, it checks this special folder

    first and uses the file if it is present. If Pulse does not find the file there, it uses the file

    that resides in the normal Pulse resource file location.

    For Windows, you deploy the package to endpoints and use an MSIEXEC command-line

    installation option to instruct the insta