Configure Lightweight Directory Access Protocol entity types in federated repository
Follow this task to configure LDAP entity types in federated repository.
- In the console, click Security > Global security.
- Under User account repository, select Federated repositories from the Available realm definitions field and click Configure. To configure for a specific domain in a multiple security domain environment, click Security domains > domain_name. Under Security Attributes, expand User Realm, and click Customize for this domain. Select the Realm type as Federated repositories and then click Configure.
- Under Related items, click Manage repositories.
- Click Add to specify a new external repository or select an external repository that is preconfigured. During LDAP configuration, based on the selected LDAP server type, some defaults and mappings are set in the configuration. When the selected LDAP server type is custom, no default is set, and set all of the mappings manually. To avoid setting all of the mappings manually, choose a non-custom LDAP server type (for example, IBM Directory Server or SunOne) which matches closely to the LDAP server.
Avoid trouble:
- If we click Add to specify a new external repository, first complete the required fields and click Apply before we can proceed to the next step.
- If we decide to use a custom LDAP server type, use the command-line interface to create the entity types. Read about IdMgrRepositoryConfig (AdminTask) for more information.
After we create the entity types, we can use the console to modify these entities. We cannot use the console to create entity types for a custom LDAP server type.
gotcha
- Under Additional properties, click LDAP entity types.
- View the entity types that are supported by the member repositories, or select an entity type to view or change its configuration properties.
- Supply the object classes mapped to this entity type in the Object classes field. LDAP entries containing one or more of the object classes belong to this entity type.
- Supply the search bases used to search this entity type. The search bases specified must be subtrees of the base entry in the repository. For example, we can specify the following search bases, where o=ibm,c=us is the base entry in the repository:
o=ibm,c=us or cn=users,o=ibm,c=us or ou=austin,o=ibm,c=us
In the preceding example, we cannot specify search bases c=us or o=ibm,c=uk.
Delimit multiple search bases with a semicolon (;). For example:
ou=austin,o=ibm,c=us;ou=raleigh,o=ibm,c=us
- Supply the LDAP search filter used to search this entity type.
For example, use (objectclass=ePerson) to search for users or (|(objectclass=groupOfNames)(objectclass=groupOfUniqueNames) to search for groups in an external LDAP repository.
If a search filter is not specified, the object classes and the relative distinguished name (RDN ) properties are used to generate the search filter. For information on RDN properties, see Configure supported entity types in federated repository.
Results
After completing these steps, LDAP entity types are configured for the LDAP repository.
What to do next
- After configuring the federated repositories, click Security > Global security to return to the Global security panel. Verify that Federated repositories is identified in the Current realm definition field. If Federated repositories is not identified, select Federated repositories from the Available realm definitions field and click Set as current. To verify the federated repositories configuration, click Apply on the Global security panel. If Federated repositories is not identified in the Current realm definition field, the federated repositories configuration is not used by WebSphere Application Server.
- If we are enabling security, complete the remaining steps as specified in Enable security for the realm. As the final step, validate this setup by clicking Apply in the Global security panel.
- Save, stop, and restart all the product servers (deployment managers, nodes, and Application Servers) for changes in this panel to take effect. If the server comes up without any problems, the setup is correct.
Subtopics
- Lightweight Directory Access Protocol entity types collection
Use this page to list LDAP entity types that are supported by the member repositories or to select an LDAP entity type to view or change its configuration properties.
- LDAP attributes collection
Use this page to add, modify, or delete the configuration of supported, unsupported, and external LDAP attributes in a federated repositories configuration.
- Lightweight Directory Access Protocol entity types settings
Use this page to configure LDAP entity types that are supported by the member repositories.
IdMgrRepositoryConfig (AdminTask)