View
226
Download
0
Category
Preview:
Citation preview
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
Guide for using Web Service Dispatcher in SMS PASSCODE® version 6.2SP1
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.
Guide for using Web Service Dispatcher in SMS PASSCODE® version 6.2SP1
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.
Guide for using Web Service Dispatcher in SMS PASSCODE® version 6.2SP1
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.
Guide for using Web Service Dispatcher in SMS PASSCODE® version 6.2SP1
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
Guide for using Web Service Dispatcher in SMS PASSCODE® version 6.2SP1
The Web Service dispatcher is now ready to use – be sure to test.
Guide for using Web Service Dispatcher in SMS PASSCODE® version 6.2SP1
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.
Guide for using Web Service Dispatcher in SMS PASSCODE® version 6.2SP1
Now please navigate to Transmission, Web Service Dispatchers, and fill out the form as shown below, and then save the settings.
Guide for using Web Service Dispatcher in SMS PASSCODE® version 6.2SP1
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
Recommended