Message Validation Cluster Properties

The following cluster properties configure message validation behavior on the gateway node or node cluster.
9-5
The following cluster properties configure message validation behavior on the 
Layer7 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
Layer7 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)
xsltcache.maxEntries
Maximum number of cached stylesheets loaded from URLs.
Default:
100
Requires a
Layer7 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
Layer7 API Gateway
restart for changes to take effect.