PUMA scenarios
Contents
1 Introduction to WebSphere Portal user management ..................................................... 2
1.1 Portal User Management Architecture...................................................................... 3
1.2 Supported user registries........................................................................................... 3
1.3 User management operations.................................................................................... 4
1.4 PUMA configuration ................................................................................................ 4
1.5 WMM configuration................................................................................................. 5
1.6 PUMA programming interface................................................................................. 5
2 Implementation scenarios for PUMA............................................................................. 6
2.1 Creating a user management portlet using the PUMA SPI....................................... 6
2.2 Adding a user.......................................................................................................... 10
2.3 Editing a user .......................................................................................................... 14
2.4 Deleting a user ........................................................................................................ 15
2.5 Adding a group ....................................................................................................... 16
2.6 Deleting a group...................................................................................................... 17
2.7 Adding a member to a group .................................................................................. 18
2.8 Removing a member from a group......................................................................... 21
2.9 Customizing password expiration........................................................................... 21
2.9.1 Alternate method for retrieving the data.......................................................... 31
3 Implementation scenario: User Agreement use case..................................................... 32
3.1 User Agreement form ............................................................................................. 32
3.2 Custom Log-in portlet............................................................................................. 33
3.3 Determining whether a user has signed the agreement........................................... 36
3.3.1 SingletonUserAgreement................................................................................. 36
3.4 Redirecting the user to the Agreement page........................................................... 38
3.5 Displaying the User Agreement form in the log-in portlet..................................... 39
4 Conclusion ..................................................................................................................... 41
5 Resources....................................................................................................................... 41
6 About the authors........................................................................................................... 41
1 Introduction to WebSphere Portal user management
WebSphere Portal features a powerful user management component that lets you connect it to
various user repositories. Although these user repositories contain the actual users and groups
data, it is the Portal User Management Architecture (PUMA) component that is key to
manipulating the data in the user repositories for the users of WebSphere Portal.
We begin with an introduction to PUMA and the operations and configurations that are possible.
The main part of the paper describes how to use a public API to implement custom scenarios with
code samples, and how to customize the existing forms and screens for custom user
management.
Among the forms and screens is the User Agreement form, the Password expiration screen, and
the Self Registration/Edit Profile screens. Finally, we create a User Agreement form use case that
forces users to sign before accessing the protected pages.
To get the most from this white paper, you should have a general understanding of WebSphere
Portal administration and security setup. Although this paper focuses on version 6.0.x, the main
2
