The new docs.trellix.com features a modernized UI and AI-powered conversational search. Content is currently available in English, with additional languages expected in November 2026. We hope you enjoy the updated experience.

show ssl proxy stats decrypt all

Prev Next

The IPS Manager integrates an embedded rate limit service to protect RESTful APIs from high-throughput request floods and denial-of-service conditions. The service operates as an interceptor library using a two-stage defense model to evaluate incoming API traffic. The key capabilities of API rate limiting service are listed below:

  • Two-stage rate checking — Validates incoming requests against system-wide global throughput thresholds and granular client IP or Uniform Resource Identifier (URI) path rules.

  • Client identification — Inspects proxy and load balancer headers, such as X-Forwarded-For, to extract client IP addresses accurately

  • Throttling responses — Returns an HTTP 429 Too Many Requests status code, sets the X-RateLimit-Remaining header to 0, and includes a Retry-After header specifying the required wait time in seconds when a client exceeds limits.

  • CLI management — Allows administrators to enable or disable the service globally using the ipsmanager ratelimit CLI command

Request filtering and applicability

The rate limiting service specifically filters and processes requests containing the header: Client_Name: Hyperautomation

Important

By default, the rate limiting service is disabled.  It is recommended to enable it when using IPS Manager with the HyperAutomation NDR (Network Detection and Response) response action feature to ensure system stability and prevent service depletion.

Enabling the rate limit service

The API rate limiting service is disabled by default. Complete the following steps to configure and enable the service.

  1. Locate the configuration properties file in the IPS Manager installation directory:
    <IPS_MANAGER_INSTALL_DIR>/App/config/resources/ratelimit/sdkapi/ratelimit.properties

  2. Open the ratelimit.properties file in a text editor using administrative or root privileges.

  3. Update the rate-limiting state property:

    ratelimit.enabled=true

  4. Save the file and restart the IPS Manager service for the changes to take effect.