guide for using web service dispatcher in sms passcode ... · pdf fileguide for using web...

Guide for using Web Service Dispatcher in SMS PASSCODE® version 6.2SP1 © SMS PASSCODE® 2013

Guide for using Web Service Dispatcher in SMS PASSCODE® version 6.2SP1

This document outlines the process for activating the TeleSign or Twilio voice dial out and Web SMS

service. Further will be described how to set up a custom HTTP(S) based SMS provider with simple GET or

POST in SMS PASSCODE® version 6.2 or the XML Web Service from Retarus©

Telesign 3 Twilio 4 SimpleWebServiceDispatcher 6

The Retarus XML configuration 8


Telesign SMS PASSCODE has entered a partnership with TeleSign, a two-factor authentication focused service

provider to deliver the SMS PASSCODE one-time-password either as a voice dial out call or as a SMS

delivered via the TeleSign service. This is primarily to augment our modem based dispatcher with alternate

deliveries for the North American market.

When activating TeleSign, a user first create an account with TeleSign. The below account creation page

gives a trial account. At the time the trial account is activated, the user will receive details on activating the

account with a credit card if the user wants to continue the service.

Create an account To use the TeleSign Web Service you first have to create an account. To do so, please go to the following

URL: http://www.telesign.com/lp/smspasscode/ and fill in the form.

Configure SMS PASSCODE Once you have entered your account details, TeleSign will create a trial account. An email will be send to

you with the pertinent account details. Please visit the SMS PASSCODE Administrators Guide to configure

the SMS PASSCODE system.

http://www.telesign.com/lp/smspasscode/


Twilio Setting up Twilio is easy and very price competitive

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 phonenumber 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 sent 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 voicecalls in the countrys you would like have users

enabled for web service dispatching.

http://www.twilio.com/login


Replace telesign WebServiceDispatcher with Twilio Please stop SMS PASSCODE Transmitter service

Navigate to Program Files\SMS PASSCODE\Dispatchers

And rename WebServiceDispatcher.dll to i.e. WebServiceDispatcher.dll.Telesign

After that please rename TwilioWebServiceDispatcher.dll to WebServiceDispatcher.dll

in the same directory.

Start SMS PASSCODE Transmitter service

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 countrycode but without +)

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


SimpleWebServiceDispatcher The SimpleWebServiceDispatcher can be used to send SMS from most HTTP(S) based provider. First, you

should get an API description from the provider and contact SMS passcode support to verify it can work and

if there already are example configuration files for

It takes the following registry settings (must be created under HKLM\Software\SMS PASSCODE) :

"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

Example for Clickatell:

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\SMS PASSCODE]

"TrSimpleWSDMethod"="POST"

"TrSimpleWSDUri"="http://api.clickatell.com/http/sendmsg.php"

"TrSimpleWSDParametersString"="user=CHANGEUSER&password=CHANGEPASSWORD&ap

i_id=CHANGID&to=[COUNTRYCODE][MOBILENO]&text=[TEXT]&msg_type=SMS_FLASH

" Replace telesign WebServiceDispatcher with SimpleWebServiceDispatcher Please stop SMS PASSCODE Transmitter service Navigate to Program Files\SMS PASSCODE\Dispatchers And rename WebServiceDispatcher.dll to i.e. WebServiceDispatcher.dll.Telesign After that please rename SimpleWebServiceDispatcher.dll to WebServiceDispatcher.dll in the same directory. Create the Web service dispatcher in Web Administration Interface Name can be chosen as wanted and Customer ID and Authentication ID are not used. Be sure to assign it to transmitter host(s) where the telesign dll have been replaced with SimpleWebServiceDispatched

http://msdn.microsoft.com/en-us/library/hs600312.aspx


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


The Retarus XML configuration SMS PASSCODE has entered a partnership with Retarus©, a focused service provider to deliver the SMS PASSCODE one-time-password as a SMS by a XML web service.

Change the dll file Please navigate to C:\Program files\SMS PASSCODE\Dispatchers\

Stop the SMS PASSCODE Transmitter service.

Rename the file WebServiceDispatcher to WebServiceDispatcher.old

Rename the SimpleWebServicedispatcher to WebServiceDispatcher

Start the SMS PASSCODE Transmitter service

Configure Registry for using Retarus In the registry database, you will need to add 4 registry keys. You can copy the text below, into a notepad, and save the file as regestry.reg and either modify the text before importing the keys or after importing the keys.

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\SMS PASSCODE]

"TrSimpleWSDMethod"="POST"

"TrSimpleWSDUri"="https://sms4ba.retarus.com/XmlSms/sms/"

"TrSimpleWSDParametersString"="<?xml version='1.0' encoding='UTF-

8'?><data><message>[TEXT]</message><numbers><number>00[COUNTRYCODE][MOBILEN

O]</number></numbers><userId>CHANGEID</userId><password>CHANGEPW</password><p

roperty name='sender'>CHANHGENUMBER</property><property

name='flash'>true</property></data>"

"TrSimpleWSDPerformTextUrlEncoding"=dword:00000000

Please note that the CHANGEID, CHANGEPW and CHANGENUMBER must be configured with your account data. Once this data has been configured, and then please restart the SMS PASSCODE Transmitter service.

Configuration in the SMS PASSCODE Web Administration Interface. First 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.


Now please navigate to Transmission, Web Service Dispatchers, and fill out the form as shown below, and then save the settings.


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

http://www.smspasscode.com/

guide for using web service dispatcher in sms passcode ... · pdf fileguide for using web...

Documents