Using a Web Service Dispatcher with SMS PASSCODE version 7.2 SMS PASSCODE 2014

(1)

Using a Web Service Dispatcher with

SMS PASSCODE® version 7.2

© SMS PASSCODE® 2014

(2)

SMS PASSCODE Web Service Dispatching

This document outlines the process for activating a Web Service Dispatcher 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 three are provider specific Web Service Dispatchers, and one generic Web Service Dispatcher. The generic Web Service Dispatcher works with 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.

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.

(4)

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

(5)

How to configure Twilio Web Service Dispatcher

Getting a Twilio account

Please go to http://www.twilio.com/login and press Try Twilio

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).

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

If Twilio will give you a phone number in your own country, then please check that SMS sending is working. If this is not working, then please get a US based number instead. You should deposit 20$ from credit card to be able to SMS and make calls

In “Global Permissions” make sure to allow SMS and voice calls in the countries you would like have users enabled for web service dispatching.

(6)

Twilio Dispatcher configuration

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 +)

(7)

The Generic Web Service Dispatcher

The Generic Web Service Dispatcher sends SMS from most HTTP(S) based provider. First, you should get an API description from the provider.

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.

Please configure the Parameters, so your account details are part of the parameters.

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”.

(8)

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.

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.

(9)

About SMS PASSCODE®

SMS PASSCODE is the leading technology in two- and multi-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 standard login systems such as Citrix, Cisco, Microsoft, VMware View, Juniper and other IPsec and SSL VPN systems as well as web sites. Installed at thousands of sites, this is a proven patent pending technology. In the last years, SMS PASSCODE has been named to the Gartner Group Magic Quadrant on User Authentication, awarded twice to the prestigious Red Herring 100 most interesting tech companies list, a Secure Computing Magazine Top 5 Security Innovator, InfoSecurity Guide Best two-factor authentication, a Citrix Solution of the Year Finalist, White Bull top 30 EMEA companies, a Gazelle 2010, 2011, 2012 and 2013 Fast Growth firm and a ComOn most promising IT company Award. For more information visit: www.smspasscode.com or our blog at blog.smspasscode.com.

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

Using a Web Service Dispatcher with SMS PASSCODE version 7.2 SMS PASSCODE 2014