StoneGate SSL VPN Technical Note 2084
Configuring SMPP
Table of Contents 2
Table of Contents
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . page 3
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . page 3
Configuring SMPP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . page 3
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . page 8
Feedback. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . page 8
Introduction 3
Introduction
This technical note describes how to configure the short message peer-to-peer protocol (SMPP) for use with
StoneGate SSL VPN.
This technical note assumes a thorough understanding of StoneGate SSL VPN administration and SMPP. Use the
further reading to gain the required knowledge.
Further Reading
More information on StoneGate SSL VPN administration can be found in the StoneGate SSL VPN Administrator’s
Guide, the Online Help, and the Technical Note repository provided with the product. Another source of information
is the Stonesoft Support site, which can be found at http://www.stonesoft.com/support/.
For more information on related subjects, visit http://smsforum.net.
Overview
The short message peer-to-peer protocol (SMPP) is a telecommunications industry protocol for exchanging SMS
messages between SMS peer entities such as short message service centres. It is often used to allow third parties
(e.g. value-added service providers like news organizations) to submit messages, often in bulk.
SMPP was originally designed by Aldiscon, a small Irish company that was later bought by Logica. In 1999, SMPP
was formally handed over to the SMPP Developers Forum, later renamed as The SMS Forum.
The protocol is based on pairs of request/response PDUs (protocol data units, or packets) exchanged over OSI
layer 4 (TCP/IP session or X.25 SVC3) connections. PDUs are binary encoded for efficiency.
The most commonly used versions of SMPP are v3.3, the most widely supported standard, and v3.4, which adds
transceiver support (single connections that can send and receive messages). Data exchange may be synchronous,
where each peer must wait for a response for each PDU being sent, and asynchronous, where receiving and
transmitting go in independent threads with the use of buffers and timers. The latest version of SMPP is v5.0.
StoneGate SSL VPN currently supports v3.4.
Configuring SMPP
The SMPP parameters are configured by adding Additional Configuration in “Manage System/Notification
Settings/SMS Channel”. Click “Add Additional Configuration…” for the SMS channel and insert the key name
and appropriate value from the table below or as supplied by your SMS provider.
Table 1 below lists relevant SMPP keys that can be used to configure your StoneGate SSL VPN setup. Table 2 on
page 6 contains error codes.
TABLE 1 SMPP Keys
Key Used at
Possible
Values
Default
Value
Description
smpp-version Bind
51 – 3.3
52 – 3.4
51
This parameter is used to indicate the version of the SMPP
protocol. The following interface version values are defined, 0-
51 (0x00-0x33) Indicates that the EMSE supports version 3.3
or earlier of the SMPP protocol. 52 (0x34) Indicates that the
ESME is supporting SMPP version 3.4
smpp-timeout Connect Integer 10000
Timeout used when trying to communicate with SMPP server.
Defined in milliseconds.
