Sun Java System Access Manager 7.1 Developer's Guide

Client Detection APIs

Access Manager is packaged with Java APIs which can implement the client detection functionality. The client detection APIs are contained in a package named com.iplanet.services.cdm . This package provides the interfaces and classes you need to retrieve client properties. The client detection procedure entails defining the client type characteristics and implementing the client detection API within the external application.

The client detection capability is provided by ClientDetectionInterface, a pluggable interface (not an API invoked by a regular application). ClientDetectionInterface provides a getClientType method. The getClientType method extracts the client data from the browser’s incoming HttpRequest, matches the user agent information and returns the ClientType as a string. Upon successful authentication, the client type is added to the user’s session token. The ClientDetectionException handles any error conditions.