- Quick start guide
- System requirements
- Installation guide
- Administrators guide
- User guide
- Developers guide
- Service providers
- SMPP client
- SMPP server
- SMPP server setup
- Secure SMPP server
- Credit limits
- SMPP bind
- SMPP submit_sm
- CA certificate validation
- Message tracking
- Wireshark SMPP
- Low level logging
- SMPP error codes
- User authentication
- Reporting database
- Performance tuning
- Sender ID
- Short code
- Error detection
- OZX server
How to create a secure SMPP server using TLS/SSL
When a secure TCP/IP connection is used for SMPP connections, the network traffic between your system and the SMPP clients will be encrypted. This will prevent unwanted parties access to the data that goes through the network. The two communicating endpoints will also verify each other using certificates. This verification procedure prevents man in the middle attacks. This guide explains how you can create an SSL certificate using the security app of Ozeki 10, and how you can use this SSL certificate to setup a secure SMPP service, that operates using SSL/TLS.
Is SMPP secure?
The Short Message Peer to Protocol (SMPP) is the most widely used technology to transport SMS messags over the Internet. SMPP is often used to delivery value added SMS content services, and is frequently used for mobile banking, payment reminders, SOS calls, stock and news alerts, railway and flight enquiries etc. These types of messages contain sensitive information which need to be protected.The SMPP protocol is an application layer protocol used to send messages over TCP/IP connections. In default setups the SMPP protocol has no security at all. Since the data travels through the Internet in an unecrypted format it can be captured by eavesdroppers. Compromised messages or loss of messages can cause lot of revenue loss and fatal consequences. Security for the SMPP protocol can be implemented by introducing Transport Layer Security (TLS). The TLS is a protocol layer that resides between the SMPP and the TCP/IP protocol stack. If it is installed, the protocol stack is built up from the following layers:
- SMPP layer
- TLS/SSL layer
- TCP layer
- IP layer
Video tutoral for Secure SMPP (SMPPS)
Secure SMPP is often called as "SMPP Secure" or "SMPPS". This term simply referes to the fact that the TLS layer is added to the protocol stack. The following video gives you the configuration steps on how to add the TLS layer to your SMPP server.
Create an SSL certificate
You can create an SSL certificate by opening the Security app of Ozeki 10 from the Ozeki 10 Start menu.
Figure 1 - Open Security app
Create an SSL CA certificate
The term CA certificate stands for "Certificate Authority" certificate. A Certificate Authority is the top level organization that can issue certificates and can sign these certificates using it's secret private key. With Ozeki 10 you can become your own Certificate Authority, and you can issue certificates to your customers. You will than be able to verify incoming SSL connections and see if they use the certificate you have assigned to them. You can create your CA certificate in the security app.
Figure 2 - Create CA certificate
Specify the certificate details and provide the password for the created certificate. Then click OK.
Figure 3 - Provide certificate details
If you scroll down on the Certificate details menu, you can find a setting where you could provide a filename where the communication will store you certificate files, and a password for it. You can see the example on Figure 4.
Figure 4 - Provide certificate file details
Download the created SSL certificate
Now you can start downloading the created certificate, from the certificates list. Click the Details button next to the name of your new certificate, to open the window from where you have access to the certificate file. You can find the button on Figure 5.
Figure 5 - Select details of certificate
Here you are at the details page of the certificate. Here, on the left side, you could find a blue link under the Files title, which will start the download process of the certificate file. You can see the link on Figure 6.
Figure 6 - Download certificate
Install the created SSL certificate into your SMPP server
To use the created SSL certificate to secure your SMPP connection, it must be installed. To do this open Advanced page form the management screen of the SMS gateway.
Figure 7 - Open Advanced menu
To have access to the SSL options, please open the Configure tab from the SMPP service details page, click the Advanced button and choose the SSL option. Click it and it will open the SSL settings. You can see all the button you need to look for on Figure 8.
Figure 8 - Open security option
Now you need to tick in the Use SSL connection option. Click the box next to the title as you can see on Figure 9.
Figure 9 - Enable SSL connection
Now you need to upload the previously downloaded certificate file. Look for the .pfx file and upload it by clicking the button visible on Figure 10. Also, you can provide a password to protect the certificate. Click the OK button to finish the setup.
Figure 10 - Upload certificate
Restart your SMPP server to let the changes take effect
To make sure that the certificate works, pleas restart you server by turning it off and on again with the help of the Service menu. You can see the switch on Figure 11.
Figure 11 - Enable service
In the events log, you can see that your server is successfully started, and it is working as intended. On Figure 12, you could see the Event log of the example server.
Figure 12 - Service started
- How to setup an SMPP service
- How to set SMS credits for users
- SMPP bind transceiver
- How do SMPP submit_sm and deliver_sm PDUs work
- Secure SMPP ssl certificate
- How to track an SMS in the SMPP logs
- How to trace SMPP traffic with Wireshark
- How to enable SMPP low level logging
- SMPP error codes SMPP status