Appendix B Repository Properties Reference


Security properties

Description

Security property names begin with com.sybase.jaguar.security . Security entities can represent security profiles, used to configure SSL settings for server listeners, and security identities, used for intercomponent calls and interserver authentication. The com.sybase.jaguar.security.type property determines what type the entity is.

Not all security properties apply to both identities and profiles. If a property applies only to one or the other, the description will say so.


com.sybase.jaguar.description

Description

Specifies a text description of the identity or profile.

Syntax

desc

Where desc is the descriptive text.


com.sybase.jaguar.security.cachetime

Description

For profiles, specifies the time in seconds to cache SSL session parameters. Not used for identities.

Syntax

An integer value representing the cache timeout in seconds. If not set, the default is 28800 (which equals 8 hours).

See Also

com.sybase.jaguar.security.sesscachesize


com.sybase.jaguar.security.certname

Description

Specifies the name of the SSL certificate. This property is always required for security profiles. For identities, this property is required if the com.sybase.jaguar.security.qoss property specifies a security characteristic that requires mutual SSL authentication.

Syntax

The text of the certificate label, for example:

Sample1 Test ID

See Also

com.sybase.jaguar.security.qoss


com.sybase.jaguar.security.entrustinifile

Description

For profiles or identities that use Entrust PKI software to manage certificates, specifies the full path to the Entrust INI file that provides information on how to access Entrust.

Syntax

The full path to the file, for example on Windows platforms:

c:\program files\entrust\entrust.ini

Or on a UNIX platform:

/opt/Entrust/clients/entrust.ini

The actual path depends on where you or your system administrator have installed the Entrust software.

Usage

This property must be set when the com.sybase.jaguar.security.tokentype property is set to "entrust".


com.sybase.jaguar.security.entrustpassword

Description

For profiles or identities that use Entrust PKI software to manage certificates, specifies the password for access to the Entrust user profile.

Syntax

The password text. Values are encrypted in the repository.

Usage

This property must be set when the com.sybase.jaguar.security.tokentype property is set to "entrust".

See Also

com.sybase.jaguar.security.entrustuserprofile


com.sybase.jaguar.security.entrustuserprofile

Description

For profiles or identities that use Entrust PKI software to manage certificates, specifies the full path to the Entrust user profile, which is an operating system file.

Syntax

The full path to the file, for example on Windows platforms:

c:\my documents\entrust\CN=Sample Entrust User, O=Sybase, C=US.epf

Or on a UNIX platform:

/opt/Entrust/certs/CN=Sample Entrust User, O=Sybase, C=US.epf

The actual path depends on where you or your system administrator have created the Entrust profile.

Usage

This property must be set when the com.sybase.jaguar.security.tokentype property is set to "entrust".


com.sybase.jaguar.security.name

Description

Specifies the profile or identity name.

Syntax

app-name

Where app-name is the application name.


com.sybase.jaguar.security.passphrase

Description

For identities or profiles, specifies the password to access the Sybase certificate database.

Syntax

The password text. Values are encrypted in the repository.


com.sybase.jaguar.security.qoss

Description

For identities or profiles, specifies the name of the security characteristic to use. For profiles, the security characteristic determines the minimum level of security acceptable for an incoming connection. For identities, the security characteristic determines the minimum level of security acceptable for outgoing connections.

Syntax

If a value is specified, it must match the name of the security profile. The EAServer Security Administration and Programming Guide describes the available security profile names. The list of available profiles can be retrieved programmatically using the CtsSecurity::SSLServiceProvider interface.

For identities, if this property is not set, or set with no value, outgoing connections do not use SSL. For profiles, this property must be set to the name of a security characteristic.


com.sybase.jaguar.security.sesscachesize

Description

For profiles, specifies the size of SSL session cache. Not used for identities.

Syntax

An integer that specifies the number of SSL sessions to cache. If no value is specified, the default is the value of the com.sybase.jaguar.server.maxconnections server property.

See Also

com.sybase.jaguar.security.cachetime


com.sybase.jaguar.security.sessshare

Description

For profiles, specifies the maximum number of concurrent SSL sessions that can share the same session parameters. Not used for identities.

Syntax

An integer number. If no value is specified, the default is 10.


com.sybase.jaguar.security.specifiedidentity

Description

For an identity, specifies the user name to be used for component invocations or outgoing interserver connections.

Syntax

The user name.

See Also

com.sybase.jaguar.security.specifiedidentitypassphrase


com.sybase.jaguar.security.specifiedidentitypassphrase

Description

For an identity, specifies the password to be used for component invocations or outgoing interserver connections.

Syntax

The password text. Values are encrypted in the repository.

See Also

com.sybase.jaguar.security.specifiedidentity


com.sybase.jaguar.security.tokentype

Description

Specifies whether to use the Sybase SSL certificate database or an Entrust certificate.

Syntax

Allowable values are sybase and entrust .


com.sybase.jaguar.security.type

Description

Specifies the security entity type.

Syntax

Allowable values are:

Table 15-6: Security entity type values
Value To indicate
identity An identity
listener A security profile

 


Copyright © 2002 Sybase, Inc. All rights reserved.