Nokia WAP and SMS gateway User's Manual

Download or browse on-line these Operation & User’s Manual for Nokia WAP and SMS gateway Network Card.

Nokia WAP and SMS gateway Manual Information:

This manual for Nokia WAP and SMS gateway, given in the PDF format, is available for free online viewing and download without logging on. The guide contains 116 pages, and the size of the file at download is . The document type is Operation & User’s Manual.

Download Manual

Summary of Contents:

[Page 1] Nokia WAP and SMS gateway

Kannel 1.3.1 User’s Guide Open Source WAP and SMS gateway Lars Wirzenius Gateway architect Wapit Ltd [email protected] http://www.wapit.com http://www.kannel.org Kalle Marjola Manager Wapit Ltd [email protected] http://www.wapit.com http://www.kannel.org A...

[Page 2] Nokia WAP and SMS gateway

andreas@fink.org http://www.smsrelay.com http://www.gni.ch Bruno Rodrigues [email protected] http://litux.org/bruno Stipe Tolj CTO & CIO Wapme Systems AG [email protected] http://www.wapme.de http://www.kannel.org Aarno Syvänen Chie...

[Page 3] Nokia WAP and SMS gateway

Kannel 1.3.1 User’s Guide: Open Source WAP and SMS gateway by Lars Wirzenius, Kalle Marjola, Andreas Fink, Bruno Rodrigues, Stipe Tolj, and Aarno Syvänen Abstract This document describes how to install and use Kannel, the Open Source WAP and SMS G...

[Page 4] Nokia WAP and SMS gateway

Table of Contents 1. Introduction............................................................................................................................................1 Overview of WAP ..............................................................

[Page 5] Nokia WAP and SMS gateway

Smsbox configuration.............................................................................................................51 Smsbox routing inside bearerbox ........................................................................................

[Page 6] Nokia WAP and SMS gateway

Running Kannel with fakesmsc connections ...................................................................................94 Starting fake SMS center......................................................................................................

[Page 7] Nokia WAP and SMS gateway

List of Tables 3-1. Core Group Variables .........................................................................................................................14 3-2. Kannel Command Line Options........................................................

[Page 8] Nokia WAP and SMS gateway

Chapter 1. Introduction This chapter introduces WAP and SMS in general terms, and explains the role of the gateway in WAP and SMS, outlining their duties and features. It also explains why the Kannel project was started in the first place, and why i...

[Page 9] Nokia WAP and SMS gateway

Chapter 1. Introduction intermittent bandwidth, and extremely awkward input mechanisms. Most existing HTML pages do not work on mobiles phones, and never will. WAP defines a completely new markup language, the Wireless Markup Language (WML), which i...

[Page 10] Nokia WAP and SMS gateway

Chapter 1. Introduction instance, when it must send a mail notification or a stock quote. For this purpose Wapforum defined WAP Push. Push is an application level service, sitting on the top of existing WAP stack. It defines two protocols, OTA and...

[Page 11] Nokia WAP and SMS gateway

Chapter 1. Introduction Figure 1-2. Logical position of SMS gateway between a phone and a content server. An SMS gateway can also be used to relay SMS messages from one GSM network to another, if the networks do not roam messages normally. Kannel wor...

[Page 12] Nokia WAP and SMS gateway

Chapter 1. Introduction • The Gnome XML library (known as gnome-xml and libxml), version 2.2.5 or newer. See http://xmlsoft.org/xml.html. • GNU Make. • Posix threads (pthread.h). • GNU Bison 1.28 if you modify the WMLScript compiler. • DocB...

[Page 13] Nokia WAP and SMS gateway

Chapter 2. Installing the gateway This chapter explains how the gateway can be installed, either from a source code package or by using a pre-compiled binary version. The goal of this chapter is to get the gateway compiled and all the files in the c...

[Page 14] Nokia WAP and SMS gateway

Chapter 2. Installing the gateway • GNU autoconf, if you want to modify the configuration script. Compiling the gateway If you are using Kannel on a supported platform, or one that is similar enough to one, compiling Kannel is trivial. After you h...

