Reset Search
 

 

Article

KB40985 - How to rebrand/customize the Pulse secure desktop client

« Go Back

Information

 
Last Modified Date9/29/2017 7:24 PM
Synopsis
This articles provides the steps to rebrand or customize the Pulse Desktop client.
 
Problem or Goal
A PCS administrator would like to modify the default Pulse UI fields for the Pulse Secure desktop client. For example, modifying the "User name" label to "Secret Name" and modifying the "password" label to "secret password or token" on the User Interface of Pulse Secure desktop client.
Cause
Solution
Follow the steps below to customize/re-brand the Pulse Secure desktop client.
 
  1. Download the Pulse Branding Tool from https://my.pulsesecure.net
Note:
  • The Branding Tool version should be match or be close to Pulse Secure desktop client version to be rebranded.
  • A zip utility will need to be installed on the client machine in order to extract the contents of the new package.  (i.e. download from http://www.7-zip.org/).
 
  1. Save the Pulse Branding Tool zip file (ex . ps-pulse-5.1r1.0-b51831-brandingtools.zip ) locally.
  2. Extract the files from the Branding Tool.
  3. Open command prompt as "administrator" and execute the following command:
        BrandPackager –init
(Note : The above command would be executed only if 7-zip is installed on the client machine.)

User-added image
  1. After running the above command a folder named StringReference will be created in C:\ps-pulse-5.1r12.0-b61915-brandingtools.  This folder will contain two types of files: “PulseCombinedMessages.xx.txt” and “PulseResource.xx.txt”, where xx refers to the default language set for the VPN device.
  • PulseResource.xx.txt: is used to modify the fields like the Server URL, Login Name etc.
  • PulseCombinedMessages.xx.txt” is used to modify the Pulse messages ex. error messages like “failed to connect to IVE”  etc.
  1. To modify the "User name" label to "Secret name" go to:   
;IDS_ST_USER_NAME
[93]
Value = &User name:
  1. Replace &User name with &Secret name and save the changes.  
;IDS_ST_USER_NAME
[93]
Value = &Secret name:
  1. To modify the password label go to: 
 
;IDS_ST_PASSWORD_CURRENT
[196]
Value = &password:
  1. Replace &password with &Secret password or token and save the changes.
;IDS_ST_USER_NAME
[93]
Value = &Secret name:or token
  1. Changes will be saved to the file "BrandingResourceCatalog_EN.txt" which can be found in the following location: 
ps-pulse-5.1r12.0-b61915-brandingtools -> Pulse Branding -->BrandingResourceCatalog_EN.txt .
 
Note : Choose the catalog with correct language. The example shown above is for English language
 
  1. Refer to the below screenshot for the output of the file BrandingResourceCatalog_EN.txt after making the changes:
User-added image
  1. As an optional step, the changes can be validated by running the following command: 
 
C:\ps-pulse-5.1r12.0-b61915-brandingtools> BrandPackager -validate
 
  1. The output of the above command is shown in the screen shot given below:

User-added image
  1. After validating the changes, run the command  "BrandPackager -package" to generate the new Pulse branding package to be distributed to end user machines.
 C:\ps-pulse-5.1r12.0-b61915-brandingtools> BrandPackager -package
  1. The output of the command is shown below:


User-added image
  1. On the client PC that the Pulse client will be installed to, run the following command: 
 
C:\ps-pulse-5.1r12.0-b61915-brandingtools>  BrandInstaller -brand
 
  1. The output of the above command in shown in the screen shot given below:

User-added image

NOTE: The files "PulseWin.PulseBranding" and "PulseMac.PulseBranding" will be present in "ps-pulse-5.1r12.0-b61915-brandingtools" folder.
 
  1. Verify the changes by opening the Pulse client on the client PC.  The changes should be reflected in the Pulse UI:  

User-added image

 
To install the new Pulse branded package to end user machines, please follow the steps given below:
 
Prerequisites:
 
  • File  "PulseWin.PulseBranding"(for windows platform)  should be present in all the client machine. You can use SCCM to push the file to all the client machines.
  • MSI installer of the Pulse secure desktop client should be present in all the client machines.
 Steps:
  1. Open a command prompt as "administrator" and run the following command: 
msiexec -i c:\staging\Pulse.x64.msi BRANDINGFILE=c:\staging\PulseWin.PulseBranding
 
NOTE: The path given in the above command should match the location where the MSI packages and branding files were saved.  
 
Related Links
Attachment 1 
Created ByRajkumar Tamilarasan

Feedback

 

Was this article helpful?


   

Feedback

Please tell us how we can make this article more useful.

Characters Remaining: 255