Customize the server to generate user image URIs

The ISIM Server can be customized to dynamically generate the location (URI) for the user images that are shown on user cards.

The user cards that are shown in the request access wizard can be configured to show an image associated with each user. The ISIM Server provides a plug-in that can be used to dynamically generate the location (URI) of a user image. It is based on one or more attributes of the user. Use the following sections to work with the configuration files or the configuration properties from the IBM Security Identity Manager virtual appliance console:

• To go to a custom file and edit, download or upload it, see Manage custom files.

• To go to a property file and edit, or upload, see Manage the server properties.

1. Open the enroleExtensionAttributes.properties file in the directories/data directory.
2. Add the following line in the file to enable the default plug-in.

   person.extension.classname = com.ibm.itim.dataservices.extensions.plugins.PersonExtensionPlugin

   See Manage the server properties.
3. Set a value for the URI of the picture of each user. For example, if all your people images are stored on the web server, images.myserver.com under the /uid directory, then the configuration is as shown in the following example.

   plugin.person.erImageURI=http://images.myserver.com/uid/${uid}.jpg

   Variables that refer to other attributes can be included in the URI, for example, ${uid}. The variables are replaced with the real attribute values of the user at run time.

4. Optional: Set a value for the default URI in case we cannot do any substitution. For example, if the uid attribute is not set for the user, then we cannot substitute any other values. As a result, the default URI is returned.

   plugin.person.erImageURI.default=http://images.myserver.com/default.jpg

5. When you finish your customization, save and close the property file.

6. Log in to the Identity Service Center user interface.

7. From the Home page, click Request Access to open the Select user page.

Your customization updates are shown in the user card in the Select user page with the associated picture.

We can also write a custom plug-in that generates the picture URI for each person. See the Readme.html in the extensions.zip file at directories/utilities for instructions about compiling the supplied example plug-in.

Parent topic: Request Access wizard