The client platform includes an implementation of the OSGi UserAdmin service. The UserAdmin service provides a mechanism for storing user definition, user credentials, user roles, and group information.
The UserAdmin service uses the OSGi Preferences mechanism for storage of this information. Since the OSGi Preferences mechanism uses the bundle number of the UserAdmin service to store user information, if the bundle number changes, the UserAdmin definitions will no longer be accessible. Operations such as starting the platform with the -clean
option can cause bundles to be re-numbered.
The UserAdmin service is primary mechanism that can be used by the Web container for storing user and role related information.
How are user definitions created?
User definitions are created programmatically leveraging the User Admin APIs.
How can user definitions be changed after deployment?
You can query UserAdmin settings after deployment using the preferences jobs supplied by the Client Management server. UserAdmin settings are located at /configuration/org.eclipse.core.runtime.preferences.OSGiPreferences.xx
is the bundle number of the UserAdmin bundle (org.eclipse.equinox.useradmin). See Getting an inventory of Eclipse preferences
for more information.
Use the following mechanisms to add, update, or delete user settings:
Since the storage mechanism contains some referential aspects, if the UserAdmin bundle has not already created any settings, it is not recommended that you create a new UserAdmin preferences tree for the plug-in, but that you only modify values for the existing tree. Changes to UserAdmin settings may not be available until the next platform restart.
Parent topic: Managing client configurations: XPD622