Sentry-Javascript: Pominięcie middleware przy użyciu trasy tunelu

Wpływ

Opcja tunnelRoute sprawia, że pakiet SDK wysyła zdarzenia z przeglądarki na ścieżkę na Twoim własnym serwerze Next.js (na przykład /monitoring), gdzie reguła rewrite przekazuje je do Sentry, aby zapobiec ich blokowaniu przez programy blokujące reklamy. Aby te żądania kopertowe (envelope) nie zostały odrzucone przez oprogramowanie middleware, pakiet SDK pomija dla nich middleware.

Pominięcie middleware było szersze niż reguła rewrite. Rewrite obsługuje wyłącznie żądania do samej ścieżki tunelu z ustawionymi parametrami o oraz p. Pominięcie dotyczyło natomiast wszystkiego pod ścieżką tunelu. Żądania trafiające w tę lukę trafiają do Twojej aplikacji zamiast do Sentry, a middleware nigdy nie jest dla nich uruchamiane.

Pominięcie middleware nie nadaje żądaniu żadnych uprawnień. Trasy, które weryfikują sesję po stronie serwera, pozostają chronione.

Problem dotyczy Cię tylko wtedy, gdy spełnione są wszystkie poniższe warunki:

1. opcja tunnelRoute jest ustawiona (ścieżka w postaci ciągu znaków lub true),
2. Twoja aplikacja jest budowana przy użyciu webpack (kompilacje z Turbopack nie są dotknięte problemem),
3. pewna trasa Twojej aplikacji jest rozwiązywana pod ścieżką tunelu. Może to być bezpośrednia kolizja (/monitoring/foo z tunnelRoute: '/monitoring') lub dynamiczny segment w katalogu głównym tras (app/[locale]/…), który pasuje do każdego pierwszego segmentu ścieżki, oraz
4. Twoje middleware jest jedynym miejscem wymuszającym autoryzację dla tych tras.

Własne usługi Sentry oraz dane w Twojej organizacji Sentry nie są dotknięte problemem.

Poprawki

Naprawiono w 9.47.2, 10.75.2 oraz 11.0.0-rc.1. Pominięcie dopasowuje teraz wyłącznie te żądania, które rewrite tunelu rzeczywiście obsługuje. Zmiana konfiguracji nie jest wymagana.

Obejścia

• Ustaw tunnelRoute na ścieżkę, pod którą żadna z Twoich tras nie może się rozwiązać, lub usuń tę opcję.
• Buduj aplikację za pomocą Turbopack (domyślne dla next build od Next.js 16).
• Wymuszaj autoryzację na poziomie trasy, layoutu lub ścieżki dostępu do danych, a nie wyłącznie w middleware.