re:re:actable
Урок 134 минуты чтения

Защищённые маршруты и редиректы по авторизации

На этой странице
Кратко

Защищённый маршрут показывает страницу только авторизованному (или имеющему роль) пользователю, а остальных перенаправляет на вход с сохранением адреса возврата. На клиенте это делают компонентом-обёрткой (<RequireAuth> с <Navigate replace>) в декларативном режиме или проверкой в loader (throw redirect('/login?from=...')) в data mode — второй вариант лучше: проверка выполняется до рендера и загрузки данных страницы, без мигания. Главное правило: клиентская защита — это UX, а не безопасность. Код и маршруты SPA публичны, поэтому реальную проверку доступа делает сервер на каждом API-запросе. Пока статус сессии неизвестен, показывают загрузку, а не форму входа.

Вопрос

Как реализовать приватные страницы в React Router? Почему проверки на клиенте недостаточно?

Вариант 1: компонент-обёртка (declarative mode)

import { Navigate, Outlet, useLocation } from 'react-router';
import { useAuth } from './auth';
 
export function RequireAuth({ role }: { role?: 'admin' | 'editor' }) {
  const { user, status } = useAuth(); // status: 'loading' | 'authenticated' | 'guest'
  const location = useLocation();
 
  if (status === 'loading') return <p role="status">Проверяем сессию…</p>;
 
  if (!user) {
    // replace: кнопка «Назад» не вернёт на защищённую страницу
    return <Navigate to={`/login?from=${encodeURIComponent(location.pathname + location.search)}`} replace />;
  }
 
  if (role && !user.roles.includes(role)) return <Navigate to="/403" replace />;
 
  return <Outlet />;
}
<Routes>
  <Route path="/" element={<Home />} />
  <Route path="/login" element={<Login />} />
  <Route element={<RequireAuth />}>
    <Route path="/account" element={<Account />} />
    <Route path="/orders" element={<Orders />} />
  </Route>
  <Route element={<RequireAuth role="admin" />}>
    <Route path="/admin/*" element={<Admin />} />
  </Route>
</Routes>

Layout-маршрут без path с <Outlet /> защищает целую группу страниц одной обёрткой.

Вариант 2: проверка в loader (data mode)

import { redirect, type LoaderFunctionArgs } from 'react-router';
 
async function requireUser(request: Request) {
  const user = await getCurrentUser(); // запрос к /api/me с cookie
  if (!user) {
    const url = new URL(request.url);
    throw redirect(`/login?from=${encodeURIComponent(url.pathname + url.search)}`);
  }
  return user;
}
 
const router = createBrowserRouter([
  { path: '/login', lazy: () => import('./routes/login') },
  {
    id: 'protected',
    loader: ({ request }) => requireUser(request), // выполняется до рендера и до loaders детей
    children: [
      { path: 'account', lazy: () => import('./routes/account') },
      { path: 'orders', lazy: () => import('./routes/orders') },
    ],
  },
]);

Преимущества: нет кадра с защищённым UI, код страницы не загружается гостю, данные пользователя доступны детям через useRouteLoaderData('protected'). В framework mode тот же loader выполняется на сервере — это уже настоящая серверная проверка для рендера страницы.

Возврат после входа

function Login() {
  const [params] = useSearchParams();
  const navigate = useNavigate();
 
  async function onSubmit(formData: FormData) {
    await login(formData);
    const from = params.get('from');
    // Защита от open redirect: только внутренние пути
    const safe = from && from.startsWith('/') && !from.startsWith('//') ? from : '/account';
    navigate(safe, { replace: true });
  }
  // ...
}

Проверка from обязательна: иначе ссылка /login?from=https://evil.example превращает сайт в инструмент фишинга.

Почему это не безопасность

Пользователь может:
  • открыть DevTools и подменить user в стейте;
  • скачать JS-бандл и увидеть код админки;
  • отправить запрос к /api/admin/users напрямую.
→ Только сервер решает, отдать ли данные: проверка сессии и прав на каждом эндпоинте.

Чувствительные разделы (админку) можно вынести в отдельный бандл или приложение, но это снижает утечку кода, а не заменяет серверную авторизацию.

Частые ошибки

  • Редирект на /login, пока сессия ещё загружается, — «мигание» входа у авторизованного пользователя.
  • navigate('/login') в useEffect вместо <Navigate>/redirect — лишний рендер защищённого UI.
  • Нет replace — «Назад» снова ведёт на защищённую страницу и снова редиректит.
  • Хранение токена в localStorage — уязвимо к XSS; лучше HttpOnly-cookie.
  • Скрыть кнопку «Удалить» и считать операцию защищённой.

Мини-шпаргалка

Declarative: <Route element={<RequireAuth/>}> + <Outlet/> + <Navigate replace>
Data mode: loader → throw redirect('/login?from=...')
status === 'loading' → индикатор, не форма входа
from → только внутренние пути (open redirect)
Сервер проверяет доступ всегда

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам