Unified User Profiles

If you have an existing store of users, groups, and additional properties (such as address, e-mail address, phone number, and so on), unified user profiles are a necessary part of bringing those user properties into the WebLogic Portal environment, where they can be used for retrieving and editing property values and setting up personalization, delegated administration, and visitor entitlements.
This chapter describes the unified user profile, when to use it, and when not to use it.
Note: This topic contains the terms "user store" and "data store." A user store can contain users and groups, as well as additional properties. A data store implies that the store does not have to contain users and groups. It can simply contain properties.
This chapter includes the following sections:
Overview of Unified User ProfilesWhen Should You Create a Unified User Profile?When Don‘t You Need a Unified User Profile?Setting up Unified User Profiles
Overview of Unified User Profiles
Here is an example that explains what a unified user profile is and does:
Let‘s say you‘re creating a new portal application that you want users to be able to log in to. Let‘s also say your users are stored in an RDBMS user store outside of the WebLogic environment. You could connect WebLogic Server (your portal application‘s domain server instance) to your RDBMS system, and your users could log in to your portal application as if their user names and passwords were stored in WebLogic Server. If authentication was all you wanted to provide through your RDBMS user store, you could stop here without needing a unified user profile.
However, let‘s say you also stored e-mail and phone number information (properties) for users in your RDBMS user store, and you wanted to be able to access those properties in your portal applications. In this case, you need to create a unified user profile for your RDBMS user store that lets you access those additional properties from your code.
Technically speaking, a unified user profile is a stateless session bean you create (with associated classes) that lets WebLogic Portal read property values stored in external data stores, such as LDAP servers and databases. Once connected to an external data store with a unified user profile, you can use portal JSP tags, controls, and the WebLogic Portal API to retrieve user property values from that store. You can also take the extra step of surfacing these external properties in the WebLogic Administration portal, where the properties can be used to define rules for personalization, visitor entitlements, and delegated administration.
Whether or not you have additional properties stored in your external user store, the external users and groups you connect to WebLogic Server are automatically assigned the default user property values you have set up in WebLogic Portal, without the use of a unified user profile. With the WebLogic Administration Portal, you can change the default WebLogic Portal property values for those users. These values are stored in WebLogic Portal‘s RDBMS data store using the Portal schema.
The following figure shows where a unified user profile fits between an external user store and the WebLogic environment.
Figure 3-1 Unified User Profile

1
This external RDBMS user store, which supports authentication, contains users (principals) and passwords in one database table and groups (principals) in another. Giving a user store authentication capabilities (as an authentication provider or identity asserter) involves configuration steps not associated with the unified user profile configuration process. (See Developing Security Providers for WebLogic Server.) Unified user profile configuration is not dependent on the authentication provider configuration and vice versa.
Once the RDBMS authentication provider is connected to WebLogic Server, WebLogic Server (and WebLogic Portal) can see those users and groups. Those users can log in to your portal applications, and you can include those users and groups in your rules for personalization, delegated administration, and visitor entitlements. Also, WebLogic Portal‘s ProfileWrapper maps the principals to properties kept in the Portal schema, thereby establishing the user profile.
2
Unified User Profile - The same external table that contains users and passwords also contains additional properties (email and phone) for each user. These additional properties are not part of authentication; but they are part of each user‘s profile. If you want to access these properties in your portal applications (with the WebLogic Portal JSP tags, controls, or API), you must create a unified user profile for the RDBMS user store. When you create the unified user profile, the ProfileWrapper includes the external properties in the user profile. The unified user profile consists of a stateless session bean and associated classes that you create.
If you want to surface any of these properties in the WebLogic Administration Portal to be used in defining rules for personalization, delegated administration, or visitor entitlements, create a user profile property set for the external user store in addition to implementing your unified user profile session bean. The property set provides metadata about your external properties so that WebLogic Workshop and the WebLogic Administration Portal know how to display them.
Properties from an external data store are typically read only in the WebLogic Administration Portal.
3
WebLogic Portal lets you create user/group properties and set default values for those properties. Any user or group in WebLogic Server, whether created in the default LDAP store or brought in through a connection to an external user store, is automatically assigned those default property values; and you can change the default values for each user or group, programmatically or in the WebLogic Administration Portal. This does not involve unified user profiles, because the properties to be retrieved are local, not stored in an external data store.
In the illustration, after the authentication provider or identity asserter provides the principals, the ProfileWrapper combines the principals with the external properties of email and phone (retrieved by the unified user profile) and the default WebLogic Portal properties of address and postal code, all of which make up the full user profile.
 
