From 8eb74d1351983232c754e02b860e27d734e42191 Mon Sep 17 00:00:00 2001 From: Stefan Sayer Date: Mon, 28 May 2007 21:51:20 +0000 Subject: [PATCH] doc on auth dialout git-svn-id: http://svn.berlios.de/svnroot/repos/sems/trunk@338 8eb893ce-cfd4-0310-b710-fb5ebe64c474 --- apps/examples/di_dialer/Readme.di_dial | 57 +++++++++++++++++++++++++- 1 file changed, 55 insertions(+), 2 deletions(-) diff --git a/apps/examples/di_dialer/Readme.di_dial b/apps/examples/di_dialer/Readme.di_dial index dcab06c6..fe98fe32 100644 --- a/apps/examples/di_dialer/Readme.di_dial +++ b/apps/examples/di_dialer/Readme.di_dial @@ -5,7 +5,8 @@ the DI interface. With the DI interface exportde to UDP in the stats module, you can for example make a simple load generator test tool. -DI Interface is like this +DI Interface: +------------- method: "dial" params: 0 - string application @@ -13,11 +14,32 @@ DI Interface is like this 2 - string from 3 - string to + method: "dial_auth" + place a call with uac authentication + params: + 0 - string application + 1 - string user + 2 - string from + 3 - string to + 4 - string auth_realm + 5 - string auth_user + 6 - string auth_pwd + + method: "dial_pin" + place a call with uac authentication from dialout PIN (see below) + params: + 0 - string application + 1 - string dialout pin + 1 - string local user + 2 - string to user + method: "help" params: none return help string e.g. get help with query_stats -c DI di_dial help +Example +------- The following line would for example place a call every second using announcement app from local user 123 to sip:ann@10.0.0.45 @@ -27,4 +49,35 @@ while true; do \ sleep 1; \ done -Please dont use SEMS for SPIT. \ No newline at end of file + +Dialout PINs +------------ + +in di_dial.conf you can set dialout pins for accounts which you then can +use to place authenticated calls in that domain. The format is: +dialout_pin=;;;;; +This makes it easier and more secure to use authenticated call because +you don't need to specify the domain every time and you don't need to send +the password every time over DI. + +If you for example have the account named "sems_account" with +the extension 1551 on siptelephony.net, and set the pin + dialout_pin0=1234;1551;sems_account;siptelephony.net;verysecret; + +if you use the pin 1234 the call will be placed + + From: 1551@siptelephony.net + To: @siptelephony.net + +with UAC authentication for the account + + realm: siptelephony.net + user: sems_account + pwd: verysecret + +you can set several dialout pins, e.g. + dialout_pin0=;;;;; + dialout_pin1=;;;;; + +Please dont use SEMS for SPIT. +(http://www.google.com/search?q=voip+spit)