Cisco Unified Communications Manager Administration Guide, Release 8.0(2)
LDAP Custom Filters
Downloads: This chapterpdf (PDF - 361.0KB) The complete bookPDF (PDF - 18.29MB) | Feedback

LDAP Custom Filter

Table Of Contents

LDAP Custom Filter

LDAP Filter Configuration Settings

Finding an LDAP Filter

Configuring an LDAP Filter

Deleting an LDAP Filter

Related Topics


LDAP Custom Filter


LDAP directory configuration takes place in these related windows:

LDAP System

LDAP Directory

LDAP Authentication

LDAP Filter Configuration

Use the following topics to configure LDAP filter information:

LDAP Filter Configuration Settings

Finding an LDAP Filter

Configuring an LDAP Filter

Deleting an LDAP Filter

Related Topics

LDAP Filter Configuration Settings

In the LDAP Filter Configuration window, you specify information about the LDAP filter. Table 17-1 describes the LDAP filter configuration settings. For related procedures, see the "Related Topics" section.

Before You Begin

Before you can synchronize the LDAP directory, you must activate the Cisco DirSync service. For information about how to activate services, refer to the Cisco Unified Serviceability Administration Guide.

Changes to LDAP Directory information and LDAP Authentication settings are possible only if synchronization from the customer LDAP directory is enabled in the Cisco Unified Communications Manager Administration LDAP System window.

You can import and export LDAP custom filters by using the Bulk Administration Tool. For more information, see the Cisco Unified Communications Manager Bulk Administration Guide.

Table 17-1 LDAP Custom Filter Settings 

Field
Description
LDAP Custom Filter Information

Filter Name

Enter a name for the LDAP filter. The name can contain a maximum of 64 UTF-8 characters.

Filter

Enter a filter. The filter can contain a maximum of 1024 UTF-8 characters. Enclose the filter text within parentheses ().

The LDAP filter filters the results of LDAP searches. LDAP users that match the filter get imported into the Cisco Unified Communications Manager database, while LDAP users that do not match the filter do not get imported.

The filter text that you enter must comply with the regular LDAP search filter standards specified in RFC 4515. It is recommended that you verify the LDAP search filter against the LDAP directory/searchbase by using the ldapsearch command.

You apply LDAP filters to LDAP directories. For more information, see the "LDAP Directory Configuration" section on page 15-1. You can apply an LDAP filter to multiple LDAP directories, and to all LDAP directory types for which the filter is valid.


Finding an LDAP Filter

Use the following procedure to locate LDAP filters.

Procedure


Step 1 Choose System > LDAP > LDAP Custom Filter.

The Find and List LDAP Filters window displays.

Step 2 To find all records in the database, ensure the dialog box is empty; go to Step 3.

To filter or search records:

From the first drop-down list box, select a search parameter.

From the second drop-down list box, select a search pattern.

Specify the appropriate search text, if applicable.


Note To add additional search criteria click the + button. When you add criteria, the system searches for a record that matches all criteria that you specify. To remove criteria, click the - button to remove the last added criteria or click the Clear Filter button to remove all added search criteria.


Step 3 Click Find.

All matching records display. You can change the number of items that display on each page by choosing a different value from the Rows per Page drop-down list box.


Note You can delete multiple records from the database by checking the check boxes next to the appropriate record and clicking Delete Selected. You can delete all configurable records for this selection by clicking Select All and then clicking Delete Selected.


Step 4 From the list of records that display, click the link for the record that you want to view.


Note To reverse the sort order, click the up or down arrow, if available, in the list header.


The window displays the item that you choose.


Additional Information

See the "Related Topics" section.

Configuring an LDAP Filter

This section describes how to add or update information about an LDAP filter.

Procedure


Step 1 Choose System > LDAP > LDAP Custom Filter.

The Find and List LDAP Filters window displays.

Step 2 Perform one of the following tasks:

To copy an existing LDAP filter, locate the appropriate filter as described in the "Finding an LDAP Filter" section, click the Copy button next to the phone that you want to copy, and continue with Step 3.

To add a new LDAP filter, click the Add New button, and continue with Step 3.

To update existing information about an LDAP filter, locate the appropriate filter as described in the "Finding an LDAP Filter" section and continue with Step 3.

Step 3 Enter the appropriate settings as described in Table 17-1.

Step 4 Click Save.

The new LDAP filter gets added or updated to the Cisco Unified Communications Manager database.


Additional Information

See the "Related Topics" section.

Deleting an LDAP Filter

This section describes how to delete an LDAP filter in Cisco Unified Communications Manager Administration.

Before You Begin

When you delete an LDAP filter, Cisco Unified Communications Manager removes that filter from the database.

You cannot delete an LDAP filter that is assigned to a directory agreement. To determine if an LDAP filter is assigned to a directory agreement, select Dependency Records from the Related Links list in the LDAP Filter Configuration window. If any dependencies display for that LDAP filter, you cannot delete it.


Note You can delete multiple LDAP filters from the Find and List LDAP Filters window by checking the check boxes next to the appropriate LDAP filters and clicking Delete Selected. You can delete all LDAP filters in the window by clicking Select All and then clicking Delete Selected.


Procedure


Step 1 Find the LDAP filter that you want to delete by using the procedure in the "Finding an LDAP Filter" section.

Step 2 Click the name of the LDAP filter that you want to delete.

The LDAP filter that you chose displays.

Step 3 Click Delete.

You receive a message that asks you to confirm the deletion.

Step 4 Click OK.

The window refreshes, and the LDAP filter gets deleted from the database.


Additional Information

See the "Related Topics" section.

Related Topics

LDAP Filter Configuration Settings

Finding an LDAP Filter

Configuring an LDAP Filter

Deleting an LDAP Filter

Understanding the Directory, Cisco Unified Communications Manager System Guide

LDAP System Configuration, page 14-1

LDAP Directory Configuration, page 15-1

LDAP Authentication Configuration, page 16-1

Application Users and End Users, Cisco Unified Communications Manager System Guide

Application User Configuration, page 112-1

End User Configuration, page 113-1