Single Channel Customisation How to Guide

From Swivel Knowledgebase
Jump to: navigation, search


Overview

This document outlines the methods to modify the Single Channel image such as the TURing image and Pinpad.


Prerequisites

PINsafe 3.x

Test PINsafe system for testing modifications


Upgrade Considerations

Changes to the Single Channel images should be backed up before an upgrade as they may be overwritten and may need to be copied back to the Swivel instance after the upgrade.


PINsafe Administration Console Settings

Changes to the Single Channel image can be made in the PINsafe Administration console under Server/Single Channel. For more information see Single Channel How To Guide


TURing Editing

Turing Image Editing files

Changes made are only recognised after a restart of Tomcat.


The background mask

located under <path to Tomcat Webapps>/pinsafe/WEB-INF/singleChannel/backgrounds

TuringPinned.jpg

This is a jpg image and the file must be edited to make any modifications. Restart Tomcat for the changes to be read.


The background patterns

located under <path to Tomcat Webapps>/pinsafe/WEB-INF/singleChannel/backgrounds

These are 280x33 72dpi jpg files. These can be edited and and new backgrounds uploaded, new file name must be added to backgrounds.xml. Restart Tomcat for the changes to be read.

Background0.jpg

Background1.jpg

Background2.jpg

Background3.jpg

Background4.jpg

Background5.jpg

Background6.jpg

Background7.jpg

Background8.jpg

Background9.jpg

NOTE: if adding new backgrounds, make sure the file owner is set to "swivel" as follows:

chown swivel:swivel backgroundx.jpg


The fonts

located under <path to Tomcat Webapps>/pinsafe/WEB-INF/singleChannel/fonts

Font size is controlled by <fonts bold="true" italic="false" size="12">, new fonts must be uploaded to the PINsafe server fonts folder and also added to the font list in fonts.xml. Remember to backup the file before editing. When uploading new fonts, make sure to set the owner and group of every file to "swivel" as follows:

chown swivel:swivel fontx.ttf

To remove fonts, edit the fonts.xml and remove the fonts which are not required, and if present delete the glyph.zip file. Remember to backup these files to a safe location.

Restart Tomcat for the changes to be read.


PINpad Editing

PINpad by default uses the below colour and images, but can be edited to display different images.


Pinpad-default.jpg


Editing PINpad images

The PINpad image files are located in <path to Tomcat>/pinsafe/webapps/WEB-INF/singleChannel/pinpad. Each image is numbered 1.png through to 10.png. The image files can be edited to change the background colour and image displayed, and uploaded to replace the existing images. Restart Tomcat after making the changes.


PINpad with Arabic font. The Arabic fonts can be downloaded from here: PINpad Arabic


Pinpad-arabic.jpg


PinpadClear.png PINpad Clear button

PinpadRefresh.png PINpad Refresh button


Below are some sample images:


Q.png Q-grey.png Q-lightblue.png Q-lightgreen.png Q-lilac.png Q-pink.png Q-white.png


Pattern2

Pattern2, PIN character positions:

5th 6th 7th

1st 2nd 3rd 4th

8th 9th 10th

Pattern2.PNG


If your PIN is "1357", you extract the 1st 3rd 5th and 7th character

Pattern2 example.PNG

In this example, your OTC is "3207".

Testing

The single channel image is requested by using the following request to the PINsafe server:

 http://<PINsafe server IP>:8080/pinsafe/SCImage?username=<username>

example: http://turing.swivelsecure.com:8080/pinsafe/SCImage?username=test

For a PINsafe appliance the request is usually:

 https://<PINsafe server IP>:8443/proxy/SCImage?username=<username>


Troubleshooting

Changes do not appear

If the changes are not visible then it may be that the fonts are cached in Tomcat. To remove the Tomcat cache remove all the files in <path to Apache Tomcat>/temp.

Also, try removing the glyph.zip file from:

<path to Apache Tomcat>/pinsafe/WEB-INF/singleChannel/fonts/glyph.zip