[Page 15] Nokia WAP and SMS gateway

Chapter 2. Installing the gateway You may need to add compilations flags to configure: CFLAGS=’-pthread’ ./configure The above, for instance, seems to be required on FreeBSD. If you want to develop Kannel, you probably want to add CFLAGS that m...

[Page 16] Nokia WAP and SMS gateway

Chapter 2. Installing the gateway Installing Kannel 1. Download the binary RPM packet from the Kannel web site. 2. Log in as root: su - 3. Install the RPM package: rpm -ivh kannel-VERSION.i386.rpm Upgrading Kannel 1. Download the binary RPM packet fr...

[Page 17] Nokia WAP and SMS gateway

Chapter 2. Installing the gateway cd /etc/rc.d/rc5.d/ ln -s ../init.d/kannel S91kannel ln -s ../init.d/kannel K91kannel To run Kannel as a SMS gateway you need to edit the configuration file which is at /etc/kannel/kannel.conf. In the same director...

[Page 18] Nokia WAP and SMS gateway

Chapter 2. Installing the gateway 3. Install or upgrade the DEB package: dpkg -i kannel-VERSION .deb Removing Kannel 1. Log in as root: 2. Remove the package keeping configuration files: dpkg --remove kannel 3. Remove the package completely: dpkg -...

[Page 19] Nokia WAP and SMS gateway

Chapter 2. Installing the gateway The documentation will be installed at /usr/share/doc/kannel/. In the Kannel documentation directory there is a html file called control.html. It is an example file that shows how to use the Kannel http administrat...

[Page 20] Nokia WAP and SMS gateway

Chapter 3. Using the gateway This chapter explains how the gateway core, bearerbox, is configured and used. It covers the configuration file, keeping an eye on the gateway while it is running, and using the HTTP interface to control the gateway. A...

[Page 21] Nokia WAP and SMS gateway

Chapter 3. Using the gateway Lines 1 and 6 are comment lines. Line 5 separates the two groups. The remaining lines define variables. The group type is defined by the group variable value. The various variables that are understood in each type of co...

[Page 22] Nokia WAP and SMS gateway

Chapter 3. Using the gateway Core configuration Configuration for Kannel MUST always include a group for general bearerbox configuration. This group is named as ’core’ in configuration file, and should be the first group in the configurati...

[Page 23] Nokia WAP and SMS gateway

Chapter 3. Using the gateway Variable Value Description admin-deny-ip IP-list These lists can be used to prevent connection from given IP addresses. Each list can have several addresses, separated with semicolons (’;’). An asterisk (’*’) can ...

[Page 24] Nokia WAP and SMS gateway

Chapter 3. Using the gateway Variable Value Description box-deny-ip IP-list These lists can be used to prevent box connections from given IP addresses. Each list can have several addresses, separated with semicolons (’;’). An asterisk (’*’) c...

[Page 25] Nokia WAP and SMS gateway

Chapter 3. Using the gateway Variable Value Description unified-prefix prefix-list String to unify received phone numbers, for SMSC routing and to ensure that SMS centers can handle them properly. This is applied to ’sender’ number when receivin...

[Page 26] Nokia WAP and SMS gateway

Chapter 3. Using the gateway Variable Value Description store-file filename A file in which any received SMS messages are stored until they are successfully handled. By using this variable, no SMS messages are lost in Kannel, but theoretically some...

[Page 27] Nokia WAP and SMS gateway

Chapter 3. Using the gateway Variable Value Description ssl-trusted-ca-file filename This file contains the certificates Kannel is willing to trust when working as a HTTPS client. If this option is not set, certificates are not validated and thos...

[Page 28] Nokia WAP and SMS gateway

Chapter 3. Using the gateway Running Kannel To start the gateway, you need to start each box you need. You always need the bearer box, and depending on whether you want WAP and SMS gateways you need to start the WAP and SMS boxes. If you want, you ca...

