registrar和mid_registrar模块介绍

使用场景

registrar和mid_registrar都是用来存储用户注册信息的模块，mid_registrar主要是充当注册中间件，需要代理转发, 另外也可以降低被代理方的注册请求的次数。registrar模块也支持代理转发，但是不能拦截注册请求到被代理方。

两个模块的数据都缓存在usrloc里。

使用示例

opensips版本:

opensips 3.3.10 (x86_64/linux)

registrar

重要参数介绍

default_expires: 默认注册过期时间,单位秒
min_expires: 最小注册过期时间,Contact中的过期时间小于此值，会被设置为此值,单位秒
max_expires: 最大注册过期时间,Contact中的过期时间大于此值，会被设置为此值,单位秒
tcp_presentent_flag: 此参数会设置tcp连接的生命周期为contact的过期时间，如果设置为-1，则不设置。
received_avp: 存储received字段的avp，常常和nathelper模块一起使用.
recevied_param: 设置200OK信令的Contact中的received字段,默认为received
max_contacts: 限制每个用户最大注册数的contact,超过会报错5xx。

代理配置示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41


socket=udp:172.16.4.111:5360
socket=tcp:172.16.4.111:5360
socket=udp:172.16.4.111:5361

loadmodule "usrloc.so"
loadmodule "registrar.so"
loadmodule "nathelper.so"
modparam("registrar|nathelper", "received_avp", "$avp(rcv)")
modparam("registrar", "default_expires", 1800)
modparam("registrar", "tcp_persistent_flag", "TCP_PERSIST_DURATION")

route {
    ...
    if (is_method("REGISTER")) {
        # indicate that the client supports DTLS
        # so we know when he is called
        if (isflagset("SRC_WS"))
                setbflag("DST_WS"); 
        fix_nated_register();
        if (!save("location","rfc1"))
                sl_reply_error();
        if ($socket_in(proto) == "tcp") {
                setflag("TCP_PERSIST_DURATION");
                xlog("L_DBG","[$cfg_line][$ci]---main-1-:$rm|$tu|$socket_in(port)|$socket_in(proto)\n");
        }
        $socket_out = "udp:172.16.4.111:5361";
        sethostport("172.16.4.114:5060");
        if (!t_relay()) {
                send_reply(500, "Internal Error");
        }
        exit;
    }

    if (!lookup("location","m")) {
        t_newtran();
        t_reply(404, "Not Found");
        exit;
    }

    route(relay);
}

坐席的信令图： register

save("location","rfc1"): rfc1 表示usrloc一个用户只保存一个Contact信息,这样在webrtc连接中，及时更新往新的连接发送请求地址。

如果opensips中坐席过期时间小于被代理方，opensips过期之后不会重新往被代理方发送注册请求。

mid_registrar

代理配置示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45


socket=udp:172.16.4.111:5326
socket=udp:172.16.4.111:5360
socket=tcp:172.16.4.111:5360
socket=udp:172.16.4.111:5361

loadmodule "mid_registrar.so"
modparam("mid_registrar", "mode", 0)
modparam("mid_registrar|nathelper", "received_avp", "$avp(rcv)")
modparam("mid_registrar", "outgoing_expires", 80)
modparam("mid_registrar", "tcp_persistent_flag", "TCP_PERSIST_REGISTRATIONS")
modparam("mid_registrar", "max_expires", 130)
modparam("mid_registrar", "attr_avp", "$avp(attr)")

route {
    ...
    if (is_method("REGISTER")) {

        # indicate that the client supports DTLS
        # so we know when he is called
        if (isflagset("SRC_WS"))
            setbflag("DST_WS"); 
        #fix_nated_register();
        mid_registrar_save("location");
        switch ($retcode) {
        case 1:
            if ($socket_in(proto) == "tcp") {
                setflag("TCP_PERSIST_REGISTRATIONS");
                xlog("L_DBG","[$cfg_line][$ci]---main-1-:$rm|$tu|$socket_in(port)|$socket_in(proto)\n");
            }
            $socket_out = "udp:172.16.4.111:5361";
            $ru = "sip:172.16.4.114:5060";
            if (!t_relay()) {
                send_reply(500, "Internal Error");
            }
            break;
        case 2:
                xlog("L_INFO", "REGISTER has been absorbed!\n");
                break;  
        default:
                xlog("L_ERR", "mid-registrar error!\n");
                send_reply(500, "Server Internal Error 2");
        }
        exit;
    }
}

mode = 0

当outgoing_expires大于max_expires时： register

能够得出的结论为：

软电话的Expires:200, opensips的过期时间为:130,此时发送给114的Expires为200. 114保存的过期时间为200, 而opensips保存的过期时间为130，返回给软电话的过期时间为130.
软电话130s过期之后，会重新发送Register，此时opensips会转发请求给114机器。

当outgoing_expires小于max_expires时： register