LDAP Groups

LDAP groups on the Oracle Enterprise Communications Broker group LDAP configs together, allowing the user to refine lookups to multiple LDAP servers. The user configures LDAP groups, defines the matching criteria by which the system selects servers to query, and applies LDAP groups as profiles to agents.

When the system determines that it may find information it needs in the LDAP database, it checks to see if there is an LDAP group configured on the applicable agent. If there is no group, the system uses the LDAP configuration to control its lookups. This configuration can include a single LDAP Config configured on the agent or a Global LDAP config. If there is a group, the system:

1. Checks the matching criteria in the group to identify relevant LDAP servers, and
2. Performs lookups to relevant servers `using the order that the administrator has configured in the group.

If there is no match with any of the group's servers, the system does not perform an LDAP lookup and proceeds with the process sequence is uses to find information.

Matching Criteria in LDAP Groups

The Oracle Enterprise Communications Broker ( OECB) uses configurable Matching Criteria to determine whether or not to perform a lookup to each server in an LDAP Group. The OECB supports regex expressions within matching criteria configuration.

The system evaluates matching criteria for all LDAP servers listed in the group. If there are no matches, the system proceeds without querying LDAP. If there are any matches, the system initiates lookups to servers in the order listed in the group. If there is no match, the system skips those servers.

Consider the example where the system performs a lookup for a phone number in LDAPGroup1. The LDAP Group selection is based on the agent configuration of the applicable end station. In this example, the LDAP1 agent configuration specifies LDAPGroup1 as its LDAP group.

In this example, the Administrator configured the first lookups within LDAPGroup1 to be directed to LDAP1. If the number matches a criteria entry, the system adds that server to the lookup list. If not, the system skips to the next servers in the group, evaluating their Matching Criteria.

Matching criteria for LDAPGroup1 could include the following entries.

Matching Criteria	LDAP Server
+1*	LDAP1
*@Div1.com	LDAP1
.*	LDAP2
+44*	LDAP3
+34555*	LDAP3

For LdapGroup1, the system queries LDAP1 only if the number starts with a +1 or has a host of Div1.com. The system queries LDAP2 in all cases based on its wildcard criteria. The system queries LDAP3 if the called number has a UK area code or has a Spain area code, then starts with 555.

Configure LDAP Groups

Configure LDAP before configuring LDAP groups.

Use the following procedure to create a new LDAP group:

1. Access the LDAP Configuration object.
   Configuration tab, System Administration section, LDAP, LDAP Group.
2. Click the Add button.
3. On the Add LDAP Group page, do the following:

   Group Name	Enter a name for this group. The name must be between 1 and 128 alpha-numeric characters without spaces. The name can include the underscore, comma, period and dash characters, bot not as the first characters in the name.
   Description	(Optional) Enter a description of this LDAP group.
   State	Select to enable this LDAP group.
   LDAP Agents	Click Add and do the following: Matching Criteria—Define the criteria the system must use to determine whether it should perform a lookup in the associated server for end station information. Regex is supported as a means of configuring matching strings. LDAP Config—Select the LDAP configuration that you want to use.

4. Click OK.
   The system displays the LDAP group configuration page, where can optionally add more agents.
5. After you add the necessary agents, click OK.
6. Save the configuration.

Apply your LDAP group to the applicable Agents from the LDAP drop-down list under the Agent controls.