What a Unified User Profile is Not
A user profile is not a security realm, and it does not provide authentication. It is not even the external user store itself. It is the connection (stateless session bean with associated classes) that lets you read properties in the external user store.
When Should You Create a Unified User Profile?
Create a unified user profile for an external data store if you want to do any of the following:
Use WebLogic Portal‘s JSP tags, controls, or API to retrieve property values from that external store. Surface external properties in the WebLogic Administration Portal for use in defining rules for personalization, delegated administration, or visitor entitlements. Users and groups are not considered properties.
When Don‘t You Need a Unified User Profile?
You do not need to create a unified user profile for an external data store if you only want to:
Provide authentication for users in the external user store. Define rules for personalization, delegated administration, or visitor entitlements based only on users or groups in an external user store, not on user properties. Define rules for personalization, delegated administration, or visitor entitlements based on the WebLogic Portal user profile properties you create in WebLogic Workshop, which are kept in the Portal schema.
Setting up Unified User Profiles
This topic provides guidelines and instructions on creating a unified user profile to access user/group properties from an external user store. (See Unified User Profiles Overview for overview information.)
To create a UUP to retrieve user data from external sources, complete the following tasks:
Create an EntityPropertyManager EJB to Represent External Data Deploy a ProfileManager That Can Use the New EntityPropertyManager If you have an LDAP server for which you want to create a unified user profile, WebLogic Portal provides a default unified user profile you can modify. See Retrieving User Profile Data from LDAP.
Create an EntityPropertyManager EJB to Represent External Data
To incorporate data from an external source, you must first create a stateless session bean that implements the methods of the com.bea.p13n.property.EntityPropertyManager remote interface. EntityPropertyManager is the remote interface for a session bean that handles the persistence of property data and the creation and deletion of profile records. By default, EntityPropertyManager provides read-only access to external properties.
In addition, the stateless session bean should include a home interface and an implementation class. For example:
MyEntityPropertyManagerextends com.bea.p13n.property.EntityPropertyManagerMyEntityPropertyManagerHome extends javax.ejb.EJBHome
Your implementation class can extend the EntityPropertyManagerImpl class. However the only requirement is that your implementation class is a valid implementation of the MyEntityPropertyManager remote interface. For example:
MyEntityPropertyManagerImpl extendscom.bea.p13n.property.internal.EntityPropertyManagerImpl
or
MyEntityPropertyManagerImpl extendsjavax.ejb.SessionBeanRecommended EJB Guidelines
We recommend the following guidelines for your new EJB:
Your custom EntityPropertyManager is not a default EntityPropertyManager. A default EntityPropertyManager is used to get/set/remove properties in the Portal schema. Your custom EntityPropertyManager does not have to support the following methods. It can throw java.lang.UsupportedOperationException instead: getDynamicProperties() getEntityNames() getHomeName() getPropertyLocator() getUniqueId()
If you want to be able to use the portal framework and tools to create and remove users in your external data store, you must support the createUniqueId() and removeEntity() methods. However, your custom EntityPropertyManager is not the default EntityPropertyManager so your createUniqueId() method does not have to return a unique number. It must create the user entity in your external data store and then it can return any number, such as -1. The following recommendations apply to the EntityPropertyManager() methods that you must support: getProperty() - Use caching. You should support the getProperties() method to retrieve all properties for a user at once, caching them at the same time. Your getProperty() method should use getProperties(). setProperty() - Use caching. removeProperties(), removeProperty() - After these methods are called, a call to getProperty() should return null for the property. Remove properties from the cache, too.
Your implementations of the getProperty(), setProperty(), removeProperty(), and removeProperties() methods must include any logic necessary to connect to the external system. If you want to cache property data, the methods must be able to cache profile data appropriately for that system. (See the com.bea.p13n.cache package in the WebLogic Portal Javadoc.) If the external system contains read-only data, any methods that modify profile data must throw a java.lang.UnsupportedOperationException. Additionally, if the external data source contains users that are created and deleted by something other than your WebLogic Portal createUniqueId() and removeEntity() methods can simply throw an UnsupportedOperationException. To avoid class loader dependency issues, make sure that your EJB resides in its own package. For ease of maintenance, place the compiled classes of your custom EntityPropertyManager bean in your own JAR file (instead of modifying an existing WebLogic Portal JAR file).
Before you deploy your JAR file, follow the steps in the next section.
Deploy a ProfileManager That Can Use the New EntityPropertyManager
A "user type" is a mapping of a ProfileType name to a particular ProfileManager. This mapping is done in the UserManager EJB deployment descriptor.
To access the data in your new EntityPropertyManager EJB, you must do one of the following:
Modifying the Existing ProfileManager Deployment Configuration - In most cases you will be able to use the default deployment of ProfileManager, the UserProfileManager. You will modify the UserProfileManager‘s deployment descriptor to map a property set and/or properties to your custom EntityPropertyManager. If you support the createUniqueId() and removeEntity() methods in your custom EntityPropertyManager, you can use WebLogic Administration Portal to create a user of type "User" with a profile that can get/set properties using your custom EntityPropertyManager. Configuring and Deploying a New ProfileManager - In some cases you may want to deploy a newly configured ProfileManager that will be used instead of the UserProfileManager. This new ProfileManager is mapped to a ProfileType in the deployment descriptor for the UserManager. If you support the createUniqueId() and removeEntity() methods in your custom EntityPropertyManager, you can use the WebLogic Administration Portal (or API) to create a user of type "MyUser" (or anything else you name it) that can get/set properties using the customized deployment of the ProfileManager that is, in turn, configured to use your custom EntityPropertyManager.
ProfileManager is a stateless session bean that manages access to the profile values that the EntityPropertyManager EJB retrieves. It relies on a set of mapping statements in its deployment descriptor to find data. For example, the ProfileManager receives a request for the value of the "DateOfBirth" property, which is located in the "PersonalData" property set. ProfileManager uses the mapping statements in its deployment descriptor to determine which EntityPropertyManager EJB contains the data.
Modifying the Existing ProfileManager Deployment Configuration
If you use the existing UserProfileManager deployment to manage your user profiles, perform the following steps to modify the deployment configuration.
Under most circumstances, this is the method you should use to deploy your UUP. An example of this method is the deployment of the custom EntityPropertyManager for LDAP property retrieval, the LdapPropertyManager. The classes for the LdapPropertyManager are packaged in p13n_ejb.jar. The deployment descriptor for the UserProfileManager EJB is configured to map the "ldap" property set to the LdapPropertyManager. The UserProfileManager is deployed in p13n_ejb.jar.
Back up the p13n_ejb.jar file in your enterprise application root directory.
From p13n_ejb.jar, extract META-INF/ejb-jar.xml and open it for editing.
In ejb-jar.xml, find the element, as shown in the following example:
PropertyMapping/ldap java.lang.String LdapPropertyManager and add an element after this to map a property set to your custom EntityPropertyManager, a shown in the following example:
PropertyMapping/UUPExample java.lang.String MyEntityPropertyManager
In ejb-jar.xml, find the element shown in the following example:
ejb/LdapPropertyManager Session com.bea.p13n.property.EntityPropertyManagerHome com.bea.p13n.property.EntityPropertyManager and add an element after this to map a reference to an EJB that matches the name from the previous step with ejb/ prepended as shown in the following example:
ejb/MyEntityPropertyManager Session examples.usermgmt.MyEntityPropertyManagerHome examples.usermgmt.MyEntityPropertyManager The home and remote class names match the classes from your EJB JAR file for your custom EntityPropertyManager.
If your EntityPropertyManager implementation handles creating and removing profile records, you must also add Creator and Remover entries. For example:
Creator/Creator1 java.lang.String MyEntityPropertyManager Remover/Remover1 java.lang.String MyEntityPropertyManager This instructs the UserProfileManager to call your custom EntityPropertyManager when creating or deleting user profile records. The names "Creator1" and "Remover1" are arbitrary. All Creators and Removers will be iterated through when the UserProfileManager creates or removes a user profile. The value for the Creator and Remover matches the ejb-ref-name for your custom EntityPropertyManager without the ejb/ prefix.
From p13n_ejb.jar, extract META-INF/weblogic-ejb-jar.xml and open it for editing.
In weblogic-ejb-jar.xml, find the elements shown in the following example:
UserProfileManager ejb/EntityPropertyManager ${APPNAME}.BEA_personalization. EntityPropertyManager and add an ejb-reference-description to map the ejb-ref for your custom EntityPropertyManager to the JNDI name. This JNDI name must match the name you assigned in weblogic-ejb-jar.xml in the JAR file for your customer EntityPropertyManager. It should look like the following example:
UserProfileManager ejb/EntityPropertyManager ${APPNAME}.BEA_personalization. EntityPropertyManager ejb/MyEntityPropertyManager ${APPNAME}.BEA_personalization. MyEntityPropertyManager Note the ${APPNAME} string substitution variable. The WebLogic EJB container automatically substitutes the enterprise application name to scope the JNDI name to the application.
Update p13n_ejb.jar for your new deployment descriptors. You can use the jar uf command to update the modified META-INF/ deployment descriptors.
Edit your application‘s META-INF/application.xml to add an entry for your custom EntityPropertyManager EJB module as shown in the following example:
UUPExample.jar If you are using an application-wide cache, you can manage it from the WebLogic Administration Console if you add a tag for your cache to the META-INF/application-config.xml deployment descriptor for your enterprise application like this:
Verify the modified p13n_ejb.jar and your custom EntityPropertyManager EJB JAR archive are in the root directory of your enterprise application and start WebLogic Server.
Use the WebLogic Server Administration Console to verify your EJB module is deployed to the enterprise application and then use the console to add your server as a target for the EJB module. You need to select a target to have your domain‘s config.xml file updated to deploy your EJB module to the server.
Use the WebLogic Workshop Property Set Designer to create a User Profile (property set) that matches the name of the property set that you mapped to your custom EntityPropertyManager in ejb-jar.xml for the UserProfileManager (in p13n_ejb.jar). You could also map specific property names in a property set to your custom EntityPropertyManager, which would allow you to surface the properties and their values in the WebLogic Administration Portal for use in creating rules for personalization, delegated administration, and visitor entitlements.
Your new Unified User Profile type is ready to use. You can use the WebLogic Administration Portal to create a user, and it will use your UUP implementation when the "UUPExample" property set is being modified. When you call createUser("bob", "password") or createUser("bob", "password", null) on the UserManager, several things will happen:
A user named "bob" is created in the security realm. A WebLogic Portal Server profile record is created for "bob" in the user store. If you set up the Creator mapping, the UserManager will call the default ProfileManager deployment (UserProfileManager) which will call your custom EntityPropertyManager to create a record for Bob in your data source. Retrieving Bob‘s profile will use the default ProfileManager deployment (UserProfileManager), and when you request a property belonging to the "UUPExample" property set, the request will be routed to your custom EntityPropertyManager implementation.
Configuring and Deploying a New ProfileManager
If you are going to deploy a newly configured ProfileManager instead of using the default ProfileManager (UserProfileManager) to manage your user profiles, perform the following steps to modify the deployment configuration. In most cases, you will not have to use this method of deployment. Use this method only if you need to support multiple types of users that require different ProfileManager deployments—deployments that allow a property set to be mapped to different custom EntityPropertyManagers based on ProfileType.
An example of this method is the deployment of the custom CustomerProfileManager in customer.jar. The CustomerProfileManager is configured to use the custom EntityPropertyManager (CustomerPropertyManager) for properties in the "CustomerProperties" property set. The UserManager EJB in p13n_ejb.jar is configured to map the "WLCS_Customer" ProfileType to the custom deployment of the ProfileManager, CustomerProfileManager.
To configure and deploy a new ProfileManager, use this procedure.
Back up the p13n_ejb.jar file in your enterprise application root directory.
From p13n_ejb.jar, extract META-INF/ejb-jar.xml, and open it for editing.
In ejb-jar.xml, copy the entire tag for the UserProfileManager, and configure it to use your custom implementation class for your new deployment of ProfileManager.
In addition, you could extend the UserProfileManager home and remote interfaces with your own interfaces if you want to repackage them to correspond to your packaging (for example., examples.usermgmt.MyProfileManagerHome, examples.usermgmt.MyProfileManager).
However, it is sufficient to replace the bean implementation class:
You must create an element to map a property set to your custom EntityPropertyManager. You must also create a element to map a reference to an EJB that matches the name from the PropertyMapping with ejb/ prepended. The home and remote class names for your custom EntityPropertyManager match the classes from your EJB JAR file for your custom EntityPropertyManager.
Also, if your EntityPropertyManager implementation handles creating and removing profile records, you must also add Creator and Remover entries. This instructs your new ProfileManager to call your custom EntityPropertyManager when creating or deleting user profile records.
Note: The name suffixes for the Creator and Remover, "Creator1" and "Remover1", are arbitrary. All Creators and Removers will be iterated through when your ProfileManager creates or removes a user profile. The value for the Creator and Remover matches the for your custom EntityPropertyManager without the ejb/ prefix.
In ejb-jar.xml, you must add an to the UserManager EJB section to map your ProfileType to your new deployment of the ProfileManager, as shown in the following example:
ejb/ProfileType/UUPExampleUser Session com.bea.p13n.usermgmt.profile.ProfileManagerHome com.bea.p13n.usermgmt.profile.ProfileManager The must start with ejb/ProfileType/ and must end with the name that you want to use as the profile type as an argument in the createUser() method of UserManager.
From p13n_ejb.jar, extract META-INF/weblogic-ejb-jar.xml and open it for editing.
In weblogic-ejb-jar.xml, copy the tag, shown in the following example, for the UserProfileManager and configure it for your new ProfileManager deployment:
MyProfileManager ejb/EntityPropertyManager ${APPNAME}.BEA_personalization. EntityPropertyManager ejb/PropertySetManager ${APPNAME}.BEA_personalization. PropertySetManager ejb/MyEntityPropertyManager ${APPNAME}.BEA_personalization. MyEnitityPropertyManager ${APPNAME}.BEA_personalization. MyProfileManager You must create an to map the for your custom EntityPropertyManager to the JNDI name. This JNDI name must match the name you assigned in weblogic-ejb-jar.xml in the JAR file for your custom EntityPropertyManager.
Note the ${APPNAME} string substitution variable. The WebLogic Server EJB container automatically substitutes the enterprise application name to scope the JNDI name to the application.
In weblogic-ejb-jar.xml, copy the tag for the UserProfileManager, shown in the following example, and configure it for your new ProfileManager deployment:
TRANSACTION_READ_COMMITTED MyProfileManager * Create a temporary p13n_ejb.jar for your new deployment descriptors and your new ProfileManager bean implementation class. This temporary EJB JAR archive should not have any container classes in it. Run ejbc to generate new container classes.
Edit your application‘s META-INF/application.xml to add an entry for your custom EntityPropertyManager EJB module, as shown in the following example:
UUPExample.jar If you are using an application-wide cache, you can manage it from the WebLogic Server Administration Console if you add a tag for your cache to the META-INF/application-config.xml deployment descriptor for your enterprise application as shown in the following example:
Verify the modified p13n_ejb.jar and your custom EntityPropertyManager EJB JAR archive are in the root directory of your enterprise application and start your server.
Use the WebLogic Server Administration Console to verify your EJB module is deployed to the enterprise application and add your server as a target for the EJB module. You must select a target to have your domain‘s config.xml file updated to deploy your EJB module to the server.
Use the WebLogic Workshop Property Set Designer to create a User Profile (property set) that matches the name of the property set that you mapped to your custom EntityPropertyManager in ejb-jar.xml for the UserProfileManager (in p13n_ejb.jar). You could also map specific property names in a property set to your custom EntityPropertyManager, which would allow you to surface the properties and their values in the WebLogic Administration Portal for use in creating rules for personalization, delegated administration, and visitor entitlements.
Your new Unified User Profile type is ready to use. You can use the WebLogic Administration Portal to create a user, and it will use your UUP implementation when the "UUPExample" property set is being modified. That is because you mapped the ProfileType using an in your UserManager deployment descriptor, ejb/ProfileType/UUPExampleUser.
Now, when you call createUser("bob", "password", "UUPExampleUser") on the UserManager, several things will happen:
A user named "bob" is created in the security realm. A WebLogic Portal Server profile record is created for "bob" in the WebLogic Portal RDBMS repository. If you set up the Creator mapping, the UserManager will call your new ProfileManager deployment, which will call your custom EntityPropertyManager to create a record for Bob in your data source. Retrieving Bob‘s profile will use your new ProfileManager deployment, and when you request a property belonging to the "UUPExample" property set, the request will be routed to your custom EntityPropertyManager implementation.
Retrieving User Profile Data from LDAP
WebLogic Portal provides a default unified user profile for retrieving properties from an LDAP server. Use this procedure to implement the LDAP unified user profile for retrieving properties from your LDAP server.
The LdapRealm security realm and the LdapPropertyManager unified user profile (UUP) for retrieving user properties from LDAP are independent of each other. They do not share configuration information and there is no requirement to use either one in conjunction with the other. A security realm has nothing to do with a user profile. A security realm provides user/password data, user/group associations, and group/group associations. A user profile provides user and group properties. A password is not a property.
In order to successfully retrieve the user profile from the LDAP server, ensure that you‘ve done the following:
If you have already deployed the application on a WebLogic Portal instance, stop the server.
Extract p13n_ejb.jar from your application root to a temporary directory.
In the temporary directory, open META-INF/ejb-jar.xml, which contains a commented block called "Ldap Property Manager." Uncomment and reconfigure this section using the following steps:
Remove the closing comment mark (-->) from the end of the "Ldap Property Manager" block, just before the "Property Set Web Service EJB" block, and add it to the end of the first paragraph of the Ldap Property Manager block, like this:
In the "Ldap Property Manager" block, look for the following default settings and replace them with your own:
ldap://server.company.com:389
Change this to the value of your LDAP server URL.
uid=admin, ou=Administrators, ou=TopologyManagement, o=NetscapeRoot
Change this to the value of your LDAP server‘s principal.
weblogic
Change "weblogic" to your LDAP server‘s principalCredential.
ou=People,o=company.com
Change this to your LDAP server‘s UserDN.
ou=Groups,o=company.com
Change this to your LDAP server‘s GroupDN.
uid
Change "uid" to your LDAP server‘s usernameAttribute setting.
cn
Change "cn" to your LDAP server‘s groupnameAttribute setting.
 
