Guide for using Web Service Dispatcher in SMS PASSCODE® version 7.0 © SMS PASSCODE® 2014

Guide for using Web Service Dispatcher in SMS PASSCODE® version 7.0

SMS PASSCODE Web Service Dispatching This document outlines the process for activating a Web Service Dispatcher that can be used for sending SMS or for Voice Call Back. This document describes Web Service Dispatcher settings. For configuration of the SMS PASSCODE system, please visit the SMS PASSCODE Administrators Guide.

The account you use must be local administrator on the server.

Configuration Please navigate to C:\Program files\SMS PASSCODE\Tools\

Please open the program “SetActiveWebDispatcher”. The first step is determine what kind of Web Service Dispatcher you should choose.

You can only have one of each running on each Transmitter service server. There are 3 are provider specific Web Service Dispatchers, and one generic Web Service Dispatcher. The generic can be used for almost any provider offering SMS as a Web Service over HTTP/S with Post or GET.

You cannot combine the different Dispatchers on the same server. You can however have multiple generic

Web Service Providers on the same server.

Guide for using Web Service Dispatcher in SMS PASSCODE® version 7.0

Allow the use of Web Service Dispatcher. Please ensure that you have allowed for the use of a Web Service. In the SMS PASSCODE Web Administration Interface you navigate to Settings, general, and choose the Globalization options. Checkmark Web Service and save the settings.

Guide for using Web Service Dispatcher in SMS PASSCODE® version 7.0

How to configure the TeleSign Web Service Dispatcher. The TeleSign Web Service can offer both Voice Call Back and SMS sending.

Now please open your SMS PASSCODE Web Administration Interface. Navigate to Transmission and then

open Web Service Dispatchers. Please enter an optional name for the Web service and your then your

account details from TeleSign in Customer ID and in Authentication ID. Then please assign the web Service

Dispatcher to the relevant Transmitter hosts.

Please note that you must specify in the SMS PASSCODE User group policy or at the user settings whether this is a SMS Web service or if this is a Voice Call Back Web Service.

Guide for using Web Service Dispatcher in SMS PASSCODE® version 7.0

How to configure Twilio Web Service Dispatcher Getting a twilio account Please go to http://www.twilio.com/login and press Try Twilio

Now you will be asked to enter Name, Email and choose a password (choose a very complex password

since text messages will be shown in admin interface).

After this you will need to give a phone number to verify you are a human.

And Twilio will give you a phone number in your own country. Please check that SMS can be sent from the

number in that country – if not possible to send sms from the number you have got - get a US based

number instead.

You should deposit 20$ from credit card to be able to sms and make calls

Also in global permissions make sure to allow sms and voice calls in the country’s you would like have users

enabled for web service dispatching.

Guide for using Web Service Dispatcher in SMS PASSCODE® version 7.0

Twilio Dispatcher comfiguration In Twilio user dashboard it is possible to find ACCOUNT SID (=Customer ID) and ACCOUNT Token

(=Authentication ID).

The name of the Web service dispatcher must be the number the SMS or call should origin from.

It can be found/bought in Numbers -> Twilio Numbers (it should be with country code but without +)

The Web Service dispatcher is now ready to use – be sure to test.

Guide for using Web Service Dispatcher in SMS PASSCODE® version 7.0

The Generic Web Service Dispatcher The Generic Web Service Dispatcher can be used to send SMS from most HTTP(S) based provider. First, you

should get an API description from the provider.

Upgrade When using the Tool “Set active web dispatcher”, you can choose Generic. IF you click set dispatcher, it will

modify settings so you can use the Generic Web Service Dispatcher without modifying your settings. This is

preferred after an upgrade.

New dispatcher If you are setting up a new Dispatcher, then you should modify the settings according to the specification

from your SMS provider. You can either modify the settings by entering the data needed or if present, you

can choose among the know providers. Please make sure that you enter account details, where needed.

Guide for using Web Service Dispatcher in SMS PASSCODE® version 7.0

In the SMS PASSCODE Web Administration Interface, you can provide a name for your Web Service

Dispatcher. Please make sure that the name is the same a given in the “Set active web dispatcher”.

Please note that the Parameters must be edited, so your account details are part of the parameters.

In the account details, you must enter 1 in Customer ID and 1 in Authentication ID and then assign the web

service dispatcher to a transmitter host.

Guide for using Web Service Dispatcher in SMS PASSCODE® version 7.0

Registry settings

Should you need to modify the registry settings, then you can find them under

HKLM\Software\SMS PASSCODE\SWSD\:

"TrSimpleWSDParametersString" - string of params in format to=34343434&message=hello with

possible macroses described below

"TrSimpleWSDMethod" - GET or POST are possible values for that string. If GET then params are

sent in URL after ? else sent in POST request body

"TrSimpleWSDExtraHeaders" - extra headers for the request, could ContentType, or any other.

Multistring in format "Header: Value"

"TrSimpleWSDUri" - URI to be used to send request to (Must be filled in)

"TrSimpleWSDTextConversionRules" - Text conversion rules multistring. E.g. could be ' ->+'

means convert space to plus

"TrSimpleWSDResponseValidationRegex" - regular expression to validate response from the

server. Syntax could be obtained from here: http://msdn.microsoft.com/en-us/library/hs600312.aspx

List of possible macroses inside "TrSimpleWSDParametersString":

"[COUNTRYCODE]" - country code of the user (without plus) e.g. 45.

"[MOBILENO]" - mobile number without country code and compact (e.g. without spaces)

21455232. Obligatory macro

"[TEXT]" - text to be sent after rules (TrSimpleWSDTextConversionRules) have been applied.

Obligatory macro

Guide for using Web Service Dispatcher in SMS PASSCODE® version 7.0

About SMS PASSCODE®

SMS PASSCODE® is the leading technology in two-factor authentication using your mobile phone. To protect against

the rise in internet based identity theft hitting both consumers and corporate employees, SMS PASSCODE® offers a

stronger authentication via the mobile phone SMS service compared to traditional alternatives. SMS PASSCODE®

installs in minutes and is much easier to implement and administer with the added benefit that users find it an

intuitively smart way to gain better protection. The solution offers out-of-the-box protection of the standard login

systems such as Citrix, Cisco, Microsoft, Juniper and other IPsec and SSL VPN systems as well as websites. Installed at

thousands of sites, this is a proven patent pending technology. In 2009, SMS PASSCODE has been awarded to the

prestigious Red Herring 100 most interesting tech companies list, to the TechTour 25 most interesting tech Companies

in the Nordic Region and recently a Secure Computing Magazine Security Innovator. For more information visit:

http://www.smspasscode.com

SMS PASSCODE A/S

Park Alle 350D

DK-2605 Brøndby

Denmark