kamailio:k43-async-sip-routing-nodejs

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
kamailio:k43-async-sip-routing-nodejs [2015/09/07 12:34]
admin [SIP Routing]
kamailio:k43-async-sip-routing-nodejs [2015/09/07 13:36] (current)
admin [Async SIP Routing with Kamailio and Node.js]
Line 1: Line 1:
 ====== Async SIP Routing with Kamailio and Node.js ====== ====== Async SIP Routing with Kamailio and Node.js ======
  
-**Work in progress ​-- the tutorial is not complete yet**+Node.js-based external routing decision engine for Kamailio.
  
 ===== Overview ===== ===== Overview =====
Line 9: Line 9:
 The [[http://​kamailio.org/​docs/​modules/​stable/​modules/​rtjson.html|module rtjson]] defines a format for JSON document that makes it straightforward to push new destinations for a SIP request. The [[http://​kamailio.org/​docs/​modules/​stable/​modules/​jansson.html|module jansson]] is used to parse the JSON document in kamailio.cfg for fetching additional attributes that are relevant for processing. The [[http://​kamailio.org/​docs/​modules/​stable/​modules/​rtjson.html|module rtjson]] defines a format for JSON document that makes it straightforward to push new destinations for a SIP request. The [[http://​kamailio.org/​docs/​modules/​stable/​modules/​jansson.html|module jansson]] is used to parse the JSON document in kamailio.cfg for fetching additional attributes that are relevant for processing.
  
 +{{ :​kamailio:​kamailio-evapi-rtjson-nodejs.png?​400 |}}
 ===== SIP Routing ===== ===== SIP Routing =====
  
Line 71: Line 72:
   * retransmission and ringing timeouts   * retransmission and ringing timeouts
   * local socket or the path to be followed   * local socket or the path to be followed
 +  * branch flags
 +
 +The example above results in: the request will be routed to sip:​127.0.0.1:​5080,​ via sip:​127.0.0.1:​5082,​ sip:​127.0.0.1:​5084,​ sip:​127.0.0.1:​5086;​ it will be sent using local socket udp:​127.0.0.1:​5060;​ From header display name will be set to **Alice** and From URI to **sip:​alice@wonderland.com**;​ To header display name will be set to **Bob** and To URI to **sip:​alice@wonderland.com**;​ branch flags will be updated with 8; retransmission will be done for 5000 milliseconds,​ waiting 30000 milliseconds while ringing.
 +
 +==== EVAPI Processing ====
 +
 +EVAPI is sort of generic framework to push events to external application from inside kamailio.cfg via TCP connections. It has the capability of suspending the processing of the SIP request until there is a response from the external application. By suspending the SIP request, other SIP messages can be processes, thus not blocking Kamailio while waiting for event response. This asynchronous mechanism enables high throughput for SIP routing.
 ===== Presentations ===== ===== Presentations =====
  
Line 934: Line 942:
   * http://​nodejs.org   * http://​nodejs.org
  
-A simple sample application is shown next:+A simple sample application is shown next example. It connects to Kamailio'​s EVAPI socket, waiting for messages with json content serialized as netstring. There response will contain two destinations built with static values (sip:127.0.0.1:​5080 and sip:​127.0.0.1:​5090),​ again serialazed as netstring.
  
-<​code ​js kanapi.js>​+To read more about nestring format, see: 
 + 
 +  * https://​en.wikipedia.org/​wiki/​Netstring 
 + 
 +Node.js application:​ 
 + 
 +<​code ​javascript ​kanapi.js>​
 var net = require('​net'​);​ var net = require('​net'​);​
  
Line 1066: Line 1080:
 </​code>​ </​code>​
  
 +===== Resources =====
 +
 +  * [[http://​www.kamailio.org|Kamailio Project]]
 +  * [[http://​kamailio.org/​docs/​modules/​stable/​modules/​evapi.html|Kamaialio EVAPI Module]]
 +  * [[http://​kamailio.org/​docs/​modules/​stable/​modules/​rtjson.html|Kamailio RTJSON Module]]
 +  * [[http://​kamailio.org/​docs/​modules/​stable/​modules/​rtjson.html|Kamailio JANSSON Module]]
 +  * [[http://​nodejs.org|NodeJS Project]]
 +  * [[https://​en.wikipedia.org/​wiki/​Netstring|Netstring Format]]


Copyright 2010-2020 Asipto.com