Automated Signal Processing Rules

Specifying Signal Rules Rule Conditions Rule Actions CPL Scripts CG/PL Programs Logging Rules Activity The CommuniGate Pro Server can automatically process Signals using sets of Automated Rules. Only the Signal Request sent outside already established Dialogs are subject to Rules. The Server-Wide and Cluster-wide Rules are applied to all Signals sent to the Server and to the Cluster. When a Signal is directed to a CommuniGate Pro Server Account, the Account-level Rules are applied. The Account-level Rules are the Rules specified for the particular Account along with the Rules specified for the Account Domain.

Specifying Signal Rules

System administrators can specify Server-Wide and Cluster-wide Signal Rules. Open the RealTime pages in the Settings section of the WebAdmin Interface and click the Rules link.

See the Automated Rules section to learn how to set the Rules.

Rule Conditions

Each Rule can use universal conditions specified in the Rules section.
Additionally, the following Rule conditions can be used in Signal processing Rules:

Method        [is | is not | in | not in]  string

This condition checks if the Request Method address is (or is not) equal to the specified string.

Sample:

Method is

This condition will be met for all INVITE Requests.

From  [is | is not | in | not in]  string

This condition checks if the Request From address is (or is not) equal to the specified string.

Sample:

From is

This condition will be met for all signals coming from any account on any of stalker.com subdomains.

To        [is | is not | in | not in]  string

The same as above, but the Request To address is checked.

'From' Name  [is | is not | in | not in]  string

The same as above, but the instead of the address, the "address comment" (the real name) included in the From address is checked.

Sample:

'From' Name is

This condition will be met for Requests with the following From: addresses:

From: <sip:jsmith@company.com> (John J. Smith)

From: "Bill J. Smith" <sip:b.smith@othercompany.com>

From: Susan J. Smith <sips:susan@thirdcompany.com>

Authenticated  [is | is not | in | not in]  string

This condition checks the Request authentication. If the Request has been authenticated by this CommuniGate Pro Server, the authenticated Account name (account@domain) is compared with the specified string.

Sample:

Authenticated is

This condition will be met for all signals coming from any account on any of stalker.com subdomains.

Under Construction

Rule Actions

Each Rule can have zero, one, or several actions. If a Request meets all the Rule conditions, the Rule actions are performed.

You can use all universal actions described in the Rules section. This section describes the Rule actions that can be used in Signal Rules:

Stop Processing

See the Rules section. The Signal is sent to its current target set.

Redirect to addresses

The Signal is redirected to one or several specified addresses: the current Signal "destination set" is cleared, and the specified addresses form the new "destination set".
Each address should be specified as a sip:, sips:, or tel: URI. If several addresses are specified, they should be separated with the comma (,) sign.

Sample:

Method is Authenticated is not

Redirect to sip:adManager@domain.com

This Rule will direct all INVITE Signals to the adManager@domain.com address, unless the Signal authenticated source is adManager@domain.com.
You can use this Rule to implement an advertizing server: the adManager@domain.com Account can start a PBX application that will play some media to the caller, and then, acting as a B2BUA, will connect the caller with the original destination. The calls made by that application will have adManager@domain.com as their autenticated source, so this Rule will not redirect them.

Fork to addresses

Same as Redirect to, but the specified addresses are added to the current "destination set" without clearing it first.

Under Construction

CPL Scripts

You can create and use CPL scripts to control Signal Processing. Under Construction

CG/PL Programs

You can create and use CG/PL programs to control Signal Processing. Under Construction

Logging Rules Activity

The Signal component records Server-Wide Rules activity in the Log. Set the Signal Log Level to Low-Level or All Info to see the Rules checked and the actions executed.