注：以下文章如需转载，请注明所属作者，转载地址，谢谢！
第四章：OpenSER标准配置（OpenSER Standard Configuration）
OpenSER的标准配置文件安装在/etc/openser/openser.cfg。它是OpenSER的最简单的配置文件之一。而且它还是一个可以开始进行解释OpenSER功能的理想脚本。和一些基本的模块，参数和函数一样，还有一些区段是你应该熟悉了解的。
这个章节结束后，你将能够：
l 识别出openser.cfg配置文件的各个区段
l 识别出标准配置的限制
l 使用ngrep工具跟踪SIP事务
l 使用XLOG模块记录路由过程
l 使用append_hf命令标记ngrep工具跟踪的包
标准配置是一个好的出发点。它拥有最小化的功能集合，不支持验证，所以你可以不使用密码就可以连接你的SIP话机。不管怎样，你都可以从一部话机呼向另一部，我们将在之后测试之。
我们在哪？（Where Are We？）
我们要再一次提到的是，VoIP服务提供商的解决方案中有许多的部件。为了失去对整体的把握，我们会在大多数的章节中展示这幅图片。在这一章中，我们仍然会与标准配置的SIP代理部件打交道。
分析标准配置（Analyzing the Standard Configuration）
下面是OpenSER 1.2.2 版本的标准配置的展示。在这一节，我们将开始描述标准配置中的每一行的命令和函数。
#
# $Id: openser.cfg 1676 2007-02-21 13:16:34Z bogdan_iancu $
#
#simple quick-start config script
#Please refer to the Core CookBook at http://www.openser.org/dokuwiki/
doku.php
#for a explanation of possible statements, functions and parameters.
#
# ----------- global configuration parameters ------------------------
debug=3 # debug level (cmd line: -dddddddddd)
fork=yes
log_stderror=no # (cmd line: -E)
children=4
port=5060
#uncomment the following lines for TLS support
#disable_tls = 0
#listen = tls:your_IP:5061
#tls_verify_server = 1
#tls_verify_client = 1
#tls_require_client_certificate = 0
#tls_method = TLSv1
#tls_certificate = "//etc/openser/tls/user/user-cert.pem"
#tls_private_key = "//etc/openser/tls/user/user-privkey.pem"
#tls_ca_list = "//etc/openser/tls/user/user-calist.pem"
# ------------------ module loading ----------------------------------
#set module path
mpath="/lib/openser/modules/"
#Uncomment this if you want to use SQL database
#loadmodule "mysql.so"
loadmodule "sl.so"
loadmodule "tm.so"
loadmodule "rr.so"
loadmodule "maxfwd.so"
loadmodule "usrloc.so"
loadmodule "registrar.so"
loadmodule "textops.so"
loadmodule "mi_fifo.so"
# Uncomment this if you want digest authentication
# mysql.so must be loaded !
#loadmodule "auth.so"
#loadmodule "auth_db.so"
# ----------------- setting module-specific parameters ---------------
# -- mi_fifo params --
modparam("mi_fifo", "fifo_name", "/tmp/openser_fifo")
# -- usrloc params --
modparam("usrloc", "db_mode", 0)
# Uncomment this if you want to use SQL database
# for persistent storage and comment the previous line
#modparam("usrloc", "db_mode", 2)
# -- auth params --
# Uncomment if you are using auth module
#
#modparam("auth_db", "calculate_ha1", yes)
#
# If you set "calculate_ha1" parameter to yes (which true in this
config),
# uncomment also the following parameter)
#
#modparam("auth_db", "password_column", "password")
# -- rr params --
# add value to ;lr param to make some broken UAs happy
modparam("rr", "enable_full_lr", 1)
# ------------------------- request routing logic -------------------
# main routing logic
route{
# initial sanity checks -- messages with
# max_forwards==0, or excessively long requests
if (!mf_process_maxfwd_header("10")) {
sl_send_reply("483","Too Many Hops");
exit;
};
if (msg:len >= 2048 ) {
sl_send_reply("513", "Message too big");
exit;
};
# we record-route all messages -- to make sure that
# subsequent messages will go through our proxy; that's
# particularly good if upstream and downstream entities
# use different transport protocol
if (!method=="REGISTER")
record_route();
# subsequent messages withing a dialog should take the
# path determined by record-routing
if (loose_route()) {
# mark routing logic in request
append_hf("P-hint: rr-enforced\r\n");
route(1);
};
if (!uri==myself) {
# mark routing logic in request
append_hf("P-hint: outbound\r\n");
# if you have some interdomain connections via TLS
#if(uri=~"@tls_domain1.net") {
# t_relay("tls:domain1.net");
# exit;
#} else if(uri=~"@tls_domain2.net") {
# t_relay("tls:domain2.net");
# exit;
#}
route(1);
};
# if the request is for other domain use UsrLoc
# (in case, it does not work, use the following command
# with proper names and addresses in it)
if (uri==myself) {
if (method=="REGISTER") {
# Uncomment this if you want to use digest
authentication
#if (!www_authorize("openser.org",
"subscriber")) {
# www_challenge("openser.org", "0");
# exit;
#};
save("location");
exit;
};
lookup("aliases");
if (!uri==myself) {
append_hf("P-hint: outbound alias\r\n");
route(1);
};
# native SIP destinations are handled using our
USRLOC DB
if (!lookup("location")) {
sl_send_reply("404", "Not Found");
exit;
};
append_hf("P-hint: usrloc applied\r\n");
};
route(1);
}
route[1] {
# send it out now; use stateful forwarding as it works
# reliably even for UDP2TCP
if (!t_relay()) {
sl_reply_error();
};
exit;
}
这个标准的配置是最简单的可以使用的配置。我们将以它作为出发点，然后再在接下来的章节中循序渐进的包含新的命令和函数。使用这个配置，客户端能够进行注册（不需要认证）并且UACs能够互相之间进行沟通。注册服务器，定位服务器和代理服务器使用最小配置进行工作。下面我们将解释一些脚本中的引用。
debug=3 # debug level (cmd line: -dddddddddd)
设置日志级别（Set log level）：它是一个-3到4之间的一个数。默认为2。数越大，那么写道日志中的信息就越多。不过如果将其设为4，那么系统的性能可能会变得很差。日志级别是：
l L_ALERT（-3）——这个级别只被用来报告需要立即响应的错误。
l L_CRIT（-2）——这个级别只被用来报告造成危险状况的错误。
l L_ERR（-1）——这个级别用来报告数据处理过程中不会造成系统故障的错误。
l L_WARN（1）——这个级别用来写入一些警告消息。
l L_NOTICE（2）——这个级别用来报告不寻常的状况。
l L_INFO（3）——这个解别用来写入一些提示信息的消息。
l L_DBG（4）——这个级别用来写入用来调试的消息。
fork=yes
fork参数用来定义OpenSER进程是运行在前台还是后台。运行在后台则设置fork=yes。有时候你会发现如果在前台运行对于定位脚本错误是非常有用的。如果fork被禁用的话，OpenSER将不能够同时监听多个接口，TCP/TLS支持功能将被自动禁用。在单进程模式下，只有一个UDP接口被接受。
log_stderror=no # (cmd line: -E)
如果被设为yes，服务器将打印调试信息到标准错误输出。如果设为no,syslog会被使用。
Children=4
“children”核心参数告诉OpenSER每个创建处理接入请求的进程的接口有多少孩子进程。四个进程对于大多数系统来书都是很好的一个出发点。这个参数只适用于UDP接口，对于TCP没有影响。
Port=5060
如果在监听参数中没有被指明，那么这个参数就是默认使用的端口号。
mpath="/lib/openser/modules/"
设置模块搜索路径。这可以被用来简化模块的加载。
loadmodule "sl.so"
loadmodule "tm.so"
loadmodule "rr.so"
loadmodule "maxfwd.so"
loadmodule "usrloc.so"
loadmodule "registrar.so"
loadmodule "textops.so"
loadmodule "mi_fifo.so"
上面的这些行是OpenSER加载外部的模块。这个时候，只有需要的那些模块被加载了。其余附加的功能需要加载其他诸如RADIUS和MYSQL的模块。所有这些模块都有一个README文件来描述其功能。
modparam("mi_fifo", "fifo_name", "/tmp/openser_fifo")
创建FIFO文件及其名称用来监听和读取外部命令。
modparam("usrloc", "db_mode", 0)
modparam核心命令配置了相应的模块。上面的usrloc模块负责定位服务。当一个用户注册时，它用来保存定位信息，也就是我们知道的变量db_mode表明的相对于位置的AOR（Address of Record）。为0表示是内存。所以如果你关闭了服务器，那么你将丢失所有的注册记录。表的位置靠的就是db_mode变量。将db_mode设置为0表明这个数据将被保存到数据库中。换句话说，如果OpenSER关闭，所有记录丢失。
modparam("rr", "enable_full_lr", 1)
上面的语句设置rr（Record Routing）模块的enable_full_1r变量为1。它告诉OpenSER要支持那些不对record_route头域进行管理的SIP客户端。如果设为1，;lr=on将被使用而不是;lr。
Route {
这是SIP请求的路由逻辑的开始。“块（block）”起始于“{”。在这个块中，SIP请求将被处理。通过下面的语句你将看清大概：
# initial sanity checks -- messages with
# max_forwards==0, or excessively long requests
if (!mf_process_maxfwd_header("10")) {
sl_send_reply("483","Too Many Hops");
exit;
};
if (msg:len >= 2048 ) {
sl_send_reply("513", "Message too big");
exit;
};
当一个请求进入主路由块时，要进行一些检查。
首先检查的是前转（forward）的最大次数。为了避免回环（loop），我们使用mf_process_maxfwd_header()函数来检查包到底传递了多少SIP跳（SIP hops）。如果回环（loop）被发现，那么脚本则使用s1_send_reply()函数发送“483 too many hops”消息。
Msg:len是OpenSER核心用来返回SIP请求长度（单位byte）的函数。这是一个标准的用来检查消息大小限制方法。
if (!method=="REGISTER")
record_route();
如果不是REGISTER方法，OpenSER将进行record-route。这条消息告诉SIP服务器要处在两个UAC请求的路径当中。
record_route()函数只是简单的增加了一个新的record-route头域。
# Subsequent messages within a dialog should take the
# Path determined by record-routing
if (loose_route()) {
# mark routing logic in request
append_hf("P-hint: rr-enforced\r\n");
route(1);
};
loose_route()函数是用来试着看看请求有没有使用record-route头域进行路由的。这个函数标识的请求将使用最上面的record-route头域的内容进行路由。
如果请求是在同一个对话中，我们将进入if，并前转该包。我们只是简单的前转该请求。我们将调用次级路由块route(1)做这件事，在该块中t_relay()函数将被调用。
按照record-route头域(rr-enforced)，append_hf函数将添加一个表明请求被处理的提示。
if (!uri==myself) {
# mark routing logic in request
append_hf("P-hint: outbound\r\n");
# if you have some interdomain connections via TLS
#if(uri=~"@tls_domain1.net") {
# t_relay("tls:domain1.net");
# exit;
#} else if(uri=~"@tls_domain2.net") {
# t_relay("tls:domain2.net");
# exit;
#}
route(1);
};
上面的代码将处理一个我们的代理不处理的域中的请求，if(!uri==myself)，使用调用t_relay的route(1)来前转该请求。 默认的情况下，代理只是一个开放式的中继器。在下面的章节中我们将讨论怎样改进带外通话（outbound call）的处理过程。将请求前转至其他的代理是很重要的；然而，还应该进行一些合适的标识检查。现在，我们将处理指向被我们的SIP代理处理的域的请求。
if (uri==myself) {
if (method=="REGISTER") {
# Uncomment this if you want to use digest
authentication
#if (!www_authorize("openser.org",
"subscriber")) {
# www_challenge("openser.org", "0");
# exit;
#};
save("location");
exit;
};
如果是REGISTER请求，使用save(“location”)将AOR保存至位置表（location table）中。理解两个概念至关重要。验证被取消（www_authorize被注释掉）和因为我们没有把数据库安装在SIP代理上，所以定位数据库不是持续起作用的。
lookup("aliases");
if (!uri==myself) {
append_hf("P-hint: outbound alias\r\n");
route(1);
};
别名（alias）是可选的URI（比如，8590@voffice.com.br可以是原有URI flavio@voffice.com.br的别名）。lookup(“aliases”)函数寻找在请求中表示的URI的典型的URI。如果该URI被找到，则在操作进行前用其取代R－URI。最终的URI既可以被放置在我们域的里面，也可以是外面。如果在外面，那么系统只是简单的将包前转到负责该域的SIP代理上。如果在外面则开始请求的处理。
if (!lookup("location")) {
sl_send_reply("404", "Not Found");
exit;
};
append_hf("P-hint: usrloc applied\r\n");
lookup(“location”)函数将试着恢复R-URI的AOR。如果AOR被定位到（UA注册了）那么UA的ip地址将替代R－URI。如果没有找到，我们只是简单的发回错误消息“404 Not Found”。
route(1);
如果找到AOR我们将使用route(1)结束；
route[1] {
# send it out now; use stateful forwarding as it works
reliably
# even for UDP2TCP
if (!t_relay()) {
sl_reply_error();
};
exit;
}
最后，路由块被调用。t_relay()函数前转基于请求URI的有状态的请求。域部分将使用NAPTR，SRV和A records等来进行解析。这个函数是由TRANSACTION模块（tm.so）提供的，负责发送请求并处理重发和响应。如果请求不能被成功的被发送到目的地，错误信息将由t_relay()函数自动产生。如果错误产生，s1_reply_error()将发送响应信息给UA。
Using标准配置（Using the Standard Configuration）
在这个实验中，我们将使用协议分析机来抓取一个完整的SIP通话。我们将分析消息头和消息流程。你可以创建一个PC和带有两个UAC的实验环境。UAC可以是软电话，ATA，或是IP电话。
｜ 调整以满足你的实验需要。 ｜
｜ 1：使用ngrep开始抓取包。如果你没有安装ngrep, ｜
｜ 使用下面的命令安装： ｜
｜ apt-get install ngrep ｜
｜ 2：使用下面命令抓取包： ｜
｜ ngrep -p -q -W byline port 5060 > test.txt ｜
｜ 3：配置UAC（软电话，IP电话，或ATA）。 ｜
使用下面的描述来配置第一个UAC：
sip proxy 10.1.x.y – IP of your proxy
user: 1000
password: 1000
使用下面的描述来配置第二个UAC：
sip proxy 10.1.x.y – IP of your proxy
user: 1001
password: 1001
在完成配置后，你需要注册IP话机。不是所有的设备都会做自动注册的操作。
- 使用下面的命令检查电话是否注册上：
openserctl u1 show
- 用第一个UAC拨打1001。第二个UAC会振铃。
- 验证抓取的包没有相对于INVITE请求的“407- Proxy authentication required”错误和相对于REGISTER请求的“401- Unauthorize”错误。这证明了不需要验证。
- 你可以使用如下命令查看抓包：
more test.txt
420
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
