Flexisip : B2BUA (Back-to-back User Agent)

tk-fuse · 2024 年 9 月 3 日午前 8:51

Flexisip : SIPネットワークと電話網との相互接続について

https://linphone.org/news/flexisip-allows-interconnection-pstn-networks

ubuntu-flexisipコンテナ内でデバックモードで起動

$ docker compose -p project exec ubuntu-flexisip bash
# bin/flexisip --server b2bua --debug

[b2bua-server]のapplicationでsip-bridgeを指定（デフォルトはtrenscrypter）し、関連セクションを設定。[b2bua-server::sip-bridge], [module::B2bua]

flexisip.conf

##
## Flexisip back-to-back user agent server parameters.
##
[b2bua-server]

# The type of application that will handle calls bridged through
# the B2BUA. Possible values:
# - `trenscrypter` Bridge different encryption types on both ends
# transparently.
# - `sip-bridge` Bridge calls through an external SIP provider.
# (e.g. for PSTN gateways)
# Default: trenscrypter
application=sip-bridge

# SIP uri on which the back-to-back user agent server is listening
# on.
# Default: sip:127.0.0.1:6067;transport=tcp
#transport=sip:127.0.0.1:6067;transport=tcp

# Directory where to store b2bua core local files
# Default
# Default: /var/opt/belledonne-communications/flexisip/b2b
#data-directory=/var/opt/belledonne-communications/flexisip/b2b

# The Flexisip proxy URI to which the B2bua server should send all
# its outgoing SIP requests.
# Default: sip:127.0.0.1:5060;transport=tcp
#outbound-proxy=sip:127.0.0.1:5060;transport=tcp

##
## External SIP Provider Bridge parameters.
##
[b2bua-server::sip-bridge]

# Path to a file containing the accounts to use for external SIP
# bridging, organised by provider, in JSON format.
# Here is a template of what should be in this file:
# [{"name": "<user-friendly provider name for CLI output>",
#   "pattern": "<regexp to match callee address>",
#   "outboundProxy": "<sip:some.provider.example.com;transport=tls>",
#   "registrationRequired": true,
#   "maxCallsPerLine": 42,
#   "accounts": [{
#     "uri": "sip:[email protected]",
#     "userid": "<optional (e.g. an API key)>",
#     "password": "<password or API token>"
#   }]
# }]
# Default: example-path.json
providers=providers=/path/to/your/providers-file.json

##
## This module is in charge of intercepting calls and route them
## to the back-to-back user agent server
##
[module::B2bua]

# Indicate whether the module is activated.
# Default: false
enabled=true

# A request/response enters module if the boolean filter evaluates
# to true. Ex: from.uri.domain contains 'sip.linphone.org', from.uri.domain
# in 'a.org b.org c.org', (to.uri.domain in 'a.org b.org c.org')
# && (user-agent == 'Linphone v2'). You can consult the full filter
# documentation here : https://wiki.linphone.org/xwiki/wiki/public/view/Flexisip/Configuration/Filter%20syntax/
# Default: 
#filter=

# A sip uri where to send all the relevent requests.
# Default: sip:127.0.0.1:6067;transport=tcp
#b2bua-server=sip:127.0.0.1:6067;transport=tcp

Transcrypterモード

メディア（RTP）暗号化の方式が異なるSIPクライアント同士の通信を中継・変換

たとえば、以下のような異なる暗号方式を使う SIP クライアント間で通話を成立させたいときに使います：

発信者（leg A）：DTLS-SRTP
受信者（leg B）：SDES-SRTP

このとき、Flexisipが間に立って、異なる暗号化方式を変換しながらRTPを中継

Leg A：発信側（コールを発信した側のクライアント）
Leg B：着信側（コールを受け取る側のクライアント）
Transcrypter：Leg A ↔ Leg B間でRTP暗号化方式の変換を行う中継機能

Leg Aの暗号化方式

Flexisip（B2BUA）は、発信者（Leg A）からの接続に対して、以下の暗号化方式を受入：

暗号なし（unencrypted RTP）
SDES-SRTP
DTLS-SRTP
ZRTP

発信側がどの方式を使ってきても、B2BUAは受け入れて通話を確立。

Leg Bの暗号化方式の選択方法

通話のもう一方（Leg B）の暗号化方式は、次のようにしてFlexisipが選択：

1. 受信者のSIP URI（またはGRUU）に基づく

sip:[email protected] などの宛先アドレスや、GRUU（Globally Routable User URI）に基づいて、b2bua-server::trenscrypter セクションに定義されたルールにマッチさせて、受信者に使う暗号化方式を決定。

2. SDES（SDP Security Descriptions）方式の場合

さらに細かく、使用する SRTP crypto suite（例：AES_CM_128_HMAC_SHA1_80）に基づいて、適切な暗号設定を行うことが可能。

flexisip.confの設定については、下記のセクションを調整（IPv6のみで対応する場合）

注） 44000ユーザのみに適用するフィルタを設定。
ネットワークをIPv6限定にしたため、STUNサーバとMediaRelayは無効とした。

[global] ---> transports=sip:127.0.0.1:5060;transport=tcp sip:sip.example.com:5060;transport=tcp sips:sip.example.com:5061
[global] ---> rtp-bind-address=0.0.0.0 PUBLIC_IPV6＿ADDRESS
[stun-server] ---> false
[conference-server] ---> nat-addresses=sip.example.com
[b2bua-server] ---> application=trenscrypter 
[b2bua-server::trenscrypter] ---> outgoing-enc-regex=none .*@sip\.example\.com(;.*)?
[module::NatHelper] ---> ??? should be checked!
[module::B2bua] ---> filter=(to.uri.user contains '44000') || (from.uri.user contains '44000')
[module::Router] ---> ???
[module::MediaRelay] ---> enabled=false