Versions Compared

Old Version 1

changes.mady.by.user Ribbon Communications

Saved on

compared with

New Version Current

changes.mady.by.user Ribbon Communications

Saved on

Key

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

Add_workflow_for_techpubs
AUTH1UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cb41059c, userName='null'}
JIRAIDAUTHSYM-27062
REV5UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cc7d083d, userName='null'}
REV6UserResourceIdentifier{userKey=8a00a0c85b2726c2015b58aa779d0003, userName='null'}
REV3UserResourceIdentifier{userKey=8a00a0c85c46b657015d505775a80024, userName='null'}
REV1UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cc2d0797, userName='null'}

...

Excerpt

This page explains how to configure the

Sonus 

Spacevars
0company
Spacevars
0product
to use Active Directory services.


Note
iconfalse

Active Directory is always enabled by default, no licensing action is required to turn it on.

This process comprises three parts:

...

The Active Directory configuration part is where you turn on Active Directory (AD), set the way the Sonus 

Spacevars
0company
Spacevars
0product
will  will communicate with the AD server.

Info

The maximum amount of characters for the Active Directory Configuration attributes is 512.

The Cache Setting part is where you set up AD attribute caching.

...

You must have already defined and added at least one domain controller to the Domain Controllers Table.

Configuring Active Directory Services on

...

the SBC Edge

Excerpt
  1. In the WebUI, click the Settings tab.

  2. In the left navigation pane, go to Auth and Directory Services > Active Directory > Configuration.

    Image Removed
    Panel
    borderStylenone


    Caption
    0Figure
    1Active Directory Configuration

    Image Added



Active Directory Configuration - Field Definitions

The fields in the Active Directory Configuration panel determine the manner in which Sonus which 

Spacevars
0company
Spacevars
0product
communicates with the Active Directory server.

...

Panel
bgColor#FAFAFA
borderStylenone

Specifies whether or not Transport Layer Security (TLS) is used while communicating with Active Directory.

  • TLS = FALSE: MD5 Digest is used to secure the AD password over the wire.
Info

Since DCs do not support referral chasing or nested group lookups with MD5 Digest, you can't log in to Sonus

Spacevars
0product
using AD credentials if those credentials require referral chasing or nested group lookup by the DC. Instead, you can individually configure each DC you wish to query when someone attempts to log into the Sonus
Spacevars
0product
.

  • TLS = TRUE: TLS will be used to secure all communcation for requests to the DC.
Info

Referral chasing and nested group lookups are supported with TLS enabled. Again, this applies only to authenticating users attempting to log into the Sonus the 

Spacevars
0company
Spacevars
0product
.


Info

AD lookups for call routing are executed the same regardless of the AD TLS configuration. DCs do not support referral chasing for call route lookups, therefore you must individually configure each DC that you wish to search for AD call routing queriequeries.


Operating Mode

Panel
bgColor#FAFAFA
borderStylenone

Specifies the method used by the Sonus the 

Spacevars
0company
Spacevars
0product
to communicate with Active Directory in order to achieve a balance between performance and accuracy.

  • Online: All AD queries are sent directly to the DC - no information is cached. User authentication using Active Directory is also enabled in this mode. Online mode can result in a heavy DC load, thus using Online mode is not recommended.
  • Updates: In this mode, a local cache is built and used to lookup Active Directory searchable fields. If the SBC's cache is filled to capacity, first the cache, then the DC will be queried in attempts to find a match. User authentication using Active Directory is also enabled in this mode; however, sensitive information (including passwords) is not cached.
  • Auth-Only: Allows user authentication using Active Directory, but no Active Directory queries are allowed.
  • Cache Lookup Only: When selected, the SBC examines only the local AD Cache for the requested attribute. Even if the cache is filled to capacity, the DC will not be queried. The call fails if no match is found in the local cache.
Info
iconfalse
titleSBC 1000 Note:

Spacevars
0company
Sonus recommends the use of an external USB or ASM module for AD Cache backup on the SBC 1000 when either the Updates or Cache Only mode is the selected operating mode.


Info

An SNMP alarm will be generated if the local AD cache reaches capacity.


Info

If your cache reaches capacity when in Update Mode, the SBC will automatically query the DC for any entries that are not cached. Queries to the DC are never normalized. Routing may intermittently fail if your transformations rely on normalized cache entries.


Info

Be aware that Cache Normalization is not performed on queries to the DC, even in Update Mode with Normalize Cache set to True. Therefore, transformations that rely on normalization (e.g. msRTCSIP-Line transformations that do not include tel: ) will fail for queries that resort to a DC lookup. If you're cache reaches capacity:

  • Reduce the number of cached attributes so that the cache is no longer at capacity
  • Set Normalize Cache to False and modify any transformation that relies on the cache being normalized. (suggested)
  • Add transformations to route both normalized and non-normalized AD call route queries. (avoid)


Query/Cache Attributes

Panel
bgColor#FAFAFA
borderStylenone

Specifies which attributes are cached from Active Directory. The attribute names specified must be consistent with attribute names in Active Directory.

Nested Group Lookup for Authentication

...

The fields in the Cache Settings panel determine how Active Directory attributes are cached locally and the frequency at which the local cache is updated. The Sonus The 

Spacevars
0product
maintains a local cache of Active Directory user attributes. AD caching enhances system performance and survivability.

...

  • Survivability: In the event of a loss of communication with the Active Directory, whether through a loss of network connectivity or an AD server error, the Sonus 
    Spacevars
    0product
    is still able to perform authentication and authorization tasks based on the Local AD Cache.

...

Panel
bgColor#FAFAFA
borderStylenone

Specifies the time (system time) at which the first AD Cache update occurs after initial SBC power up or after an AD Configuration has been edited and applied. This field is visible only when the Configure Initial Update Time field is set to True.

Info

The last saved AD Cache is used until the first update specified by this field occurs.


Info

On the SBC 2000 or the SBC 1000 (if it has an external external USB or ASM module), it is recommended to do the following

  1. Set Update Frequency to 1440 minutes (24 hours)
  2. Set Configure Initial Update Time to True
  3. Configure First Update Time in a 24 hour format

The preceding procedure ensures that the cache refresh will always occur at a desired time instead of a random time. Only increase the cache Update Frequency to occur more often if there are frequent changes to the Windows Domain Controller; otherwise, once every 24 hours should be sufficient.


AD Backup Failure Alarm

Panel
bgColor#FAFAFA
borderStylenone

When Enabled, the SBC will raise an alarm and send an SNMP Trap if the AD Cache backup fails. This parameter controls the alarm and trap generation only. It does not control the AD Cache backup function.

Encrypt AD Cache

...

Panel
bgColor#FAFAFA
borderStylenone

The Encrypt AD Cache option allows the SBC Edge (SBC 1000, SBC 2000. and SBC SWe Lite) to encrypt the AD cache when stored on any media (internal eUSB, external USB, or ASM). The AD cache contents can then only be viewed when it is decrypted with the correct password. This encryption secures the contents against unauthorized viewing.

Valid options: True (encrypts the AD cache) or False (does not encrypt the AD cache). Default entry: FalseSpecifies which attributes are cached from Active Directory. The attribute names specified must be consistent with attribute names in Active Directory.

Children Display
depth3
styleh5