Security cache settings

Use this page to configure the Web Services Secure Conversation (WS-SecureConversation) security local and distributed cache settings using the console. To view this console page, click Services > Security cache.

Time token is in cache after timeout

Sets the time that the token remains in cache after the token times out.

This field specifies the number of minutes for the time the token is in cache after the token expiration time expires (cache persist period). For example, if specified 30 minutes, the token is kept in cache for this time period after the token expiration time. The default value is 10 minutes, which is the minimum number of minutes allowed.

Information	Value
Data type:	Integer
Default:	10 (minutes)

Renewal interval before token timeout

Sets the time period before expiration that the client attempts to renew the token.

This field specifies the period of time, in minutes, before expiration that the client attempts to renew the token. This setting must specify a period of time that is longer than the time for the longest transaction or else the token might expire during the transaction. This time must include time for transport to and from the server, processing by the server, and any time delay that is because of time used for reliable messaging, when applicable. The default value is 10 minutes, which is the minimum number of minutes allowed.

If the Security Context Token is renewed too often, it might cause Web Services Secure Conversation (WS-SecureConversation) to fail or even cause an out-of-memory error to occur. It is required set the renewal interval before the token expires value for the security cache to a value less than the token timeout value for the Security Context Token. It is also suggested that the token timeout value be at least two times the renewal interval before the token expires value.

Information	Value
Data type:	Integer
Default:	10 (minutes)

Enable distributed caching

whether distributed caching is enabled or disabled. If distributed caching is enabled, select distributed cache settings.

Use this check box to specify whether to use distributed caching when the server is in a clustered environment and when the tokens are shared across the cluster.

Information	Value
Data type:	Check box
Default:	No distributed caching (unchecked)

When the checkbox is selected to enable distributed caching, choose one of the following settings for updating the caches.

Button	Resulting Action
Synchronous update of cluster members	Performs synchronous update of cache objects on cluster members (default).
Asynchronous update of cluster members	Performs a non-synchronous update of the cache on cluster members. This setting allows interoperability with cluster members that use the older style of updating as implemented in versions of IBM WebSphere Application Server prior to version 7.0.
Token recovery support	Assigns a shared data source as the distributed cache.

If token recovery support is selected as the update method, then you must select a cell level data source using the drop-down list. Token state data is saved in the database defined as the data source. If there are no available data sources in the list, click on Manage data sources to add one or more new data source objects. The data source object supplies an application with connections for accessing the database.

Custom Properties

Specifies additional configuration settings that the secure conversation client might require.

This table lists custom properties. Use custom properties to set internal system configuration properties. This collection is empty until the first custom property is defined.

Information	Value
Data type:	String

Select

Specifies to select further actions.

Use this check box to select custom properties for further actions. To manage existing custom properties, select the check box for the name, and then select one of the following actions:

Actions	Description
Edit	Select to modify an existing custom property. This action is not displayed until we have added at least one custom property.
Delete	Select to remove an existing custom property.

Information	Value
Data type:	Check box

New

Specifies to add and define a new custom property.

Click New to define a new custom property.

Information	Value
Data type:	Button

Name

Lists available custom properties.

This column displays the names of the custom properties that we can use with the secure conversation client (for example, exampleProperty). Custom properties are name-value pairs of data, where the name is a string representation of a property that is expected by the secure conversation client.

Information	Value
Data type:	String

Value

Lists the values of the custom properties.

This column displays the values of the custom properties (for example, true). Custom properties are name-value pairs of data, where the value is a string representation of the property setting.

Information	Value
Data type:	String

Related concepts

Secure conversation client cache and trust service configuration

Data source collection