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.
See Sun Java System Access Manager Policy Agent 2.2 User’s Guide for more information.
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.