[Page 29] Nokia WAP and SMS gateway

Chapter 3. Using the gateway --verbosity <level> -D <places> Set debug-places for ’debug’ level output. --debug <places> -F <file-name> Log to file named file-name, too. Does not overrun or affect any logfile defined i...

[Page 30] Nokia WAP and SMS gateway

Chapter 3. Using the gateway The state can be changed via HTTP administration interface (see below), and shutdown can also be initiated via TERM or INT signal from terminal. In addition, the bearerbox can be started already in suspended or isolated s...

[Page 31] Nokia WAP and SMS gateway

Chapter 3. Using the gateway shutdown Bring down the gateway, by setting state to ’shutdown’. After a shutdown is initiated, there is no other chance to resume normal operation. However, ’status’ command still works. Password required. If shu...

[Page 32] Nokia WAP and SMS gateway

Chapter 4. Setting up a WAP gateway This chapter tells you how to set Kannel up as a WAP gateway. WAP gateway configuration To set up a WAP Kannel, you have to edit the ’core’ group in the configuration file, and define the ’wapbox’ group...

[Page 33] Nokia WAP and SMS gateway

Chapter 4. Setting up a WAP gateway Variable Value Description map-url URL-pair The pair is separated with space. Adds a single mapping for the left side URL to the given destination. If you append an asterisk ‘*’ to the left side URL, its prefi...

[Page 34] Nokia WAP and SMS gateway

Chapter 4. Setting up a WAP gateway Variable Value Description log-file filename As with bearerbox ’core’ group. log-level number 0..5 syslog-level number Messages of this log level or higher will also be sent to syslog, the UNIX system log daem...

[Page 35] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway This chapter is a more detailed guide on how to set up Kannel as an SMS gateway. Required components To set up an SMS gateway, you need, in addition to a machine running Kannel, access to (an operator’s) SMS cent...

[Page 36] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description group (m) smsc This is a mandatory variable smsc (m) string Identifies the SMS center type. See below for a complete list. smsc-id string An optional name or id for the smsc. Any string ...

[Page 37] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description allowed-prefix prefix-list A list of phone number prefixes which are accepted to be sent through this SMSC. Multiple entries are separated with semicolon (’;’). For example, "04...

[Page 38] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description unified-prefix prefix-list String to unify received phone numbers, for SMSC routing and to ensure that SMS centers can handle them properly. This is applied to ’sender’ number when r...

[Page 39] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway group = smsc smsc = cimd host = 100.101.102.103 port = 600 smsc-username = foo smsc-password = bar The driver for CIMD2 is a "receiving SME" and expects the SMSC to be configured for that. It also expect...

[Page 40] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description sender-prefix string The number that the SMSC will add in front of the sender number of all messages sent from Kannel. If Kannel is asked to send a message, it will remove this prefix fr...

[Page 41] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description host (c) hostname Machine that runs SMSC. As IP (100.100.100.100) or hostname (their.machine.here) port (c) port-number Port number in the SMSC host machine alt-host hostname Optional alt...

[Page 42] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description connect-allow-ip IP-list If set, only connections from these IP addresses are accepted to receive-port. TCP/IP connection only. idle-timeout number (seconds) If this option is set to a va...

[Page 43] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description wait-ack-expire number Defines what kind of action should be taken if the the ack of a message expires. The options for this value are: 0x00 - disconnect/reconnect, (default) 0x01 - as i...

[Page 44] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description my-number number If the large account number is different from the short number, assign it with this variable. For example, if short number is 12345 and large account is 0100100100101234 ...

[Page 45] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description transceiver-mode bool Attempt to use a TRANSCEIVER mode connection to the SM-SC. It uses the standard transmit ’port’, there is no need to set ’receive-port’. This is a SMPP 3.4 o...

[Page 46] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description interface-version number Change the "interface version" parameter sent from Kannel to a value other then 0x34 (for SMPP v3.4). the value entered here should be the hexadecimal r...

