Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide

Configuring Session Property Change Notifications

The session property change notification feature causes OpenSSO Enterprise to send a notification to all registered listeners when a change occurs to a specific session property. This feature takes effect when Enable Property Change Notifications is enabled (ON) in the OpenSSO Enterprise Console.

For example, in a single sign-on (SSO) environment, one OpenSSO Enterprise session can be shared by multiple applications. When a change occurs on a specific session property defined in the “Notification Properties” list, OpenSSO Enterprise sends a notification to all registered listeners.

All client applications participating in the SSO automatically get the session notification if they are configured in the notification mode. The client cached sessions are automatically updated based on the new session state (including the change of any session property, if there is any).

An application that wants to take a specific action based on a session notification can write an implementation of the SSOTokenListener interface and then register the implementation through the SSOToken.addSSOTokenListener method. For more information, see the Sun OpenSSO Enterprise 8.0 Developer’s Guide.

ProcedureTo Configure Session Property Change Notifications

  1. Log in to the OpenSSO Enterprise Console as amAdmin.

  2. Click Configuration, Global and then Session.

  3. On the Session page, set Enable Property Change Notifications to ON.

  4. On the Session page, add properties to the Notification Properties list.

    This list specifies the properties that cause OpenSSO Enterprise to send a notification to registered listeners when a change to a property occurs.

    In New Value, add each property for which you want a notification sent when the property is changed, and then click Add.

  5. When you have finished adding properties to the list, click Save.