Package io.envoyproxy.envoy.config.core.v3

Interface CelExpressionConfigOrBuilder

All Superinterfaces:
com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder
All Known Implementing Classes:
CelExpressionConfig, CelExpressionConfig.Builder
public interface CelExpressionConfigOrBuilder extends com.google.protobuf.MessageOrBuilder

  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    getEnableStringConcat()
    Enable string concatenation for CEL expressions.
    boolean
    getEnableStringConversion()
    Enable string conversion functions for CEL expressions.
    boolean
    getEnableStringFunctions()
    Enable string manipulation functions for CEL expressions.

    Methods inherited from interface com.google.protobuf.MessageLiteOrBuilder

    isInitialized

    Methods inherited from interface com.google.protobuf.MessageOrBuilder

    findInitializationErrors, getAllFields, getDefaultInstanceForType, getDescriptorForType, getField, getInitializationErrorString, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, getUnknownFields, hasField, hasOneof

  • Method Details

    • getEnableStringConversion

      boolean getEnableStringConversion()
       Enable string conversion functions for CEL expressions. When enabled, CEL expressions
 can convert values to strings using the ``string()`` function.

 .. attention::

   This option is disabled by default to avoid unbounded memory allocation.
   CEL evaluation cost is typically bounded by the expression size, but converting
   arbitrary values (e.g., large messages, lists, or maps) to strings may allocate
   memory proportional to input data size, which can be unbounded and lead to
   memory exhaustion.
      bool enable_string_conversion = 1;
      Returns:
      The enableStringConversion.

    • getEnableStringConcat

      boolean getEnableStringConcat()
       Enable string concatenation for CEL expressions. When enabled, CEL expressions
 can concatenate strings using the ``+`` operator.

 .. attention::

   This option is disabled by default to avoid unbounded memory allocation.
   While CEL normally bounds evaluation by expression size, enabling string
   concatenation allows building outputs whose size depends on input data,
   potentially causing large intermediate allocations and memory exhaustion.
      bool enable_string_concat = 2;
      Returns:
      The enableStringConcat.

    • getEnableStringFunctions

      boolean getEnableStringFunctions()
       Enable string manipulation functions for CEL expressions. When enabled, CEL
 expressions can use additional string functions:

 * ``replace(old, new)`` - Replaces all occurrences of ``old`` with ``new``.
 * ``split(separator)`` - Splits a string into a list of substrings.
 * ``lowerAscii()`` - Converts ASCII characters to lowercase.
 * ``upperAscii()`` - Converts ASCII characters to uppercase.

 .. note::

   Standard CEL string functions like ``contains()``, ``startsWith()``, and
   ``endsWith()`` are always available regardless of this setting.

 .. attention::

   This option is disabled by default to avoid unbounded memory allocation.
   Although CEL generally bounds evaluation by expression size, functions such as
   ``replace``, ``split``, ``lowerAscii()``, and ``upperAscii()`` can allocate memory
   proportional to input data size. Under adversarial inputs this can lead to
   unbounded allocations and memory exhaustion.
      bool enable_string_functions = 3;
      Returns:
      The enableStringFunctions.