Single Channel Customisation How to Guide

From Swivel Knowledgebase Wiki

Jump to: navigation, search


Image:logo.gif


This document outlines the ways to modify the Single Channel image.

Contents

Prerequisites

PINsafe 3.x

Test PINsafe system for testing modifications


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


Editing the Turing 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

Image: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.

Image:Background0.jpg

Image:Background1.jpg

Image:Background2.jpg

Image:Background3.jpg

Image:Background4.jpg

Image:Background5.jpg

Image:Background6.jpg

Image:Background7.jpg

Image:Background8.jpg

Image: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. 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.

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>
Retrieved from "http://kb.swivelsecure.com/wiki/index.php/Single_Channel_Customisation_How_to_Guide"
Personal tools