In the "User Profile Manager" and "Group Profile Manager" sections, find the following lines:

EntityPropertyManager Uncomment the LdapPropertyManager line and delete the EntityPropertyManager line in both sections.
In the and sections, find and uncomment the following:
Check to see that you have uncommented all Ldap configurations by doing a search for "Ldap" in the file.
Save and close the file.
In the temporary directory, open META-INF/weblogic-ejb-jar.xml and perform the following modifications:
Uncomment the "LdapPropertyManager" block: LdapPropertyManager
LdapPropertyManager True ${APPNAME}.BEA_personalization.LdapPropertyManager In the "Security configuration" section of the file, uncomment the LdapPropertyManager method:
LdapPropertyManager * Check to see that you have uncommented all Ldap configurations by doing a search for "Ldap" in the file.
Save and close the file.
Replace the original p13n_ejb.jar with the modified version.
Rename the original p13n_ejb.jar to use it as a backup. For example, rename it to p13n_ejb.jar.backup.
JAR the temporary version of p13n_ejb.jar to which you made changes. Name it p13n_ejb.jar.
Copy the new JAR to your application‘s root directory.
Start the server and re-deploy the application.
The properties from your LDAP server are now accessible through the WebLogic Portal API, JSP tags, and controls.
If you want to surface the properties from your LDAP server in the WebLogic Administration Portal (for use in defining rules for personalization, delegated administration, and visitor entitlements), create a user profile property set called ldap.usr, and create properties in the property set that exactly match the names of the LDAP properties you want to surface.
Enabling SUBTREE_SCOPE Searches for Users and Groups
The LdapPropertyManager EJB in p13n_ejb.jar allows for the inspection of the LDAP schema to determine multi-valued versus single-value LDAP attributes, to allow for multiple userDN/groupDN, and to allow for SUBTREE_SCOPE searches for users and groups in the LDAP server. Following are more detailed explanations:
The determination of multi-value versus single-value LDAP attributes allows a developer to configure the ejb-jar.xml deployment descriptor for the LdapPropertyManager EJB to specify that the LDAP schema be used to determine if a property is single- or multi-value.
To enable SUBTREE-SCOPE for users and groups:
Stop the server.
Extract p13n_ejb.jar from your application root directory to a temporary directory and edit the temporary META-INF/ejb-jar.xml by setting the following env-entries.
config/detectSingleValueFromSchema java.lang.Boolean true config/singleValueSchemaAttribute java.lang.String SINGLE-VALUE It is not recommended that true be used for config/detectSingleValueFromSchema unless you are going to write rules that use multi-valued LDAP attributes that have a single value. Using config/detectSingleValueFromSchema = true adds the overhead of checking the LDAP schema for each attribute instead of the default behavior (config/detectSingleValueFromSchema = false), which only stores an attribute as multi-valued (in a Collection) if it has more than one value.
This feature also implements changes that allow you to use SUBTREE_SCOPE searches for users and groups. It also allows multiple base userDN and groupDN to be specified. The multiple base DN can be used with SUBTREE_SCOPE searches enabled or disabled.
A SUBTREE_SCOPE search begins at a base userDN (or groupDN) and works down the branches of that base DN until the first user (or group) is found that matches the username (or group name).
To enable SUBTREE_SCOPE searches you must set the Boolean config/objectPropertySubtreeScope env-entry in the ejb-jar.xml for p13n_ejb.jar.jar to true and then you must set the config/userDN and config/groupDN env-entry values to be equal to the base DNs from which you want your SUBTREE_SCOPE searches to begin.
For example, if you have users in ou=PeopleA,ou=People,dc=mycompany,dc=com and in ou=PeopleB,ou=People,dc=mycompany,dc=com then you could set config/userDN to ou=People,dc=mycompany,dc=com and properties for these users would be retrieved from your LDAP server because the user search would start at the "People" ou and work its way down the branches (ou="PeopleA" and ou="PeopleB").
You should not create duplicate users in branches below your base userDN (or duplicate groups below your base groupDN) in your LDAP server. For example, your LDAP server will allow you to create a user with the uid="userA" under both your PeopleA and your PeopleB branches. The LdapPropertyManager in p13n_ejb.jar.jar will return property values for the first userA that it finds.
It is recommended that you do not enable this change (by setting config/objectPropertySubtreeScope to true) unless you need the flexibility offered by SUBTREE_SCOPE searches.
An alternative to SUBTREE_SCOPE searches (with or without multiple base DNs) would be to configure multiple base DNs and leave config/objectPropertySubtreeScope set to false. Each base DN would have to be the DN that contains the users (or groups) because searches would not go any lower than the base DN branches. The search would cycle from one base DN to the next until the first matching user (or group) is found.
The new ejb-jar.xml deployment descriptor is fully commented to explain how to set multiple DNs, multiple usernameAttributes (or groupnameAttributes), and how to set the objectPropertySubtreeScope flag.
Save and close the file.
Replace the original p13n_ejb.jar with the modified version:
Rename the original p13n_ejb.jar to use it as a backup. For example, rename it to p13n_ejb.jar.backup.
JAR the temporary version of p13n_ejb.jar to which you made changes. Name it p13n_ejb.jar.
Copy the new JAR to your application‘s root directory.
Start the server and re-deploy the application.
 
_xyz