Skip to content
CA API Gateway - 9.3
Documentation powered by DocOps

Message Validation Cluster Properties

Last update August 1, 2018

The following cluster properties configure message validation behavior on the CA API Gateway node or node cluster.

Property

Description

json.evalJsonPathAcceptEmptyArray

Preserves the backward compatibility in resulting empty arrays. If this property value is set to false, the assertion is falsified for empty arrays.

Default: true

json.evalJsonPathWithCompression

This property controls the 'escaping' of forward slashes in JSON objects. If a JSON object contains a forward slash in the JSON object input, then the Gateway adds a backslash to escape the forward slash in the JSON output.

By default, escaping is enabled. To prevent the escaping (that is, remove the extra backslash), set this property to true.

Default: false

jwt.showAllAlgorithms See "Cluster Properties" in Encode JSON Web Token Assertion for details.

messageCache.
diskThreshold

Message size threshold to be cached on disk. Used by the Store to Cache assertion.

Default: 8096 (bytes)

messageCache.
resetGeneration

Clears the caches created by the Store to Cache assertion without needing to restart the CA API Gateway.

To clear the caches, increment the value of this property. All caches created under a different generation number are cleared. For example, changing this property to "1" clears all caches created when this property was set to "0". Changing it to "2" will clear the caches created under "1", etc.

Default: 0

schema.allowDoctype

Enables use of a document type definition (DTD) in XML schemas.

Default: false

schema.
hardwareTargetNamespaces

XML schemas to load to hardware, identified by their target namespace. Separate each schema with a space.

Default: http://schemas.xmlsoap.org/soap/envelope/ http://www.w3.org/2003/05/soap-envelope

schema.
remoteResourceRegex

Regular expression matching the URLs from which remote XML schema dependencies may be downloaded.

Default: .* (period followed by an asterisk)

schema.
softwareFallback

Controls whether to use software XML parsing when hardware parsing fails. Value is a Boolean.

  • true = try software parsing if hardware parsing fails

  • false = do not try software parsing; return failure if hardware parsing fails

Default: true

Disabling the fallback to software can increase performance in situations where you expect frequent XML failures. However, under certain circumstances, the XML can fail even though it is correct.

schemacache.
maxAge

Maximum age of cached XML schema documents that have been downloaded from a URL.

Default: 30000 (milliseconds)

schemacache.
maxEntries

Maximum number of cached XML schema documents loaded from URLs. Enter zero to disable caching.

Default: 100

schemacache.
maxSchemaSize

Maximum size of a schema document download. Enter zero for an unlimited size.

Default: 10485760 (bytes)

schemacache.
maxStaleAge

Maximum age of expired cached XML schema documents loaded from URLs. A setting of "-1" indicates no expiry.

Default: -1 (milliseconds)

schemacache.
recompileLatency

Minimum time between two consecutive rebuilds of the hardware schema table (to prevent continuous rebuilding).

Default: 10000 (milliseconds)

schemacache.
recompileMaxAge

Maximum time to wait for additional schemas to stop arriving for a schema hardware cache rebuild.

Default: 20000 (milliseconds)

schemacache.
recompileMinAge

Time to wait for additional schemas (after becoming hardware eligible) before triggering a batch rebuild of the hardware schema table. Schema status changes often occur in clumps.

Default: 500 (milliseconds)

xsltcache.maxAge

Maximum age of cached stylesheets loaded from URLs. Enter zero to disable caching.

Default: 300000 (milliseconds)

Requires a CA API Gateway restart for changes to take effect.

xsltcache.maxEntries

Maximum number of cached stylesheets loaded from URLs.

Default: 100

Requires a CA API Gateway restart for changes to take effect.

xsltcache.maxStaleAge

Maximum expiration for cached stylesheets loaded from URLs. A setting of "-1" indicates no expiry.

Default: -1 (milliseconds)

Requires a CA API Gateway restart for changes to take effect.

Was this helpful?

Please log in to post comments.