...
...
...
...
...
- This document details how to configure the SBC for Active Directory-based call routing.
- This document explains how the SBC handles AD caching and repetative AD lookups.
...
Prerequisites
Tip |
---|
Requires Sonus SBC1000/2000 Version 2.2 or later |
Tip |
---|
This document assumes the user has a working knowledge of the SBC and its WebUI. |
Tip |
---|
This document assumes the user has a working knowledge of Microsoft's Active Directory |
Summary
Overview
Below is the call diagram example used as a configuration reference for the remainder of this document.
Panel |
---|
|
Caption |
---|
0 | Figure |
---|
1 | Call Diagram Example |
---|
| Image Modified |
|
Caption |
---|
0 | Table |
---|
1 | Configuration Steps |
---|
|
...
|
Step | Action |
---|
1 | PSTN call arrives at SBC. SBC processes corresponding SG, Call Route & Transformation Table | | Call Route/Transformation Table queries the AD cache. The called number is checked against all msRTCSIP-Line records per the Input portion of the transformation entry. | 2 | James' msRTCSIP-Line entry matches the called number, +15105743501. James' mobile number is returned from the AD cache. A call is placed to James' mobile, +14085551212. | | All of James' AD records are recorded into a record set. This record set is used for all subsequent AD queries for this call. | 3a | In forking the call to Lync, the next Call Route entry/Transformation Table is executed. The record set (not the AD cache) is searched to see if the called number matches the msRTCSIP-Line. This type of check is performed simply to ascertain if the called number belongs to a Lync user. If it matches, the same number that was searched is returned and the call request is forwarded to the Lync Server. | 3b | The Lync Server processes the INVITE, sending it out to James' Lync client |
|
...
Prerequisites
Before beginning the AD configuration, investigate and answer the following:
- The FQDN/IP of the Domain Controller
- What AD attribute will be used as key to retrieve records? msRTCSIP-Line, name, or mail are common AD attribute to set as the LDAP search criteria.
- What area of the Active Directory should be searched?
...
Panel |
---|
|
Caption |
---|
| Image Removed |
|
...
...
Panel |
---|
|
Caption |
---|
| Image Removed |
|
...
...
SBC Active Directory Reference
The following diagrams depict the SBC's Active Directory settings for:
- Configuring a Domain Controller
- Setting the Configuration parameters the SBC will use to interoperate with the domain controller
Panel |
---|
|
Caption |
---|
0 | Figure |
---|
1 | Global Configuration for SBC-to-DC Interactions |
---|
| Image Removed |
|
...
Image Removed
SBC AD Configuration
The SBC must be configured for:
- Active Directory Integration
- Forked Calling
- AD-based Call Routing
Active Directory Integration for Call Routing
...
Click the Settings tab in the top nagivation, then select Domain Controllersin the left-hand navigation
Panel |
---|
|
Caption |
---|
0 | Figure |
---|
1 | Domain Controllers |
---|
| Image Removed |
|
- Access Settings and select Auth and Directory Services > Active Directory > Domain Controllers.
- Enter the AD information for your network
...
Panel |
---|
|
Caption |
---|
0 | Figure |
---|
1 | Enter AD Information |
---|
| Image Removed |
|
...
Click Configurationin the left-hand navigation.
Panel |
---|
|
Caption |
---|
| Image Removed |
|
- .
- Select Auth and Directory Services > Active Directory > Configuration.
Configure the Active Directory Configuration
...
:
Tip |
---|
The minimum configuration for this example document should include the attributes: msRTCSIP-Line, name, displayName, mail, telephoneNumber |
Panel |
---|
|
Caption |
---|
0 | Figure |
---|
1 | Active Directory Configuration |
---|
|
|
...
Image Added |
|
Active Directory Verification
- With the AD configuration completed, click Refresh Cache.
...
...
...
Image Removed
- Click Display Statistics and verify that the AD queries are succeeding.
...
...
0 | Figure |
---|
1 | Display Statistics |
---|
...
- In the Domain Controller configuration,
...
Panel |
---|
|
Caption |
---|
0 | Figure |
---|
1 | Domain Controllers Table |
---|
| Image Removed |
|
Panel |
---|
|
Caption |
---|
0 | Figure |
---|
1 | Domain Controller Status |
---|
| Image Removed |
|
...
Panel |
---|
|
Caption |
---|
0 | Figure |
---|
1 | Active Directory Cache Query |
---|
| Image Removed |
|
- ensure Status is Up.
Click the Tasks tab and click Active Directory Cache Query. In the form, pick an AD attribute from the pulldown and supply a corresponding value.
...
Note |
---|
Queries of the msRTCSIP-Line must match precisely what appears in the Lync Line URI for the desired user, unless Normalized Cache is configured to True. If the cache is normalized, the tel: will be removed from the Lync User Line URI. |
SBC AD-based Call Routing
Use the following instructions to create Call Routes and Transformation Tables that perform the call routing noted detail in the Summary section diagram.
...
...
- Transformation table with an entry to search for a msRTCSIP-Line entry that matches the called number and returns the mobile number.
...
...
...
Image Removed
...
- Create a new call route table, then a call route entry to the table.
...
Panel |
---|
|
Caption |
---|
0 | Figure |
---|
1 | Create Call Route Table |
---|
| Image Removed |
|
...
- Create a second transformation table with an entry to search for a msRTCSIP-Line entry that matches the called number.
...
...
0 | Figure |
---|
1 | Create Transformation Table |
---|
...
...
...
...
theCall Route table to send the call to the Lync Server. As before, add the transformation table above to the call route below.
...
...
Caption |
---|
|
Image Removed |
5. Your call route table should look like this:
Panel |
---|
|
Caption |
---|
| Image Removed |
|
...
...
|
---|
- It is often necessary to change (normalize) a number before performing an AD lookup. The vast majority of lookups require just the addition of +countrycode (i.e. +1 for the US) for a number that is already 10 digits (areacode+number).
- The Lync Line URI (msRTCSIP-Line) is different as it is always prepended with tel: and often postpended with ;ext=number. Since AD searches must be exact matches, the number must be corrected before the search.
|
...
- The following are some common normalization transformations.
|
...
...
...
- to True, the tel: will automatically be removed from msRTCSIP-Line before the SBC caches the number.
|
...
...
Note |
---|
If your Operating Mode is configured to Online, normalization should always include tel: as Normalize Cache is not available in Online mode. Online mode is not recommended. |
If you are planning to employ AD lookups for Lync Line URI(msRTCSIP-Line), the searches will likely require additional number translations. See below for a few common number normalizations for msRTCSIP-Line AD lookups:
...
If your Lync Line URI: looks like this:
...
Caption |
---|
|
Image Modified |
These are two common normalizations:
...
Table | 1 | Create Transformation Table 1 - Normalize Cache |
---|
|
...
Image Removed
...
|
Input Field Type | Input Field Value | Output Field Type | Output Field Value | Match Type |
---|
Called Address/Number | (.*) | Called Address/Number | =1\1 | Mandatory | Called Address/Number | ==msRTCSIP-Line== | Called Address/Number | =mobile= | Mandatory |
|
...
...
Table | 1 | Create Transformation Table 2 - Normalize Cache |
---|
|
...
...
Image Removed
...
Input Field Type | Input Field Value | Output Field Type | Output Field Value | Match Type |
---|
Called Address/Number | (.*) | Called Address/Number | tel +1\1 | Mandatory | Called Address/Number | ==msRTCSIP-Line== | Called Address/Number | =mobile= | Mandatory |
|
If your Lync Line URI: looks like this: Caption |
---|
|
Image Modified |
These are two common normalizations for a 4 digit extension:
...
...
Table | 1 | Create Transformation Table 1 - Normalize Cache |
---|
|
...
Image Removed
|
Input Field Type | Input Field Value | Output Field Type | Output Field Value | Match Type |
---|
Called Address/Number | (.*)(....) | Called Address/Number | +1\1\2;ext=\2 | Mandatory | Called Address/Number | ==msRTCSIP-Line== | Called Address/Number | =mobile= | Mandatory |
|
...
...
Table | 1 | Create Transformation Table 2 - Normalize Cache |
---|
|
...
...
Image Removed
...
Note |
---|
If your Operating Mode is configured to Online, normalization should always include tel: as Normalize Cache is not available in Online mode. As stated before, Online mode is not recommended. |
Input Field Type | Input Field Value | Output Field Type | Output Field Value | Match Type |
---|
Called Address/Number | (.*)(....) | Called Address/Number | tel: +1\1\2;ext=\2 | Mandatory | Called Address/Number | ==msRTCSIP-Line== | Called Address/Number | =mobile= | Mandatory |
|
Additional Notes
The diagram below provides a pictorial representation for conceptualizing how data is processed through Transformation Table entries.
Panel |
---|
|
Caption |
---|
| Image Removed |
|
...