New Features and Enhancements

This topic describes the major new features and significant enhancements to version 8.4. 
gateway84
This topic describes the major new features and significant enhancements to version 8.4. 
Description
Known Changes or Limitations
Notes
Java 8
Added support for Java 1.8.0 u40.
Thales HSM card and NetHSM
IMPORTANT:
If you are using the Thales HSM card or the NetHSM, do not upgrade to the 8.4 release. Instead, watch for a future release to upgrade for full compatibility.
Luna 5.1 HSM
Elliptic Curve SSL/TLS mutual authentication does not function with a Luna 5.1 HSM provider under Java 8. If you cannot use the RSA alternative, watch for a future release to upgrade for full compatibility.
Default Cipher Suites
The cryptography changes in Java 8 may change the default cipher suites. See JDK Security Enhancements documentation for details.
IBM WebSphere versions
Version limitations:
  • WebSphere Application Server 8.5 does not work with Java 8.
  • You can upgrade to WebSphere Application Server 8.5.5.5 (which works with Java 8). But at this time, the 8.5.5.5. client libraries from IBM have issues connecting to the message queue. Verify the IBM library fix before upgrading to Java 8. 
  • 7.0 client libraries do not work. Install the 7.1 libraries.
HashMap entry iteration order
Java 8 changes the iteration order of entries in some unsorted collections (HashMaps). The following areas are affected:
UDDI Registries
If you have a UDDI service with multiple endpoints, confirm the order. UDDI Business Service Name may not map to the correct WSDL Location.
Publishing a WSDL
If you publish a WSDL that defines multiple services, the published service may not be the same service that was published in a previous release of
API Gateway
. (This change does not affect publishing WSDLs that define only a single service).
Assertions
The ordering of some elements in XML and JSON documents, multivalued context variables, and other assertion output are affected. If you use the following assertions with policy logic that depends on a specific ordering of output, review the policies.
  • Validate OData Request
  • Apply JSON Transformation
  • Evaluate JSON Path Expression
WS-MAN
WS-MAN response messages can be affected.
Split Assertion
The Split assertion no longer includes a leading empty value in its multivalued output. A zero-length match at the start of the target string no longer results in a leading empty value. Positive-width matches still include the empty value as before. You can encounter this issue if you are using an empty (blank) pattern to split an input string such as "abc" into values "a", "b", "c". In previous releases of
API Gateway
, the resulting multivalued variable included four values: "", "a", "b", and "c". In
API Gateway
8.4, there are only three values: "a", "b", "c".
Custom Assertions
Important! Recompile any customer-developed custom assertions with the Java 8 SDK.
OTK 3.1.1
Adds support for Apache Cassandra 2.1.7. See CA API OAuth Toolkit.
Internationalization
The product supports various encoding, including single and multibyte characters. However, certain industry standards can have specific encoding requirements (for example, the HTTP specifications require that HTML headers and values be restricted to the ISO-8859-1 character set). Field lengths that are specified in this documentation apply equally to single and multibyte character sets. For example, a field with a maximum length of 32 characters can accept 32 English or Korean characters.