jambonz/sbc-inbound

sbc-inbound

镜像概述

sbc-inbound是jambonz平台会话边界控制器(SBC)功能的组成部分，主要用于处理入站SIP流量。它接收来自运营商SIP中继、SIP设备及WebRTC应用的INVITE请求，对已知运营商的流量直接允许接入，对SIP设备的请求进行认证挑战，并将通过验证的流量转发至私有子网中的jambonz应用服务器，实现安全可控的入站呼叫接入管理。

核心功能和特性

• 入站流量处理：接收并处理来自运营商SIP中继、SIP设备及WebRTC应用的SIP INVITE请求。
• 流量准入控制：自动允许已知运营商的SIP INVITE请求进入系统。
• 设备认证挑战：对来自SIP设备的INVITE请求发起认证挑战，验证设备合法性。
• 安全流量转发：将通过验证的SIP流量转发至私有子网中的jambonz应用服务器。
• 配置灵活性：支持通过环境变量进行详细配置，适配不同部署环境需求。

使用场景

适用于jambonz VoIP平台的入站呼叫接入场景，特别是需要对入站SIP流量进行安全控制、运营商流量与设备流量区分管理的场景，如企业IP PBX系统、云通信平台的入站呼叫边界防护等。

配置说明

环境变量配置

通过以下环境变量进行配置，具体说明如下：

关键配置项示例

drachtio服务器配置

json
{
  "drachtio": {
    "port": 3001,
    "secret": "cymru"
  }
}

drachtio对象指定用于接收来自drachtio服务器TCP连接的监听端口，以及用于服务器认证的共享密钥。

注意：根据提供的配置，可以使用入站连接或出站连接。在生产环境中，为便于应用逻辑的集中化和集群化，建议使用出站连接；入站连接通常用于自动化测试套件。

rtpengine配置

json
{
  "rtpengine": {
    "host": "127.0.0.1",
    "port": 22222
  }
}

rtpengine对象指定rtpengine的位置，通常与drachtio运行在同一服务器上。

应用日志级别

json
{
  "logging": {
    "level": "info"
  }
}

配置应用日志级别，可选'info'（默认）或'debug'。

应用服务器路由配置

内部应用服务器的SIP中继路由通过IP地址数组指定：

json
{
  "trunks": {
    "appserver": ["sip:10.10.120.1"]
  }
}

转码选项

rtpengine的转码选项在配置文件中定义，通常无需修改：

json
{
  "transcoding": {
    "rtpCharacteristics": {
      "transport protocol": "RTP/AVP",
      "DTLS": "off",
      "SDES": "off",
      "ICE": "remove",
      "rtcp-mux": ["demux"]
    },
    "srtpCharacteristics": {
      "transport-protocol": "UDP/TLS/RTP/SAVPF",
      "ICE": "force",
      "SDES": "off",
      "flags": ["generate mid", "SDES-no"],
      "rtcp-mux": ["require"]
    }
  }
}

认证机制

用户认证由客户端通过暴露HTTP回调实现。系统会向配置的回调地址（即REGISTER请求中关联SIP域对应的accounts.registration_hook列的值）发送POST请求，请求体为包含以下信息的JSON payload：

json
{
  "method": "REGISTER",
  "expires": 3600,
  "scheme": "digest",
  "username": "john",
  "realm": "jambonz.org",
  "nonce": "157590482938000",
  "uri": "sip:172.37.0.10:5060",
  "response": "be641cf7951ff23ab04c57907d59f37d",
  "qop": "auth",
  "nc": "00000001",
  "cnonce": "6b8b4567",
  "algorithm": "MD5"
}

客户侧逻辑需检索给定用户名的关联密码，然后按照https://tools.ietf.org/html/rfc2617#section-3.2.2%E6%8F%8F%E8%BF%B0%E7%9A%84%E7%AE%97%E6%B3%95%E8%AE%A1%E7%AE%97%E5%93%8D%E5%BA%94%E5%93%88%E5%B8%8C%E5%80%BC%EF%BC%8C%E5%B9%B6%E4%B8%8EHTTP%E8%AF%B7%E6%B1%82%E4%BD%93%E4%B8%AD%E7%9A%84%60response%60%E5%B1%9E%E6%80%A7%E8%BF%9B%E8%A1%8C%E6%AF%94%E8%BE%83%EF%BC%8C%E5%AE%8C%E6%88%90%E8%AE%A4%E8%AF%81%E3%80%82

示例代码可参考https://github.com/jambonz/customer-auth-server/blob/master/lib/utils.js%EF%BC%8C%E5%AE%8C%E6%95%B4%E7%A4%BA%E4%BE%8B%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%8F%AF%E5%8F%82%E8%80%83https://github.com/jambonz/customer-auth-server%E3%80%82

客户服务器应始终返回200 OK响应，响应体为JSON格式，包含status字段，值为ok（认证成功）或fail（认证失败）：

json
{"status": "ok"}

失败时可额外包含msg字段，描述失败原因：

json
{"status": "fail", "msg": "invalid username"}

转发行为

本应用作为背靠背用户代理（B2BUA）和媒体代理，将INVITE请求转发至jambonz应用服务器时，会添加以下头信息：

• X-Forwarded-For：发送INVITE的客户端IP地址
• X-Forwarded-Carrier：入站运营商名称（如适用）

测试套件运行

运行内置测试套件需在本地/服务器安装MySQL，运行前需设置MYSQL_ROOT_PASSWORD环境变量指定MySQL root密码。测试套件会在MySQL中创建名为jambones_test的数据库用于测试，测试完成后自动删除。

bash
MYSQL_ROOT_PASSWORD=foobar npm test