This article continue on series of articles about the Kamailio 3.1.x SIP proxy deployed on debian lenny and its features. In previous articles we have:<\/p>\n
1) installed clear Kamailio 3.1.x server <\/a><\/p>\n 2) added Mysql support <\/a>for persistance location storage<\/p>\n 3) SIREMIS web management interface for our kamailio server<\/a>.<\/p>\n 4) Configuring IM and presence service on Kamailio 3.1 – Howto<\/p>\n 5) Configuring XCAP support for SIMPLE.<\/p>\n 6) Configuring the TLS support<\/p>\n 7) Configuring NAT traversal using Kamailio 3.1 and the Rtpproxy server<\/p>\n and now we are focusing on the CPL service API, for which the kamailio has support inside of its modules.<\/p>\n any DB module- a DB module for interfacing the DB operations (modules like mysql, postgres, dbtext, etc) <\/em><\/span><\/p>\n<\/li>\n TM (Transaction) module- used for proxying\/forking requests <\/em><\/span><\/p>\n<\/li>\n SL (StateLess) module – used for sending stateless reply when responding to REGISTER request or for sending back error responses <\/em><\/span><\/p>\n<\/li>\n USRLOC (User Location) module – used for implementing lookup("registration") tag (adding into location set of the users' contact) <\/em><\/span><\/p>\n<\/li>\n<\/ul>\n Following libraries or applications must be also installed before running Kamailio with CPL module loaded:<\/p>\n First, we have to install kamailio cpl-c<\/a> module with<\/p>\n which implement the CPL interpreter.<\/p>\n <\/p>\n The configuration will be inserted into the kamailio.cfg, so open the config file<\/p>\n Inside of cfg file find sections where modules are loaded (many line which starts with loadmodule), and at the end, behind<\/p>\n place line with CPL module loading:<\/p>\n Now we will setup module parameters required for CPL module.<\/p>\n \n\t1. First, we have to tell to the module where (in which DB) the CPL scripts are loaded. Because we have enabled the mysql DB , and during its installation we have specified DBRUL parameter which may look like this for example:<\/p>\n we may write into our cfg file:<\/p>\n <\/p>\n 2. Now we specify the location of the DTD file which contain the CPL grammar. The file have to be placed on the server. The questions is where to find such file. I have downloaded the CPLed<\/a>, the CPL editor from sourceforge, which contain the CPL definition file. then I have extracted the cpl.dtd and upload to my \/etc\/kamailio folder.<\/p>\n As the other possibilities I found, the dtd file is located inside of the cpl-c module of the kamailio src package.<\/p>\n 3. As the last step we will configure logging for better diagnostic, folders to which we are pointing on have to exist<\/p>\n modparam("cpl-c","proxy_recurse<\/strong>",2)<\/font><\/p>\n As a first step we have to modify the REGISTER method handling. We react on the situation where the CPL script may be uploaded by the end user using the REGISTER method, for this purpose there is defined function cpl_process_register()<\/strong><\/em>.<\/p>\n From the cpl-c module doc about cpl_process_register():<\/p>\n This function MUST be called only for REGISTER requests. It checks if the current REGISTER request is related or not with CPL script upload\/download\/ remove. If it is, all the needed operation will be done. For checking if the REGISTER is CPL related, the function looks fist to "Content-Type" header. If it exists and has a the mime type set to "application\/cpl+xml" means this is a CPL script upload\/remove operation. The distinction between to case is made by looking at "Content-Disposition" header; id its value is "script;action=store", means it's an upload; if it's "script;action=remove", means it's a remove operation; other values are considered to be errors. If no "Content-Type" header is present, the function looks to "Accept" header and if it contains the "*" or "application\/cpl-xml" the request it will be consider one for downloading CPL scripts. The functions returns to script only if the REGISTER is not related to CPL. In other case, the function will send by itself the necessary replies (stateless – using sl), including for errors.<\/cite><\/p>\n<\/blockquote>\n <\/p>\n Therefore inside of your kamailio.cfg file find route logic route[REGISTRAR], which is reponsible for registration handling. For kamailio 3.1 should look, where we put line (in yellow)<\/span><\/p>\n <\/p>\n Then we modify INVITE message handling to invoke CPL script for incomming calls. I've putted the line into main routing block of the Kamailio 3.1. cfg file.<\/p>\n <\/p>\n And as the last step, restart the kamailio service.<\/p>\n I have prepared simple script which will reject any SIP call, it look like:<\/p>\n The script was made with the help of the CPLed editor<\/a>, version 0.4, which should be downloaded from sourceforge.net<\/a>.<\/p>\n The CPLed is the only one visual CPL editor which I know about, and it also source of some kind of problems.<\/p>\n 1) CPLed support two possibilities how to upload a cpl script on a server, HTTP and SIP. For HTTP upload I did not configure the kamailio server yet. For SIP it is using REGISTER message, but the editor does not support SIP authentication, and upload of the script fail where the proxy challenge the editor for authentication (unauthorized fail).<\/p>\n The solution is upload it manually with FTP or ssh (winscp) and then import it. Here for the user palo@ps.sip.uniza.sk. Command have to contain precisely defined SIP uri with sip: <\/strong>prefix (sip:palo@ps.sip.uniza.sk)<\/p>\n 2) Second problem is probably IT based.<\/p>\n Scripts made by the CPLed contain the line:<\/p>\n and during the manual import there is an error:<\/p>\n The solution discovered by our students (thanks to andrej<\/a>) proposed to modify the line (delete it, for example manually), so the script will look:<\/p>\n after this smooth modification the import was sucessfull:<\/p>\n as the control I will get the script for user palo@ back by using GET_CPL:<\/p>\n so, it have to be there.<\/p>\n Initiating the call on user palo@ps.sip.uniza.sk return message<\/p>\n which declare that the script work!<\/p>\n <\/p>\n The script is removed by:<\/p>\n |Time | 192.168.1.102 | \t <\/p>","protected":false},"excerpt":{"rendered":" This article continue on series of articles about the Kamailio 3.1.x SIP proxy deployed on debian lenny and its features. In previous articles we have:<\/p>\n\n\tPrerequisities<\/strong><\/h2>\n
\n
\n
\n
\r\napt-get install libxml2 libxml2-dev\r\n<\/pre>\n
\n\tPreparation<\/h2>\n
\r\napt-get install kamailio-cpl-modules\r\n<\/pre>\n
\n\tConfiguration of the Kamailio to use the CPL<\/h2>\n
\n\tLoading required modules<\/h3>\n
\r\nloadmodule "db_mysql.so"\r\nloadmodule "tm.so"\r\nloadmodule "sl.so"\r\nloadmodule "usrloc.so"\r\n<\/pre>\n
\r\nloadmodule "cpl-c.so"\r\n<\/pre>\n
\n\tSetting up CPL module parameters<\/h3>\n
\r\n#!define DBURL "mysql:\/\/openser:openserrw@localhost\/kamailio"\r\n<\/pre>\n
\r\nmodparam("cpl-c","db_url",DBURL)<\/pre>\n\r\nmodparam("cpl-c","cpl_dtd_file","\/etc\/kamailio\/cpl.dtd")\r\n<\/pre>\n\r\nmodparam("cpl-c", "log_dir", "\/var\/log\/kamamilio\/cpl")<\/i><\/pre>\n\n\tModifying route logic for using of CPL<\/h2>\n
\n
\r\nroute[REGISTRAR] {\r\n if (is_method("REGISTER"))\r\n {\r\n cpl_process_register();<\/span>\r\n if(isflagset(FLT_NATS))\r\n {\r\n setbflag(FLB_NATB);\r\n # uncomment next line to do SIP NAT pinging\r\n setbflag(FLB_NATSIPPING);\r\n }\r\n if (!save("location"))\r\n sl_reply_error();\r\n\r\n exit;\r\n }\r\n}<\/pre>\n\n\t Modifying INVITE message handling<\/h3>\n
\r\n# account only INVITEs\r\n if (is_method("INVITE"))\r\n {\r\n setflag(FLT_ACC); # do accounting\r\n # invoke a cpl script ....\r\n if(!cpl_run_script("incoming","is_statefull"))<\/span>\r\n {\r\n # script execution failed\r\n t_reply("500","CPL script execution failed");\r\n };\r\n } <\/pre>\n\n\tTesting<\/h2>\n
\r\n<?xml version="1.0" encoding="UTF-8"?>\r\n<cpl xmlns="urn:ietf:params:xml:ns:cpl" xmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance" xsi:schemaLocation="urn:ietf:params:xml:ns:cpl cpl.xsd" >\r\n <incoming >\r\n <reject reason="CPL script reject the call" status="reject" \/>\r\n <\/incoming>\r\n<\/cpl>\r\n<\/pre>\n
\r\nkamctl fifo LOAD_CPL sip:palo@ps.sip.uniza.sk \/home\/palo\/cpl\/skusk1-cpl.xml<\/pre>\n
\r\n<cpl xmlns="urn:ietf:params:xml:ns:cpl" xmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance" xsi:schemaLocation="urn:ietf:params:xml:ns:cpl cpl.xsd" ><\/pre>\n
\r\nkamctl fifo LOAD_CPL sip:palo@ps.sip.uniza.sk \/home\/palo\/cpl\/skusk1-cpl.xml\r\ndatabase engine 'MYSQL' loaded\r\nControl engine 'FIFO' loaded\r\nentering fifo_cmd LOAD_CPL sip:palo@ps.sip.uniza.sk \/home\/palo\/cpl\/skusk1-cpl.xml\r\n500 Bad CPL file Log:: Error: CPL script is not a valid XML document<\/strong><\/span><\/em><\/u>\r\nFIFO command was:\r\n:LOAD_CPL:openser_receiver_18437\r\nsip:palo@ps.sip.uniza.sk\r\n\/home\/palo\/cpl\/skusk1-cpl.xml<\/pre>\n\r\n<?xml version="1.0" encoding="UTF-8"?>\r\n<cpl>\r\n <incoming >\r\n <reject reason="CPL script reject the call" status="reject" \/>\r\n <\/incoming>\r\n<\/cpl><\/pre>\n
\r\nkamctl fifo LOAD_CPL sip:palo@ps.sip.uniza.sk \/home\/palo\/cpl\/skusk1-cpl.xml\r\ndatabase engine 'MYSQL' loaded\r\nControl engine 'FIFO' loaded\r\nentering fifo_cmd LOAD_CPL sip:palo@ps.sip.uniza.sk \/home\/palo\/cpl\/skusk1-cpl.xml\r\nFIFO command was:\r\n:LOAD_CPL:openser_receiver_18549\r\nsip:palo@ps.sip.uniza.sk\r\n\/home\/palo\/cpl\/skusk1-cpl.xml\r\n <\/pre>\n
\r\npstest:\/etc\/kamailio# kamctl fifo GET_CPL sip:palo@ps.sip.uniza.sk<\/span>\r\ndatabase engine 'MYSQL' loaded\r\nControl engine 'FIFO' loaded\r\nentering fifo_cmd GET_CPL sip:palo@ps.sip.uniza.sk\r\n<?xml version="1.0" encoding="UTF-8"?> <cpl> <incoming > <reject reason="CPL script reject the call<\/span>" status="reject" \/> <\/incoming> <\/cpl><\/strong>\r\nFIFO command was:\r\n:GET_CPL:openser_receiver_18571\r\nsip:palo@ps.sip.uniza.sk<\/pre>\n\r\nCPL script reject the call<\/pre>\n
\n\tRemove CPL script<\/h3>\n
\r\nkamctl fifo REMOVE_CPL sip:palo@ps.sip.uniza.sk<\/span>\r\ndatabase engine 'MYSQL' loaded\r\nControl engine 'FIFO' loaded\r\nentering fifo_cmd REMOVE_CPL sip:palo@ps.sip.uniza.sk\r\nFIFO command was:\r\n:REMOVE_CPL:openser_receiver_19102\r\nsip:palo@ps.sip.uniza.sk\r\n\r\n<\/pre>\n\n\tCall flow<\/h3>\n
\n\t| | | 158.193.139.51 |
\n\t|0,004 | INVITE SDP ( BV32 g711U g711A g729 telephone-e…t) |SIP From: sip:pepe@ps.sip.uniza.sk To:sip:palo@ps.sip.uniza.sk
\n\t| |(20018) ——————> (5060) |
\n\t|0,061 | 407 Proxy Authentication Required |SIP Status
\n\t| |(20018) <—————— (5060) |
\n\t|0,170 | ACK | |SIP Request
\n\t| |(20018) ——————> (5060) |
\n\t|0,170 | INVITE SDP ( BV32 g711U g711A g729 telephone-e…t) |SIP From: sip:pepe@ps.sip.uniza.sk To:sip:palo@ps.sip.uniza.sk
\n\t| |(20018) ——————> (5060) |
\n\t|0,236 | 603 CPL script reject the cal<\/span>l |SIP Status
\n\t| |(20018) <—————— (5060) |
\n\t|0,337 | ACK | |SIP Request
\n\t| |(20018) ——————> (5060) |<\/p>\n