한국어

소프트스위치

온누리070 플레이스토어 다운로드
    acrobits softphone
     온누리 070 카카오 프러스 친구추가온누리 070 카카오 프러스 친구추가친추
     카카오톡 채팅 상담 카카오톡 채팅 상담카톡
    
     라인상담
     라인으로 공유

     페북공유

   ◎위챗 : speedseoul


  
     PAYPAL
     
     PRICE
     

pixel.gif

    before pay call 0088 from app


Gateway between SIP and SMPP messages

phone

While the SIP protocol is one of the most popular protocols used for voice calls, the SMPP (Short Message Peer-to-Peer) is one of the most widely used protocols for sending text messages. Having both of them offered by your service enhances your platform with more compatibility and flexibility.

In order for your customers to have an unified experience, one has to ensure that messages coming from one side are visible and accessible by the other side. For example, someone might send an SMS that comes to your platform over SMPP and it needs to be delivered to a SIP endpoint. Since the two protocols are incompatible (see Compatibility below), there needs to be a tool that does bridging between the two protocols.

Luckily, OpenSIPS 3.0 now features a SIP to SMPP gateway using the new proto_smpp module! This module acts as an ESMEs (External Short Messaging Entity) that is able to connect to a SMSCs (Short Message Service Center) and exchange text messages with it.

Compatibility

Messages in SMPP are binary encoded PDUs (protocol data units) that are carried between the entities involved over TCP. Since it’s using a stream oriented transport protocol, the SMPP protocol has a plethora of commands that are used to keep a SMPP session active and exchange data between endpoints: when starting a SMPP session, an ESME needs to send one of four bind commands (bind_receiver, bind_transmitter, bind_transceiver, or outbind) to the SMSC, depending on its role (receiver, transmitter, or both). Each command has to be confirmed (for example using a bind_receiver_resp acknowledgement for a bind_receiver command). After that, pinging (enquire_link) has to be sent periodically to keep the connection open. Finally, when a text message is sent, a different command command is used, depending on the state of the component.

On the other hand, in SIP things are simpler – messages are constructed using plain text SIP MESSAGE packets (RFC 3428). These messages can be exchanged between SIP endpoints and proxies using any transport protocol supported by SIP (UDP, TCP, TLS, SCTP, WebSocket), the most common one being UDP. Each SIP message sent needs to be confirmed by the receiver using a 200 OK. And that’s it.

Therefore it is clear that the two protocols are not compatible from a behavioral point of view. However, at the end of the day, both protocols are used to transport (mainly) text messages. So as long as we have the actual message payload and meta-data, all we have to do is to building the message according to the transport protocol we need to use.

Configuration

In order to use SMPP connections in your OpenSIPS install, you have to load the proto_smpp module and define a listener that will be used for communication:

listen = smpp:127.0.0.1:2775
...
load_module "proto_smpp.so"

As noted in previous section, for an SMSC to be able to deliver messages to an ESME, all SMPP connections need to be created beforehand. This is done automatically by OpenSIPS at startup. All connections that have to be initiated are described in a database, along with all the parameters they need. So the next thing that has to be configured in the script is a connection to a database:

mysql://opensips:opensipsrw@localhost/opensips

Below you can find an example of a MySQL record that describes an SMPP connection used to connect to an SMSC as a transceiver (session_type=1):

        name: SMPP_test
          ip: 127.0.0.1
        port: 2777
   system_id: smpp
    password: test
 system_type: 
     src_ton: 2
     src_npi: 1
     dst_ton: 2
     dst_npi: 1
session_type: 1
  • name: represents an arbitrary, unique name that will be used to reference this SMPP connection from the script
  • ip and port: the TCP information needed to connect to the SMSC
  • system_id (also known as the user name) and password are used for authentication
  • system_type is a field required by some SMPP providers, and it is usually used to identify the types of services that connection is allowed to use
  • TON (Type of Number) for source (src_ton) and destination (dst_ton) indicate the format of the numbers used for sender and receiver. Some common values are:
    • 0 – Unknown
    • 1 – International
    • 2 – National
    • 3 – Network Specific
    • 4 – Subscriber Number
    • 5 – Alphanumeric
    • 6 – Abbreviated
  • NPI (Number Plan Indicator) for source (src_npi) and destination (dst_npi) represent the numbering scheme used for the clients. Common values are:
    • 0 – Unknown
    • 1 – ISDN/telephone numbering plan (E163/E164)
    • 3 – Data numbering plan (X.121)
    • 4 – Telex numbering plan (F.69)
    • 6 – Land Mobile (E.212)
    • 8 – National numbering plan
    • 9 – Private numbering plan
    • 10 – ERMES numbering plan (ETSI DE/PS 3 01-3)
    • 13 – Internet (IP)
    • 18 – WAP Client Id (to be defined by WAP Forum)
  • session_type is used to specify the type of connection, and has to have one of the following values:
    • 1 – Transceiver
    • 2 – Transmitter
    • 3 – Receiver
    • 4 – Outbind