[Page 47] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description reconnect-delay number Optional the time between attemps to connect an ESME to an SMSC having failed to connect initating or during an SMPP session. The default is 10 seconds. source-addr...

[Page 48] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description msg-id-type number Optional, specifies which number base the SMSC is using for the message ID numbers in the corresponding submit_sm_resp and deliver_sm PDUs. This is required to make de...

[Page 49] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway you find out the more exact meaning, please send a report. The 5.0 implementation uses X.25 access gateway. group = smsc smsc = sema device = /dev/tty0 smsc_nua = (X121 smsc address) home_nua = (x121 radio pad add...

[Page 50] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway smsc-username = foo smsc-password = foo Variable Value Description host (m) hostname Machine that runs SMSC. As IP (10.11.12.13) or hostname (host.foobar.com) port (m) port-number The port number for the connection...

[Page 51] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway pin = 2345 Variable Value Description modemtype string Modems from different manufacturers have slightly different behaviour. We need to know what type of modem is used. device (m) device-name The device the modem ...

[Page 52] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Modem Type Modems nokiaphone Nokia 6210, 7110, 8210 (tested). Probably other Nokia phones too. ericsson Ericsson GSM modem 2 This new driver is replacing the old GSM Modem driver from Kannel. It allows a GSM Modem ...

[Page 53] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description validityperiod integer How long the message will be valid, i.e., how long the SMS center (the real one, not the phone acting as one for Kannel) will try to send the message to the recipie...

[Page 54] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Modem definitions are now multiple groups present in kannel.conf, either directly or, for example, by including the example modems.conf. (See Inclusion of configuration files) Variable Value Description group mo...

[Page 55] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description sendline-sleep number (miliseconds) Optional, defaults to 100 miliseconds. The sleep time after sending a AT command. keepalive-cmd string Optional, defaults to "AT". If keepali...

[Page 56] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway group = smsc smsc = fake port = 10000 connect-allow-ip = 127.0.0.1 Variable Value Description host (m) hostname Machine that runs the SMSC. As IP (100.100.100.100) or hostname (their.machine.here) port (m) port-num...

[Page 57] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description port (m) port-number Port number in which Kannel listens to (MO) messages from other gateway connect-allow-ip IP-list IPs allowed to use this interface. If not set, "127.0.0.1" ...

[Page 58] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Featurecimd cimd2 emi emi_ip emi2 smpp sema ois at at2 http fake n n n n y n n n n y n n Can set Validity ? ? ? ? y ? ? ? ? y ? ? Can set Deferred ? ? ? ? y ? ? ? ? n ? ? Can set PID n n n n y y n n n y n n Can set...

[Page 59] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Featurecimd cimd2 emi emi_ip emi2 smpp sema ois at2 at http fake Correctly encodes @ when sending y? y? ? ? y y? ? y? y? ? y? y? Correctly encodes ä when sending y? y? ? ? y y? ? y? y? ? y? y? Correctly encodes { ...

[Page 60] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway SMSBox inherits from core the following fields: smsbox-port http-proxy-port http-proxy-host http-proxy-username http-proxy-password http-proxy-exceptions ssl-certkey-file Table 5-4. Smsbox Group Variables Variable...

[Page 61] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description sendsms-chars string Only these characters are allowed in ’to’ field when send-SMS service is requested via HTTP. Naturally, you should allow at least 0123456789. The space character...

[Page 62] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description reply-couldnotrepresent string If set, replaces the SMS message sent back when kannel could not represent the result as a SMS message. Defaults to Result could not be represented as an SM...

[Page 63] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway log-level = 0 Smsbox routing inside bearerbox The communication link between bearerbox and smsbox has been designed for the purpose of load-balancing via random assignment. Which means, bearerbox holds all smsc con...

[Page 64] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description smsc-ids word-list If set, specifies from which smsc-ids all inbound messages should be routed to this smsbox instance. List contains smsc-ids seperated by semilon (";"). This ...

[Page 65] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description keyword (m) word Services are identified by the first word in the SMS Each ‘%s’ in the URL corresponds to one word in the SMS message. Words are separated with spaces. A keyword is ...

[Page 66] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description text (c) string Predefined text answer. Only if there is neither url nor file set. Escape codes (parameters) are usable here, too. exec (c) string Executes the given shell command as the...

[Page 67] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description allowed-receiver-prefix prefix-list A list of phone number prefixes of the receiver number which are accepted to be received by this service. This may be used to allow only inbound SMS t...

[Page 68] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description assume-plain-text bool If client does not set Content-Type for reply, it is normally application/octet-stream which is then handled as data in kannel. This can be forced to be plain/text ...

[Page 69] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description suffix string white-list URL Load a list of accepted senders of SMS messages. If a sender of an SMS message is not in this list, any message received from the SMSC is rejected, unless a b...

[Page 70] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway %P the phone number of the receiver of the SMS message %q like %p, but a leading ‘00’ is replaced with ‘+’ %Q like %P, but a leading ‘00’ is replaced with ‘+’ %i the smsc-id of the connection that r...

[Page 71] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway text/html Tags are removed, rest is chopped to fit an SMS message. text/vnd.wap.wml Processed like HTML. text/xml Processed as a POST-XML. See XML Post application/octet-stream The body will be transmitted as the ...

[Page 72] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Kannel POST Kannel can do POST if service is contains a post-url="...". Table 5-9. X-Kannel Post Headers Parameter (escape code) equivalent X-Kannel Header Notes %p (from) X-Kannel-From Only sent if send-...

[Page 73] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway <alt-dcs>alt-dcs</alt-dcs> </dcs> <pid>pid</pid> <statusrequest> <dlr-mask>dlr-mask</dlr-mask> <dlr-url>dlr-url</dlr-url> </statusrequest> <from&...

[Page 74] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway SendSMS-user configurations To enable an SMS push, you must set sendsms-port into the ’smsbox’ group and define one or more ’sendsms-user’ groups. Each of these groups define one account, which can be us...

[Page 75] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description allowed-prefix prefix-list A list of phone number prefixes which are accepted to be sent using this username. Multiple entries are separated with semicolon (’;’). For example, "...

[Page 76] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway External delivery report (DLR) storage Delivery reports are supported by default internaly, which means all DLRs are stored in the memory of the bearerbox process. This is problematic if bearerbox crashes or you ta...

[Page 77] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway In addition to that you must have a dlr-db group defined that specifies the table field names that are used to the DLR attributes and a sdb-connection group that defines the LibSDB ressource itself. Here is the...

[Page 78] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Variable Value Description field-timestamp (m) string The table field that is used for the timestamp data. field-destination (m) string The table field that is used for the destination number data. field-service ...

[Page 79] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway MySQL connection configuration For several reasons external storage may be required to handle dynamical issues, i.e. DLRs, sms-service, sendsms-user, ota-setting, ota-bookmark definitions and so on. To define a ...

[Page 80] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway phone as a XML document, but this method is perhaps more suitable for continous provisioning. If you want to send multiple OTA configurations through the smsbox and you do not want to send XML documents, you will ...

[Page 81] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway phonenumber = 013456789 bearer = data calltype = analog connection = cont pppsecurity = off authentication = normal login = wapusr secret = thepasswd And a ’sendsms-user’ to use with it. With concatenation enab...

[Page 82] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway Redirected replies The basic service system always sends the answer back to original requester, but sometimes the content server needs to send something to other terminals or delay the answer. To create such system...

[Page 83] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway accepted-smsc = B get-url = "..." As can be seen, the smsc-id is used to identify the SMS center from which the message came. Then, the denied-smsc-id variable is used to prevent messages originally from ...

[Page 84] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway password (or pass) string Password associated with given username. Must match corresponding field in the ’sendsms-user’ group of the Kannel configuration, or ’Authorization failed’ is returned. from strin...

[Page 85] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway smsc string Optional virtual smsc-id from which the message is supposed to have arrived. This is used for routing purposes, if any denied or preferred SMS centers are set up in SMS center configuration. This varia...

[Page 86] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway validity number (minutes) Optional. If given, kannel will inform SMS Center that it should only try to send the message for this many minutes. If the destination mobile is off other situation that it cannot receive...

[Page 87] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway account string Account name or number to carry forward for billing purposes. This field is logged as ACT in the log file so it allows you to do some accounting on it if your front end uses the same username for a...

[Page 88] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway You can send either settings or bookmark, set CGI variable type accordingly. Default for this variable is settings. Here is an example XML document (this one contains CSD settings for logging in to a mobile service...

[Page 89] Nokia WAP and SMS gateway

Chapter 5. Setting up a SMS Gateway otaid string Name or ID of the ’ota-setting’ group in Kannel configuration that should be sent to the phone. This variable is optional. If it is not given the first ’ota-setting’ group is sent. This is un...

[Page 90] Nokia WAP and SMS gateway

Chapter 6. Setting up a SMS&WAP gateway This chapter tells you how to set Kannel up as a combined WAP and SMS gateway. SMS&WAP gateway configuration Configuration is done as explained in previous chapters, you simply have to include all the...

[Page 91] Nokia WAP and SMS gateway

Chapter 7. Setting up Push Proxy Gateway This chapter explains how to set up a push proxy gateway (PPG). An example configuration file are given. A working push proxy gateway is described. Configuring ppg core group, for push initiator (PI) interf...

[Page 92] Nokia WAP and SMS gateway

Chapter 7. Setting up Push Proxy Gateway Variable Value Description ssl-server-key-file string Mandatory value for PPG HTTPS support. The file containing server’s ssl private key. ppg-url url URL locating PPG services. Default /wappush . global-se...

[Page 93] Nokia WAP and SMS gateway

Chapter 7. Setting up Push Proxy Gateway variables are elaborated in table 7.2. As an example, let us see how to configure a ppg user (a pi, named here ’picom’) allowed to send pushes only from a specified ip. group = wap-push-user wap-push-use...

[Page 94] Nokia WAP and SMS gateway

Chapter 7. Setting up Push Proxy Gateway Variable Value Description deny-ip ip-list Defines ips wherefrom this pi cannot do pushes. Ips not mentioned in either list are denied, too. default-smsc string If no SMSC ID is given with the wappush HTTP re...

[Page 95] Nokia WAP and SMS gateway

Chapter 7. Setting up Push Proxy Gateway smsc = http smsc-id = HTTP port = 10000 system-type = kannel smsc-username = foo smsc-password = bar no-sender = true no-coding = true send-url = http://host:port/path To set up smsbox. This group will eventua...

[Page 96] Nokia WAP and SMS gateway

Chapter 7. Setting up Push Proxy Gateway Default network and bearer used by push proxy gateway If network and bearer attributes of the pap control document are missing or set any, Kannel uses address type for routing purposes: if the address type is ...

[Page 97] Nokia WAP and SMS gateway

Chapter 8. Using SSL for HTTP This chapter explains how you can use SSL to ensure secure HTTP communication on both, client and server side. Beware that the gateway, is acting in both roles of the HTTP model: 1. as HTTP client, i.e. for requesting UR...

[Page 98] Nokia WAP and SMS gateway

Chapter 8. Using SSL for HTTP Using SSL server support for the sendsms HTTP interface To use the SSL-enabled HTTP server please use the following configuration directive within the core and smsbox groups group = core ... ssl-server-cert-file = "...

[Page 99] Nokia WAP and SMS gateway

Chapter 9. Delivery Reports This chapter explains how to set up kannel to deliver delivery reports. Delivery reports are a method to tell your system if the message has arrived on the destination phone. There are different things which can happen to ...

[Page 100] Nokia WAP and SMS gateway

Chapter 10. Getting help and reporting bugs This chapter explains where to find help with problems related to the gateway, and the preferred procedure for reporting bugs and sending corrections to them. The Kannel development mailing list is devel@k...