...
...
...
...
- 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 |
|
...
...
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?
...
Image Removed
...
Tip |
---|
Active Directory is part of the SBC base license. The latest base licenses are available at |
...
...
Panel |
---|
|
Caption |
---|
| Image Added |
|
...
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
Image Removed |
Configuration for Individual Domain Controllers
Image Removed |
...
For details on configuring an entry in the Domain Controller Table, refer to Adding and Modifying Domain Controllers.
For details on configuring the Active Directory Configuration for SBC to Domain Controller interactions, refer to Configuring the SBC Edge for Active Directory.
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
Image Removed |
- Access Settings and select Auth and Directory Services > Active Directory > Domain Controllers.
- Enter the AD information for your network
...
Image Removed |
...
Click Configurationin the left-hand navigation.
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.
...
- In the Domain Controller configuration,
...
Image Removed |
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.
...
...
- Create a new call route table, then a call route entry to
...
...
...
...
...
- Create a second transformation table with an entry to search for a msRTCSIP-Line entry that matches the called number.
...
Image Removed
...
...
theCall Route table to send the call to the Lync Server. As before, add the transformation table above to the call route below
...
Image Removed
...
...
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:
...
Image Removed
with Normalize Cache set to False
Caption |
---|
0 | Table |
---|
1 | Create Transformation Table 1 - Normalize Cache Set to True |
---|
|
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 |
|
Caption |
---|
0 | Table |
---|
1 | Create Transformation Table 2 - Normalize Cache Set to False |
---|
|
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:
...
Image Removed
with Normalize Cache set to False
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. |
Caption |
---|
0 | Table |
---|
1 | Create Transformation Table 1 - Normalize Cache Set to True |
---|
|
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 |
|
Caption |
---|
0 | Table |
---|
1 | Create Transformation Table 2 - Normalize Cache Set to False |
---|
|
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.
...