Single Sign-on Properties (Sun Java System Access Manager 7.1 C API Reference)

Sun Java System Access Manager 7.1 C API Reference

Single Sign-on Properties

Certain properties must be read and passed to am_sso_init() in order to initialize the Session Service. Thus, am_sso_init() must be called before any other single sign-on interface. By default, the properties file used for initializing the Session Service is AMAgent.properties, located in /AccessManager-base/SUNWam/config/. This file is created during the process for installing a web agent. Before using the API be sure the properties in the following table are set in AMAgent.properties.

Note –

See Sun Java System Access Manager Policy Agent 2.2 User’s Guide for more information.

Table 4–1 Single Sign-on Properties in AMAgent.properties


Property	Definition
`com.sun.am.naming.url`	Specifies the URL for the Naming Service which, in turn, finds the URL of the Session Service. This property must be set as: `com.sun.am.naming.url = protocol://AM_host.domain:port/amserver/namingservice`
`com.sun.am.notification.enable`	Specifies whether the Notification Service will be used to update the cache. If enabled, a URL where notification messages from Access Managerare sent must be specified. This property is set as: `com.sun.am.notification.enable = true \| false` Note – If `com.sun.am.notification.enable` is not found in the properties file, the default value is `false`.
`com.sun.am.notification.url`	If `com.sun.am.notification.enable` is set to true, the value of this property specifies a URL where notification messages from Access Managerare sent. This property is set as: `com.sun.am.notification.url = protocol//AM_host.domain:port/notification_URL`
`com.sun.am.sso.polling.period`	Specifies how often, in minutes, the cache should be checked for entries that have reached the cache entry life time. This property must be set as: `com.sun.am.sso.checkCacheInterval=#` Note – By default, this property is not in `AMAgent.properties` but can be added when needed.
`com.sun.am.sso.max_threads`	Specifies the maximum number of threads the single sign-on API for C should invoke for handling notifications. The API maintains a thread pool and invokes a thread for each notification. If the maximum number of threads has been reached, the notification will wait until a thread is available. This property must be set as: `com.sun.am.sso.maxThreads=#` If not specified the default maximum number of threads is 10. Note – By default, this property is not in `AMAgent.properties` but can be added when needed.

For more information, see the Sun Java System Access Manager Policy Agent 2.2 User’s Guide.