Transports Custom Installation
From Swivel Knowledgebase Wiki
Contents |
Overview
PINsafe is supplied with a variety of integrations to many SMS vendors, and gateways. However not all are shown on screen, and sometimes may require updating
Prerequisites
PINsafe 3.x
Symptoms
Updated transport
New transport
Background
A transport is a method of delivering security strings and other information to users. Additional transport classes may be written either by syetem integrators or by Swivel Secure. Contact Swivel if an integration is required. An API is available for those wishing to write their own transport class. For further information and location of transports see below under Custom Transports.
Upgrading, or Installing a Transport Class
Transports can be created and uploaded to the PINsafe server. The locations for uploading the classes is different for PINsafe 3.5 and earlier systems see Java Class
PINsafe 3.5
<Path to Tomcat>webapps/pinsafe/WEB-INF/classes/com/swiveltechnologies/pinsafe/transport
PINsafe 3.6
<Path to Tomcat>webapps/pinsafe/WEB-INF/classes/com/swiveltechnologies/pinsafe/server/transport
When uploading custom transports to the PINsafe server ensure the file ownerships are correct. For the PINsafe appliance go to to the folder of the uplodaded transport and ensure they are correct, to change them use the following command:
chown swivel:swivel *.class
On an appliance SFTP must be used to copy the transport files to the correct location
You also may need to check the file permissions.
chmod 664 newclassname.class
Access within PINsafe
To use a new transport create an entry in the Transport section. Scroll to the bottom of the screen, and fill in the empty sections. Use the example image to populate the contents. The 'Class' is different for 3.5 and earlier systems. The end of the 'Class' line reflects the name of the Transport copied earlier. The example image, shows the entry if the SMTPTransport.class file had been uploaded.
3.5 = com.swiveltechnologies.pinsafe.transport.transport_name 3.6 = com.swiveltechnologies.pinsafe.server.transport.transport_name
Select the relevant entries for 'Group' and 'Alert repository group' and destination attribute.
The transport should now be available for use.
