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

CharsetFilter

You can use this filter to convert the HTTP request query and body from one character set to another. If it is not possible to convert a body entirely, then the CharsetFilter tries to convert as much as possible, and replaces all non-convertible chars by a question mark ?.

The CharsetFilter only handles requests of the content type application/x-www-form-urlencoded.

The filter has the following trace group: BC.Tracer.DebugProfile.IW4CharSetFlt

Classname
 ch::nevis::isiweb4::filter::rewrite::CharsetFilter
Library
libRewriteFilters.so.1

ConvertFrom

  • Type: string: <Encoding>
  • Usage Constraints: equired
  • Default: basic
  • Description: Defines the charset to convert from. I.E. "UTF-8".

ConvertTo

  • Type: string: <Encoding>
  • Usage Constraints: required
  • Default: basic
  • Description: Defines the charset to convert to. I.E. ISO-8859-1.

ConvertQuery

  • Type: boolean
  • Usage Constraints: optional
  • Default: false
  • Description: Converts the query if set to true.

ConvertBody

  • Type: boolean
  • Usage Constraints: optional
  • Default: true
  • Description: Converts the body if set to true.

IncomingCharsetStrategy

  • Type: enum
  • Possible values: IGNORE, KEEP, CONVERT
  • Usage Constraints: optional
  • Default: CONVERT
  • Description: Defines the conversion strategy for the body, if the incoming charset was set but differs from the one set in the attribute ConvertFrom. The following values are available:
    • IGNORE: Ignore the incoming charset, always convert from ConvertFrom to ConvertTo;
    • KEEP: Keep the incoming charset, do not convert the body;
    • CONVERT: Try to convert from the incoming charset to ConvertTo.

You can find an example in the installed nevisProxy package (go to examples/various/CharsetFilter.example).