Call Routing Based on Active Directory User Attributes

In this article, we illustrate how to configure the

Call Routing Logic Overview

In this example, a call arrives from PSTN on a TDM port associated with an ISDN Signaling Group (SG), the SG points to a Call Routing Table which in turn specifies a Transformation Table.

The Transformation Table contains two entries, the first transformation strips the last four digits from the Called Number and appends them to a string tel:+1510774 for which the first part constitutes of a valid AD msRTCSIP-Line Active Directory user attribute entry. The second entry takes an msRTCSIP-Line entry and outputs the corresponding mobile phone number to the Destination Signaling Group.

For the purpose of this example the parties to the call and their relevant attributes are:

• Calling Party: PSTN phone 6228
• Called Party: Lync client with following AD profile:
  • userPrincipalName: baris@SBCDEMO.Ribbon
  • homePhone: 3633
  • mobile: 6223
  • msRTCSIP-Line: tel:+15105743633;ext=3633
  • mail: Baris@uxdemo.net

Active Directory Related Setup

AD Query User

In order to perform a successful query of either the AD cache or to query AD directly, a valid domain user must be specified in the Active Directory Configuration panel (see AD config section below, User Name field).

The AD query user must be a domain user. For this exercise, the following user is created in SBCDEMO.Ribbon domain where Lync is deployed.

• userPrincipalName: queryUser@SBCDEMO.Ribbon
• dn: CN=queryUser,OU=Lync Clients,DC=SBCDEMO,DC=Ribbon

Verification of Active Directory License

Active Directory based call routing can only be preformed with an AD feature license - ensure you have this license installed:

1. In the WebUI, click the Settings tab.
2. In the left navigation pane, go to System > Licensing > Current Licenses.

3. Verify that the Active Directory feature is licensed as shown below.

   Verify Active Directory License

    

Domain Controller Settings

1. In the WebUI, click the Settings tab.
2. In the left navigation pane, go to Active Directory > Domain Controllers.
3. Add a domain controller.

   1. Configure the domain controller configuration items as shown below.

      Domain Controller Settings

      

Active Directory Configuration

1. In the WebUI, click the Settings tab.
2. In the left navigation pane, go to Active Directory > Configuration.
3. Configure the relevant settings as shown below:

Active Directory Configuration

AD Query Functionality Verification

1. In the WebUI, click the Diagnostics tab.
2. In the left navigation pane, go to Tools > Query AD Cache.
   In the Active Directory Cache Query page:
3. Select userPrincipalName from the Property to Match list box.
4. Enter the Lync user's userPrincipalName (i.e:James Smith) in the Value to Match field.
5. Click OK.

The query should return results similar to those shown below.

AD Query Functionality Verification

 

Telephony Routing Setup

Transformation Table Configuration

1. In the WebUI, click the Settings tab.
2. In the left navigation pane, go to Transformation.

3. Add an entry to the Transformation Table.

   Transformation Table Entry

   

    

4. In the left navigation pane, select the Transformation Table created in the previous step.

5. Add two entries as shown below.

   Add Two Entries

   

   AD-based Routing via Transformation Table

   

AD Wild Cards

SBC supports the use of wild cards. This means that you can do partial matching in AD fields. The following is an example of how the =telephoneNumber= field is used to forward an inbound call to the user's new extension.

=telephoneNumber= Field

Scenario
Someone dials extension 3633, the four digits are added to the Area Code and prefix as well as the wildcard character, the result (User Value 1) is used in an AD query against the =telephoneNumber= field. The contents of the first =telephoneNumber= field containing the match string is then parsed for the last four digits, which are output from the transformation.

Call Routing Table

1. In the WebUI, click the Settings tab.
2. In the left navigation pane, go to Call Routing Table > (relevant entry).

3. Select the appropriate Transformation Table in the Number/Name Transformation Table list box as shown below.

   Call Routing Table

   

Verification of Call Routing using AD attributes

In order to properly verify the SBC configuration, please follow these steps:

1. A PBX phone (6228) dials the Lync user's number (3633).
2. The call lands on the ISDN inbound Signaling Group on the SBC.
3. The call is then sent to the relevant Call Route Table Entry.
4. In the Call Route Entry, the incoming number is first transformed using the relevant call route entry (using the cached Active Directory user attributes) and is then routed to the relevant outbound Signaling Group.

You can see the AD usage in action via the WebUI log as shown below:

AD Usage