Skip to main content
Version: 8.2411.x.x RR

Appendix H - Deprecation List

This page lists every currently deprecated functionality of nevisProxy, with also a planned removal date. Check regularly if your current configuration is concerned about these planned removals. If one of the below feature is still used in your setup, then there is also a deprecation notice in the navajo log file, either during startup or during incoming request. If you are affected, adapt your configuration by using a replacement or contact support if you depend on the deprecated functionality.

The ContentType parameters of the EncryptionFilter​

Replacement:

  • ContentTypes.html instead of ContentTypeHTML
  • ContentTypes.javascript instead of ContentTypeJavaScript
  • ContentTypes.css instead of ContentTypeStyleSheet

Deprecated since: before LTS19
Plan to remove: version 8.x

ServerAdmin attribute of the Server tag​

Replacement: no replacement
Deprecated since: 5.2.0
Plan to remove: version 8.x

The path attribute of the Context tag​

Replacement: no replacement
Deprecated since: 5.2.0
Plan to remove: version 8.x

The SSLCertificateChainFile attribute of the SSL tag​

Replacement: Use the SSLCertificateFile Apache directive instead.
Deprecated since: 5.3.0
Plan to remove: version 8.x

The SSLRequire attribute of the SSL tag​

Replacement: in general replaced by the Require expression by Apache.
Deprecated since: Before LTS19
Plan to remove: version 8.x

The Protocol parameter of the HttpConnectorServlet​

Replacement: no replacement
Deprecated since: 8.2405.0
Plan to remove: version 8.x

The Loglevel attribute of the Server tag​

Replacement: Use LogLevel instead
Deprecated since: 8.2405.0
Plan to remove: version 8.x

The AwaitingResponse parameter of the HttpConnectorServlet​

Replacement: no replacement
Deprecated since: 8.2405.0
Plan to remove: version 9.x

The LegacyRegexpMatching parameter of the HttpConnectorServlet​

Replacement: no replacement
Deprecated since: 8.2405.0
Plan to remove: version 9.x

The CheckAlwaysClientCert parameter of the IdentityCreationFilter and SecurityRoleFilter​

Replacement: no replacement
Deprecated since: 8.2411.0
Plan to remove: version 9.x

Description​

  • Type: boolean
  • Usage Constraints: optional, basic feature
  • Default: false
  • If the client presents a certificate during the first login request, then there is a check to confirm that the same certificate is present during subsequent requests. This check can be disabled by setting the attribute to false.

The H2SerializeHeaders attribute of the H2 tag in navajo.xml​

Replacement: no replacement
Deprecated since: 8.2411.0
Plan to remove: version 9.x

ch.nevis.navajo.SessionCleanupWaitTimeout​

Replacement: use ch.nevis.navajo.ListenerWaitTimeout instead
Deprecated since: 8.2411.0
Plan to remove: version 9.x

Description​

Type: Integer
Unit: msec
Default: 30000

The maximal time to wait for a reaper-call, before shutting down an instance.

ch.nevis.isiweb4.auth.ExternalHint​

Replacement: use request:reauthenticate() instead
Deprecated since: 8.2411.0
Plan to remove: version 9.x

Description​

Attribute recognized by the IdentityCreationFilter. May be used to temporarily lock an authenticated session in a Lua script. Example:

request:setAttribute("ch.nevis.isiweb4.auth.ExternalHint", "lock")

org.apache.request.ParsedUri​

Replacement: The parameter AllowEncodedSlashes may be used instead
Deprecated since: 8.2411.0
Plan to remove: version 9.x

Description​

Type: Boolean
Default: true

If set to true, this parameter decodes the encoded URI of an incoming request for internal nevisProxy processing. For example the parameter turns the URI /UIFont%20CMSStyle.swift into /UIFont CMSStyle.swift, as %20 stands for ' '. If set to false, the parameter does not modify anything and forwards the undecoded URI unchanged.

This parameter is directly related to the parameter URLEncoding of the servlet HttpConnectorServlet. The URLEncoding parameter encodes the outgoing URI from nevisProxy to the back-end application. We highly recommend setting both parameters to true. If your setup requires one of the parameters to be false, set the other one to false too, on all HttpConnectorServlets. The parameter URLEncoding can also be set to false centrally by adding the code line ch.nevis.isiweb4.servlet.connector.http.URLEncoding=false to the bc.properties configuration file.

The Lua request method getRequestUri​

Replacement: Use the method getRequestPath instead
Deprecated since: 8.2411.0
Plan to remove: version 9.x

Description​

Returns the URI of the request. The URI consists of the context path, the servlet path and the path info, if given.

The Lua request method setRequestUri​

Replacement: Use the method setRequestPath combined with setQuery instead
Deprecated since: 8.2411.0
Plan to remove: version 9.x

Description​

Sets the URI of the request. Only use this method for modifying the request URI of a side call request, as the modification of the original request's URI may result in undefined behavior.

request:setRequestUri("/set/side/call/uri")