The provides Lawful Intercept (LI) support using one of two methods:- Using ERE with provisioning support from EMA (license required).
- Using centralized PSX with provisioning support from EMS (license required).
The
supports up to 500 simultaneous LI sessions. works in coordination with an Intercept Server (IS) to provide call data and call content to law enforcement agencies for calls involving identified intercept subjects. When it receives matching LI criteria in a policy response from ERE (or external PSX in centralized PSX solution), the routes the call as directed and additionally reports call events to the IS.The
also sends an RTP copy of the call's voice streams (call content) to an IP address provided by the IS. LI is configured by EMA (or EMS in centralized PSX solution). The target number is uploaded to LI table of ERE (or PSX, with the help of EMS). Info |
---|
|
You must use the default addressContext when configuring LI. |
Refer to Lawful Intercept page for an in-depth explanation of LI functionality.
Include Page |
---|
IP_IGs_ServedBySeperateProcessors | IP_IGs_ServedBySeperateProcessors |
LI Commands
Command Syntax
As user 'Calea', use the following command syntax to configure LI.
Code Block |
---|
|
% set addressContext <default> intercept
callDataChannel <callDataChannel>
nodeNumber <integer> |
Command Parameters
Caption |
---|
0 | Table |
---|
1 | Intercept Parameters |
---|
3 | Intercept Parameters |
---|
|
Parameter | Length/Range | Description |
---|
CallDataChannel
| 1-23 | The user-configurable LI Call Data Control Channel name. (See See the Call Data Channel Parameters table tables below for parameter details)details on the parameters within the CDC. | nodeNumber
| 0-9999999 | The unique global node number to assign to the which is used by the LI server for identification purposes. |
|
Call Data Channel Commands
High Level CDC Command Syntax
As the user 'Caleacalea', use the following CLI syntax to establish configure the LI call data channel configuration:
Code Block |
---|
% set addressContext |
Code Block |
---|
title | Call Data Channel High Level Syntax |
---|
|
% set addressContext <default> intercept callDataChannel <callDataChannel_name>
interceptStandard < etsi | packetcablediamNode | threeGpp>
ipInterfaceGroupName <ipInterfaceGroup_Name>
kaTimer <0-65535 seconds>
liPolDipForRegdOodMsgs <disabled | enabled>
mediaIpInterfaceGroupName <IP interface group name>
mediationServer <server name>
priIpAddress <IPv4 address>
priMode <active | outofservice | standby>
priPort <0-65535>
priState <disabled | enabled>
retries <value>
rtcpInterception<name>
diameterPeer <calea Diameter peer name>
diameterRealmRoute <calea realmRoute>
dsrProtocolVersion <0 | 1>
embedTapIdInCccId <enabled | disabled>
interceptStandard <etsi | packetcable | packetcablePlusEtsi | packetcableVTwo | threeGpp>
ipInterfaceGroupName <ipInterfaceGroup_Name>
kaTimer <0-65535 seconds>
liPolDipForRegdOodMsgs <disabled | enabled>
secIpAddress <IP_Address>mediaIpInterfaceGroupName <IP interface group name>
mediationServer <server name>
priIpAddress <IPv4 address>
secModepriMode <active | outofservice | standby>
secStatepriPort <disabled <0-65535>
priState <disabled | enabled>
retries <value>
rtcpInterception <disabled | enabled>
secIpAddress <IP_Address>
secMode <active | outofservice | standby>
secState <disabled | enabled>
vendorId <none | groupTwoThousand | ss8 | utimaco | verint> |
Call Data Channel (CDC
) Command Parameters
The following table describes the CDC parameters that determine the type of LI you are deploying. They must be configured for all types of LI.
Call Data Channel Parameters | 3 | Call Data Channel Parameters |
---|
CDC Parameters that Determine LI Type |
|
|
Parameter | Length/Range | Description |
---|
interceptStandard
|
|
N/A Intercept Standard intercept standard to use for this |
|
Call Data ChannelCDC. etsi packetcable (default)packetcablePlusEtsi
packetcableVTwo threeGpp
|
|
ipInterfaceGroupName
| 0-23 | <IPIG name>
– Name of the IP interface group used to stream to the vendorId
| The vendor name of the LI server. |
|
kaTimer
| 0-65535 | <# seconds>
= 5) – The keep-alive timer value, in seconds.liPolDipForRegdOodMsgs | N/A | Use this flag to control the sending of the policy dip to PSX for registered user's Out-Of-Dialog messages. disabled (default) – SBC does not send policy request to PSX for registered out-of-dialog requests (messages).enabled – SBC sends policy request to PSX for registered out-of-dialog requests for interception.
NOTE: This parameter is only visible when interceptStandard is not set to the default packetcable. |
mediaIpInterfaceGroupName | 1-23 characters | The name of the IP interface group that is used to stream media packets to the LI server. |
mediationServer | 0-23 | <name> – Name of the Mediation Server. Up to eight Mediation Servers are configurable for each CDC. See Mediation Server Configurations below for parameter details.
NOTE: The mediationServer parameter is only visible when interceptStandard and vendorId are configured for IMS LI (See table Configuration Options When Configuring SBC for Different LI Flavors). |
priIpAddress
| N/A | <IPv4 address> – The primary LI server's IPv4 address where Call Data Channel messages are sent. (default = 0.0.0.0)
|
priMode
| N/A | Mode of the primary server. Options are: active (default)outOfService standby
|
priPort
| 0-65535 | <port number> – The primary LI server's UDP port where Call Data Channel messages are sent. (default = 0)
|
- )
groupTwoThousand ss8 utimaco verint
|
|
Intercept Standards and Vendors for Different LI Types
The following table identifies the interceptStandard
and vendorId
configuration combinations the SBC supports for each type of LI.
Caption |
---|
0 | Table |
---|
1 | Intercept Standards and Vendors per LI Type |
---|
3 | Configuration Options When Configuring SBC for Different LI Flavors |
---|
|
CDC Configuration Settings | LI Type |
---|
interceptStandard | vendorId |
---|
packetcable/packetCablePlusEtsi | none/utimaco/verint | Legacy LI (default) | packetcable | ss8 | PCSI LI | threeGpp/etsi | none/utimaco/verint/groupTwoThousand | IMS LI | packetcableVTwo
| atos/none | PC 2.0 LI |
|
The following table lists the rest of the CDC parameters. Not all parameters apply to each type of LI; some parameters do not become available until you specify an interceptStandard
and vendorID
combination of an LI type to which they apply.
Caption |
---|
0 | Table |
---|
1 | CDC Parameters Per LI Type |
---|
3 | Call Data Channel Parameters |
---|
|
Parameter | Length/Range | Description | Applicable To |
---|
diamNode | up to 23 characters | <name> – Specifies the name assigned to the SBC Diameter node configuration. SBC configuration includes a single Diameter node to define the SBC side of the Diameter interface. If Diameter is used for more than one purpose on the SBC then the Diameter node is shared.
Note: Diameter node configuration must be completed on the SBC by a user with admin privileges. Then, the Diameter node name is entered in the CDC for a PC 2.0 LI deployment by the calea user using this parameter. | | diameterPeer | up to 23 characters | Diameter peer configuration under the CDC object, specifically for the mediation server (DF) side of the Diameter X2 signaling interface for PC 2.0 LI deployments. A maximum of 16 Diameter peers can be configured within the CDC. <calea Diameter peer name> – Specifies a unique name for this Diameter peer configuration (up to 23 characters). This name must not duplicate any name used for either LI or non-LI Diameter peers.
deviceWatchdogTimer – Specifies the Device-Watchdog-Requests timer value, in milliseconds (range: 0-100000 / default=1000).deviceWatchdogTimerAnswerTimeout – Specifies the Device Watchdog Answer timeout value, in milliseconds. The SBC considers a peer down if it does not receive a reply to a Device Watchdog Request before this timer expires. (range: 1000-500000 | default = 2000)dscpValue – Specifies the Differentiated Services Code Point (DSCP) value for intercepted signaling packets sent to this peer. (range: 0-63 / default = 16)fqdn – Specifies the FQDN for this peer (1-256 characters).ipAddress – Specifies the IP address for this peer.sessionDistribution – Specifies how to distribute Diameter sessions. Options are:honor-reply-order (default) – Diameter session creation across multiple IP connections under this peer honors the order of the IP addresses that are returned in the DNS reply starting from the first one.
round-robin – Diameter session creation across multiple IP connections under this peer are rotated in round-robin fashion starting from the first one.
state – Specifies the administrative state of this peer:disabled (default)enabled tcpPort – Specifies the TCP port number for this peer (default is 3868).
| | diameterRealmRoute | up to 23 characters | Diameter realm route configuration under the CDC object, specifically for the mediation server (DF) side of the Diameter X2 signaling interface for PC 2.0 LI deployments. A maximum of 16 Diameter realm routes can be configured within the CDC. <calea realmRoute name> – Specifies a unique name for the Diameter realm route for the specified Diameter peer (up to 23 characters). This name must not duplicate any name used for either LI or non-LI Diameter realm routes.
appId – Specifies the application ID (Diameter interface type) for this route.x2 – For PC 2.0 LI, the application ID must be set to X2.e2 rf rx
peer – Specifies the name of the Diameter peer this route belongs to.priority – Specifies the priority of this route. (range 0-100 / default = 0)realm – Specifies the realm (FQDN) for this route. This name must match the realm name for the mediation server that is associated with this route.state – Specifies the administrative state of this route.disabled (default)enabled
| | dsrProtocolVersion
| N/A | Signifies the intercepted X2 signaling protocol version towards the mediation servers. The default value 0 maintains backward compatibility with SBC Core 8.0 or earlier. | | embedTapIdInCccId | N/A | Specifies whether the SBC embeds the Tap ID in the CCCID (Call Content Connection Identifier) it sends with X2 and X3 messages to the DF. The Tap ID comes from X1 surveillance data. The options are: enabled – The SBC generates a CCCID with the Tap ID embedded if the Tap ID is a decimal value between 1 and 65534. If the Tap ID is null, it is converted to 0, but if it is out of range or not a decimal number, it is converted to 65535 or hex 0xFFFF.disabled – (default) Embedding of the Tap ID is not required.
| | ipInterfaceGroupName
| 0-23 | <IPIG name> – Specifies the name of the IP interface group to send X2 signaling data to the LI server.
| - Default LI
- IMS LI
- PC 2.0 LI
| kaTimer
| 0-65535 | <# seconds> (default = 5) – The keep-alive timer value, in seconds.
| | liPolDipForRegdOodMsgs | N/A | Specifies whether the SBC should send a policy request to the PSX, when the SBC receives a registered user's out-of-dialog messages, to determine whether interception is required. disabled (default) – The SBC does not send policy request to PSX for out-of-dialog messages.enabled – The SBC sends a policy request to PSX for out-of-dialog messages.
NOTE: This parameter is only visible when the interceptStandard is not set to packetcable. | | mediaIpInterfaceGroupName | 1-23 characters | Specifies the name of the IP interface group to send X3 call content to the mediation server (DF). | | mediationServer | 0-23 | <name> – Mediation server configuration to specify parameters for X2 and X3 destinations. Up to 16 mediation servers can be configured. See Mediation Server Configurations below for parameter details.
| | priIpAddress
| N/A | <IPv4 address> – The primary LI server's IPv4 address where Call Data Channel messages are sent. (default = 0.0.0.0)
| | priMode
| N/A | Mode of the primary server. Options are: active (default)outOfService standby
| | priPort
| 0-65535 | <port number> – The primary LI server's UDP port where Call Data Channel messages are sent. (default = 0)
| | pristate
| N/A | Use this flag to enable/disable communication to the primary LI server. enabled (default)disabled
| | retries
| N/A | Number of retries before the LI Call Data Channel is considered as failed. (default = 3) | | rtcpInterception
| N/A | Specifies whether to intercept RTCP information. Options are: disabled (default)enabled
| | secIpAddress
| N/A | Secondary LI server's IPv4 address where Call Data Channel messages are sent. (default = 0.0.0.0) | | secMode
| N/A | Mode of the secondary server. Options are: active outOfService (default) standby
| | secState
| N/A | Use this flag to enable/disable communication to secondary LI server. enabled (default)disabled
| |
|
Info |
---|
|
The SBC allows configuration of a maximum of 16 mediation servers in the Call Data Channel (CDC). Persistent TCP connections can be established towards all configured mediation servers. When a call is intercepted, the SBC selects among the Delivery Function 2 (DF2) servers in a round-robin manner. Mediation server objects contain signaling (X2) and media (X3) IP addresses. The SBC allows configuration of multiple mediation servers with the same X2 IP address but different X3 IP addresses. For IMS LI, the SBC does not support an active-standby configuration for the X2 servers. It assumes that the DF2 servers are running in active-active mode, and in case of failure, moves the IP address of the active DF2 server to the standby DF2 server. The X2 and X3 servers operate independently. Even if the X2 servers are not reachable, the SBC sends X3 media if a DF3 server is available, and vice versa. |
pristate
| N/A | Use this flag to enable/disable communication to the primary LI server. enabled (default)disabled
|
retries
| N/A | Number of retries before the LI Call Data Channel is considered as failed. (default = 3) |
rtcpInterception
| N/A | Enable this flag to intercept RTCP information for IMS LI. disabled (default)enabled
NOTE: The rtcpInterception parameter is only visible when interceptStandard and vendorId are configured as IMS LI (See table Configuration Options When Configuring SBC for Different LI Flavors). |
secIpAddress
| N/A | Secondary LI server's IPv4 address where Call Data Channel messages are sent. (default = 0.0.0.0) |
secMode
| N/A | Mode of the secondary server. Options are: active outOfService (default) standby
|
secState
| N/A | Use this flag to enable/disable communication to secondary LI server. enabled (default)disabled
|
vendorId
| N/A | The vendor name of the LI server. none (default)ss8 utimaco verint
|
Anchor |
---|
Mediation Server Configurations | Mediation Server Configurations | Mediation Server ConfigurationsMediation Server The
supports TCP to transport
mediation server media details.
Command Syntax
Code Block |
---|
% set addressContext <addressContext name> intercept callDataChannel <CDC name> mediationServer <mediationServer name> media tcp
dscpValue <0-63>
ipAddress <IPv4/IPv6 address>
kaInterval <5-60 seconds>
kaProbe <4-8 seconds>
kaTime <60-7200 seconds>
mode <inService | outOfService>
portNumber <0-65535>
state <disabled | enabled> |
Command Parameters
Caption |
---|
0 | Table |
---|
1 | Mediation Server: Media over TCP Parameters |
---|
3 | Media over TCP Parameters |
---|
|
Parameter | Length/Range | Descriptions |
---|
dscpValue | 0-63 | The DSCP value for intercepted media packets sent on TCP port. (Default = 16) | ipAddress | IPv4/IPv6 format | The IPv4/IPv6 Address of the mediation server for media interception over TCP. | kaInterval
| 5-60 | The duration between two successive keep alive retransmissions, if acknowledgement to the previous keep alive transmission is not received. (Default = 30 seconds) | kaProbe
| 4-8 | The number of retransmissions to be carried out before declaring that the remote end is not available. (Default = 4) | kaTime
| 60 to 7200 | The duration, in seconds, between the two keep alive transmissions in the idle condition. (Default = 180 seconds) | mode | N/A | The operational mode of the signaling/media connection towards the mediation server. inService outOfService (default)
| portNumber | 0-65535 | The TCP port number of the mediation server for media interception over TCP. (Default = 0) | state | N/A | The administrative state of the TCP connection towards the mediation server. disabled (default)enabled
|
|
The
supports UDP to transport
mediation server media details
. PC 2.
0 LI only supports UDP transport for media.Command Syntax
Code Block |
---|
% set addressContext <addressContext name> intercept callDataChannel <CDC name> mediationServer <mediationServer name> media udp
dscpValue <0-63>
ipAddress <IPv4/IPv6 address>
mode <inService | outOfService>
portNumber <0-65535>
state <disabled | enabled> |
Command Parameters
Caption |
---|
0 | Table |
---|
1 | Mediation Server: Media over UDP Parameters |
---|
3 | Media over UDP Parameters |
---|
|
Parameter | Length/Range | Descriptions |
---|
dscpValue | 0-63 | The DSCP value for intercepted media packets sent on UDP port. (Default = 16) | ipAddress | IPv4/IPv6 format | The IPv4/IPv6 Address of the mediation server for media interception over UDP. | mode | N/A | The operational mode of the signaling/media connection towards the mediation server.
inService outOfService (default)
| portNumber | 0-65535 | The UDP port number of the mediation server for media interception over UDP. (Default = 0) | state
| N/A | The administrative state of the UDP connection towards the mediation server. disabled (default)enabled
|
|
signaling interceptionCommand Syntax
Code Block |
---|
language | none |
---|
title | Mediation Server Syntax |
---|
|
% set addressContext <addressContext name> intercept callDataChannel <CDC name> mediationServer <mediationServer name> signaling
dscpValue <0-63>
ipAddress <IPv4/IPv6 address>
mode <inService | outOfService>
portNumber <0-65535>
protocolType <tcp | udp> <tcp | udp>
realmName <realm name>
state <disabled | enabled> |
Command Parameters
Caption |
---|
0 | Table |
---|
1 | Mediation Server: Signaling Parameters |
---|
3 | Signaling Parameters |
---|
|
Parameter | Descriptions |
---|
signaling
| Mediation server signaling interception settings. dscpValue – The DSCP value for intercepted signaling packets sent on this port. (range: 0-63 / default = 16)ipAddress – The IPv4/IPv6 Address of the mediation server for signaling interception.mode – The operational mode of the signaling/media connection towards the mediation server.
inService outOfService (default)
portNumber – The UDP/TCP port number of the mediation server for signaling interception. (range: 0-65536 / default = 0)protocolType – The protocol used by the mediation server for signaling interception (TCP/UDP).
state – The administrative state of the signaling/media connection towards the mediation server.
disabled (default)enabled
|
|
Info |
---|
|
The protocolType "udp " command is not supported for Signaling interception in this release. |
To retrieve the LI statistics, use the command:
Code Block |
---|
> show status addressContext <addressContext name> intercept |
Configuration Options When Configuring SBC for Different LI Flavors
The following table depicts the interceptStandard
and verndorId
configuration options to configure SBC for the the various LI flavors.
Caption |
---|
0 | Table |
---|
1 | Configuration Options When Configuring SBC for Different LI Flavors |
---|
3 | Configuration Options When Configuring SBC for Different LI Flavors |
---|
|
Configuration Settings | LI Flavor |
---|
interceptStandard | vendorId |
---|
packetcable | none/utimaco/verint | Legacy LI (default) | packetcable | ss8 | SS8 LI | threeGpp/etsi | none/utimaco/verint | IMS LI |
|
- )
protocolType – The protocol used by the mediation server for signaling interception (TCP/UDP).
realmName – The name of the realm to which this mediation server belongs. This name must match the realm name in the diameterRealmRoute configuration for the Diameter connection to be used to reach this mediation server. This option applies only to PC 2.0 LI deployments.state – The administrative state of the signaling/media connection towards the mediation server.
disabled (default)enabled
|
|
Info |
---|
|
The protocolType "udp " is not currently supported for signaling interception. |
To retrieve LI statistics, use the command:
Code Block |
---|
> show status addressContext <addressContext name> intercept |
Command Examples
To configure the name of the IP interface group used to use to stream to the LI server, use the commands:
Code Block |
---|
% set addressContext default intercept callDataChannel CDC ipInterfaceGroupName LIG1
% commit |
Info |
---|
|
The mediation server’s ipInterfaceGroup /mediaIpInterfaceGroup for CDC must be different from other signaling/media ipInterface groups to ensure . This ensures that LI does not doesn't use the signaling ipAddress to send intercepted traffic (media/signaling) towards the mediation server. |
To configure the intercept standard, use the commands:
Code Block |
---|
|
% set addressContext default intercept callDataChannel CDC interceptStandard etsi
% commit |
To configure the vendor ID, use the commands:
Code Block |
---|
|
% set addressContext default intercept callDataChannel CDC interceptStandard etsi vendorId verint
% commit |
To configure mediation server for media interception, use the commands:
Info |
---|
|
Mediation server’s ipInterfaceGroup
must be different from other signaling ipInterface
groups. This ensures that LI doesn't use signaling ipAddress
to send intercepted traffic (media/signaling) towards Mediation Server.intercept standard, vendor type, and mediation server name, use the commands:
Code Block |
---|
|
% set addressContext default intercept callDataChannel CDC interceptStandard etsi vendorId verint mediationServer ms1
% commit |
To configure mediation server for server parameters for media interception over TCP, use the commands:
Code Block |
---|
|
% set addressContext default intercept callDataChannel CDC mediationServer ms1 media tcp dscpValue 0 ipAddress 10.54.66.67 portNumber 7870
% commit
% set addressContext default intercept callDataChannel CDC mediationServer ms1 media tcp mode inService state enabled
% commit |
To configure mediation server for server parameters for media interception over UDP, use the commands:
Code Block |
---|
|
% set addressContext default intercept callDataChannel CDC mediationServer ms1 media udp dscpValue 0 ipAddress 10.54.66.57 portNumber 7881
% commit
% set addressContext default intercept callDataChannel CDC mediationServer ms1 media udp mode inService state enabled
% commit |
To configure mediation server for server parameters for signaling interception, use the commands:
Code Block |
---|
|
% set addressContext default intercept callDataChannel CDC mediationServer ms1 signaling dscpValue 0 ipAddress 10.54.64.80 portNumber 7880 protocolType tcp
% commit
% set addressContext default intercept callDataChannel CDC mediationServer ms1 signaling mode inService state enabled
% commit |
To configure enable RTCP interception, use the commands:
Code Block |
---|
|
% set addressContext default intercept callDataChannel CDC rtcpInterception enabled
% commit |
To enable the enable sending of the a policy dip to the PSX for registered userusers' s Outout-Ofof-Dialog dialog messages, use the commands:
Code Block |
---|
% set addressContext default intercept callDataChannel CDC liPolDipForRegdOodMsgs enabled
% commit |