Protecting anonymous LLM-cost-bearing endpoints 

An anonymous frontend endpoint backed by nr-llm can trigger paid provider calls. Rejected requests, cache hits and local providers behave differently; size protection for the requests that can reach a paid provider. A single scripted attacker — or one careless crawler — can turn such an endpoint into an open cost faucet.

nr-llm's per-user budgets check usage attributed to a positive backend-user ID. An anonymous call without that identity does not automatically have a user budget. These preflight checks do not reserve spend atomically, so concurrent calls can exceed a threshold. They also do not limit an attacker's request rate. The consuming extension must protect its own endpoint with rate limits and, where required, a shared cost limit with atomic reservations.

This page shows the three patterns to apply. They are small, build only on TYPO3 core and Symfony primitives, and need no extra infrastructure.

Per-IP rate limiting 

TYPO3 core already depends on symfony/rate-limiter (core's own login rate limiting uses it) and ships a storage adapter that persists limiter state in the caching framework: TYPO3CMSCoreRateLimiterStorageCachingFrameworkStorage. The whole recipe is one service alias plus a  25-line class.

Require the component explicitly, since your code uses its classes directly:

Add the dependency
composer require symfony/rate-limiter
Copied!

Alias the Symfony storage interface to TYPO3's caching-framework-backed implementation:

Configuration/Services.yaml
services:
    _defaults:
        autowire: true
        autoconfigure: true
        public: false

    Symfony\Component\RateLimiter\Storage\StorageInterface:
        alias: TYPO3\CMS\Core\RateLimiter\Storage\CachingFrameworkStorage
Copied!

The limiter itself keys on the client IP resolved through the normalizedParams request attribute — a NormalizedParams instance TYPO3 sets on every frontend and backend request — which honors TYPO3's reverse-proxy configuration ($GLOBALS['TYPO3_CONF_VARS']['SYS']['reverseProxyIP']) instead of trusting REMOTE_ADDR blindly. The raw REMOTE_ADDR fallback only covers requests that never passed through TYPO3's request handling, such as unit tests:

Classes/Infrastructure/RequestRateLimiter.php
<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\Infrastructure;

use Psr\Http\Message\ServerRequestInterface;
use Symfony\Component\RateLimiter\RateLimiterFactory;
use Symfony\Component\RateLimiter\Storage\StorageInterface;
use TYPO3\CMS\Core\Http\NormalizedParams;

final readonly class RequestRateLimiter
{
    private RateLimiterFactory $rateLimiterFactory;

    public function __construct(
        StorageInterface $storage,
        int $limitPerMinute = 30,
        string $limiterId = 'myext_frontend',
    ) {
        $this->rateLimiterFactory = new RateLimiterFactory(
            [
                'id' => $limiterId,
                'policy' => 'sliding_window',
                'limit' => $limitPerMinute,
                'interval' => '1 minute',
            ],
            $storage,
        );
    }

    public function tooManyRequests(ServerRequestInterface $request): bool
    {
        $normalizedParams = $request->getAttribute('normalizedParams');

        $remoteIp = $normalizedParams instanceof NormalizedParams
            ? $normalizedParams->getRemoteAddress()
            : (string)($request->getServerParams()['REMOTE_ADDR'] ?? '');

        return !$this->rateLimiterFactory
            ->create($remoteIp)
            ->consume()
            ->isAccepted();
    }
}
Copied!

Design choices worth keeping:

  • sliding_window avoids the burst-at-window-boundary problem of the fixed_window policy: an attacker cannot double the effective rate by straddling two windows.
  • The limiter id partitions the counters. Give each cost-bearing endpoint its own id (and, if the costs differ, its own limit) by registering separately configured instances:
Configuration/Services.yaml — one limiter per endpoint
services:
    _defaults:
        autowire: true
        autoconfigure: true
        public: false

    MyVendor\MyExtension\Infrastructure\RequestRateLimiter: ~

    myext.rate_limiter.chat:
        class: MyVendor\MyExtension\Infrastructure\RequestRateLimiter
        arguments:
            $limiterId: 'myext_chat'
Copied!

The ~ (null) definition inherits everything from _defaults: with autowire: true the StorageInterface constructor argument resolves through the alias above, and the two scalar parameters keep their declared defaults. Without the _defaults block (or an explicit autowire: true on the definition) the container would fail to instantiate the service.

  • Where the limit value comes from — extension configuration, a site setting, or a constructor default — is your choice. If you read it from configuration, validate it at construction time and fail hard on a missing or non-positive value rather than silently running unlimited.

Rejecting cross-site requests 

Browsers implementing the Fetch Metadata spec send a Sec-Fetch-Site header with every request. Rejecting the value cross-site stops other origins from firing forged POSTs at your endpoint through visitors' browsers — a cost-exhaustion vector that per-IP limiting alone spreads across many victim IPs instead of stopping:

Classes/Infrastructure/FrontendRequestInspector.php
<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\Infrastructure;

use Psr\Http\Message\ServerRequestInterface;

final readonly class FrontendRequestInspector
{
    public function isCrossSiteRequest(
        ServerRequestInterface $request,
    ): bool {
        return $request->getHeaderLine('Sec-Fetch-Site') === 'cross-site';
    }
}
Copied!

The check fails open by design. A request without the header (an older browser, or a non-browser client such as curl) is not blocked. This is deliberate, not an oversight: all current browsers send the header automatically, so the check reliably covers the browser-mediated cross-site attack it targets, while non-browser clients — which never send Fetch Metadata — are exactly what the rate limiter above handles. Treat this check as defense in depth on top of the rate limiter, never as the sole protection.

Never-leak error shaping 

An anonymous endpoint must not reveal why a request was refused or what failed internally. Provider names, exception messages, configuration paths, and budget states are reconnaissance material. Shape every failure path to the same generic, translated message, and keep the diagnostic classification in server-side logs only. Do not log prompts, credentials or raw provider messages in this anonymous request boundary:

Controller action combining all three patterns
use InvalidArgumentException;
use Netresearch\NrLlm\Exception\NrLlmExceptionInterface;
use Psr\Http\Client\NetworkExceptionInterface;
use Psr\Http\Message\ResponseInterface;

// … inside the controller class:

public function searchAction(string $query = ''): ResponseInterface
{
    if ($this->requestInspector->isCrossSiteRequest($this->request)
        || $this->rateLimiter->tooManyRequests($this->request)
    ) {
        $this->view->assign('message', $this->translator->translate(
            'search.rateLimited',
            'Too many requests - please wait a moment and try again.',
        ));

        return $this->htmlResponse();
    }

    try {
        $answer = $this->queryFlow->answer(trim($query));
    } catch (NrLlmExceptionInterface | InvalidArgumentException
        | NetworkExceptionInterface $error
    ) {
        // This includes budget and guardrail policy outcomes.
        // Only a safe classification is logged, not the exception payload.
        $this->logger->warning('Anonymous AI request failed', [
            'exceptionClass' => $error::class,
        ]);
        $this->view->assign('message', $this->translator->translate(
            'search.error',
            'Something went wrong. Please try again later.',
        ));

        return $this->htmlResponse();
    }

    $this->view->assign('answer', $answer);

    return $this->htmlResponse();
}
Copied!

Two details matter:

  • Catch the common nr-llm exception marker as well as input-validation and streaming transport failures. Budget and guardrail policy outcomes do not all extend ProviderException. At this anonymous boundary they receive the same generic response; an interactive application may instead provide an explicit policy workflow. Inject a PSR logger into the controller. Unhandled exceptions follow TYPO3's configured error handling; a visible stack trace is not a general production guarantee.
  • Use the same response shape for the rate-limited and the failed path. Distinguishable responses let an attacker probe which control they tripped.

Reference implementation 

The nr_ai_search extension (Netresearch) applies all three patterns to its anonymous search and chat plugins: its RequestRateLimiter and FrontendRequestInspector classes in Classes/Infrastructure/ match the recipes above, with the limit read from extension configuration and a separately configured limiter id per controller.