Once the connection has started, OpenSIPS can use it to exchange messages with its peer. The module will handle in the background all the SMPP protocol’s specifics.

SIP to SMPP gateway

When getting a text message from a SIP entity, it will be handled just like any other SIP request, by running the script. And if according your routing logic that message needs to end up to a SMSC, all you have to do is to call the send_smpp_message() method, specifying which SMSC should be used:

if (is_method("MESSAGE") && isflagset(TO_SMPP_TEST))
    send_smpp_message("SMPP_test");

SMPP to SIP gateway

When a message comes from a SMSC to OpenSIPS over SMPP, things get a bit more complicated – since SMPP messages are binary encoded, they can’t be sent directly to the script. Instead, they are translated to a SIP MESSAGE, and automatically sent to a SIP server or proxy, indicated by the outbound_uri parameter. Usually, the URI points to the same OpenSIPS instance, but note that the message will be sent over SIP – this means that it will be able to enter the script for determining its next hop, or final destination.

listen = udp:127.0.0.1:5060
...
# send all SMPP messages on loopback to the same instance
modparam("proto_smpp", "outbound_uri", "sip:127.0.0.1:5060")
...
route {
    ...
    if (is_method("MESSAGE") && $Ri == "127.0.0.1") {
        # handle message received over SMPP
        ...
    }
    ...
}

And that’s it, you know have a two-way gateway beween SIP and SMPP.

Conclusions

With only a few lines of configuration and the new SMPP module you can easily enhance your OpenSIPS-based VoIP platform with new means of sending text messages. Just give it a try and let us know if you ran into any trouble while setting up this feature!

Special thanks go to Victor Ciurel for developing and testing the new SMPP module in OpenSIPS!

조회 수 :
265063
등록일 :
2019.02.19
22:15:06 (*.214.125.21)
엮인글 :
http://webs.co.kr/index.php?document_srl=3318883&act=trackback&key=7ae
게시글 주소 :
http://webs.co.kr/index.php?document_srl=3318883
List of Articles
번호 제목 글쓴이 날짜 조회 수
168 opensips basic route script configuration admin 2023-08-13 6261
167 opensips-cli command admin 2023-08-07 6698
166 string trans opensips admin 2023-08-05 4896
165 opensips Push Notification configuration admin 2023-07-29 4966
164 opensips Call pickup configuration admin 2023-07-27 4874
163 t_relay opensips admin 2023-07-25 4774
162 debian 11 opensips 3.2 install command admin 2023-06-25 9102
» Opensips Gateway between SIP and SMPP messages admin 2019-02-19 265063
160 smpp sms opensips admin 2019-02-19 11001
159 Busy Lamp Field (BLF) feature on Opensips 2.4.0 with Zoiper configuration admin 2018-05-29 20532
158 Documentation -> Tutorials -> WebSocket Transport using OpenSIPS admin 2018-05-17 17103
157 List of SIP response codes admin 2017-12-20 40753
156 opensips/modules/event_routing/ Push Notification Call pickup admin 2017-12-20 13738
155 opensips push notification How to detail file admin 2017-12-20 23922
154 OpenSIPS routing logic admin 2017-12-12 45546
153 OpenSIPS example configuration admin 2017-12-12 17697
152 opensips complete configuration example admin 2017-12-10 40805
151 Opensips1.6 ebook detail configuration and SIP signal and NAT etc file admin 2017-12-10 71070
150 dictionary.opensips radius admin 2017-12-09 93819
149 what is record_route() in opensips ? admin 2017-12-09 23541
148 what is loose_route() in opensips ? file admin 2017-12-09 22953
147 in opensips what is lookup(domain [, flags [, aor]]) admin 2017-12-09 90090
146 in opensips db_does_uri_exist() what is admin 2017-12-09 17481
145 in opensips what is has_totag() admin 2017-12-09 21228
144 opensips exec module admin 2017-12-08 17892
143 opensips push notification How to admin 2017-12-07 20697
142 OpenSIPS Module Interface admin 2017-12-07 41327
141 opensips configuration config explain easy basic 오픈쉽스 컨피그레이션 기본 설명 file admin 2017-12-07 21118
140 openssl 을 이용한 인증서 생성 절차를 정리한다. 개인키 CSR SSL 인증서 파일 생성 admin 2017-09-14 22931
139 Documentation -> Tutorials -> TLS opensips.cfg admin 2017-09-14 23981