Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Summary

Below is the call diagram example used as a configuration reference for the remainder of this document.

Panel
borderStylenone

Caption
0Figure
1Call Diagram Example

Image Modified

Caption
0Table
1Configuration 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


Before Beginning...

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?ADSIedit showing a typical location for an AD search
  • Does the SBC have a license for Active Directory? For details, refer to Viewing Licenses.

    Tip

    Active Directory is part of the SBC base license. The latest base licenses are available at Ribbon SBC Edge Download Center.

Panel
borderStylenone

Caption
0Figure
1ADSI Edit

       

SBC Active Directory Reference

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.


Panel
borderStylenone

Caption
0Figure
1Configuration for Individual Domain Controllers

Image Modified

Panel
borderStylenone

Caption
0Figure
1Global Configuration for SBC-to-DC Interactions

Image Modified

 

SBC AD Configuration

The SBC must be configured for:

  • Active Directory Integration
  • Forked Calling
  • AD-based Call Routing

Pagebreak

Active Directory Integration for Call Routing

  1. Click the Settings tab in the top nagivationnavigation, then select Domain ControllersControllers in the left-hand navigation

    Panel
    borderStylenone

    Caption
    0Figure
    1Domain Controllers

  2. Enter the AD information for your network

    Panel
    borderStylenone

    Caption
    0Figure
    1Enter AD Information

  3. Click Configuration Configuration in the left-hand navigation.

    Panel
    borderStylenone

    Caption
    0Figure
    1Configuration

  4. Configure the Active Directory Configuration as shown. Add whatever Cache AttributesAttributes you plan to use.

    Tip

    The minimum configuration for this example document should include the attributes: msRTCSIP-Line, name, displayName, mail, telephoneNumber

    Panel
    borderStylenone

    Caption
    0Figure
    1Active Directory Configuration

     

    Pagebreak

Active Directory Verification

  1. With the AD configuration completed, click Refresh Cache.

    Panel
    borderStylenone

    Caption
    0Figure
    1Refresh Cache

  2. Click Display StatisticsStatistics and verify that the AD queries are succeeding.

    Panel
    borderStylenone

    Caption
    0Figure
    1Display Statistics

  3. In the Domain Controller configuration, check the DC Status

    Panel
    borderStylenone

    Caption
    0Figure
    1Domain Controllers Table

     

    Panel
    borderStylenone

    Caption
    0Figure
    1Domain Controller Status

     

     

  4. Select the Tasks tab in the top navigation and click Active Directory Cache Query. In the form, pick an AD attribute from the pulldown and supply a corresponding value.

    Panel
    borderStylenone

    Caption
    0Figure
    1Active Directory Cache Query

    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.

1. Create a transformation table with an entry to search for a msRTCSIP-Line entry that matches the called number and returns the mobile number.

Panel
borderStylenone

Caption
0Figure
1Calls to Mobile

Image Modified

    

2. Create a new call route table, then a call route entry to the table. In the example, the Calls to Mobile transformation table (above) is added to the call route (below).

Panel
borderStylenone

Caption
0Figure
1Create Call Route Table

Image Modified

    

3. Create a second transformation table with an entry to search for a msRTCSIP-Line entry that matches the called number.

Panel
borderStylenone

Caption
0Figure
1Create Transformation Table

Image Modified 

   

 


4. Add a second entry to your Call Route table to send the call to the Lync Server. As before, add the transformation table above to the call route below.

Panel
borderStylenone

Caption
0Figure
1Add Entry

Image Modified

 

   


5. Your call route table should look like this:

Panel
borderStylenone

Caption
0Figure
1Completed Table

Image Modified

 

   

expand

Section
Column
Info

If you are planning to employ AD lookups for Lync Line URI (msRTCSIP-Line), your searches will likely require additional number translations. Click here to view some common number normalizations for msRTCSIP-Line AD lookups. If you are planning to employ AD lookups for Lync Line URI (msRTCSIP-Line), your searches will likely require additional number translations. Click here to view some common number normalizations for msRTCSIP-Line AD lookups.

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.

Below

The following are some common normalization transformations.

tip
Info
If

If Normalize Cache

is

 is configured

to

to True, the tel: will automatically be removed from msRTCSIP-Line before the SBC caches the number.

Setting

Setting Normalize Cache

to

 to True

is

 is recommended.

 

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.

Panel

If your Lync Line URI: looks like this:

 

 

Caption
0Figure
1Lync Line URI

Image Modified

 

 

These are two common normalizations:

Caption
0Figure
1Normalize Cache set to True

Image Modified

   Panel 

Caption
0Figure
1Normalize Cache set to False

Image Modified

 

 

Pagebreak

If your Lync Line URI: looks like this:
Caption
0Figure
1Lync Line URI

Image Modified

 

These are two common normalizations for a 4 digit extension:

 

Caption
0Figure
1Normalize Cache set to True

Image Modified

  

Caption
0Figure
1Normalize Cache set to False

Image Modified

 

 

Panel
 
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.

 

Pagebreak

Additional Notes

The diagram below provides a pictorial representation for conceptualizing how data is processed through Transformation Table entries.

Panel
borderStylenone

Caption
0Figure
1Data Process

Image Modified

 

Pagebreak