Защищённые маршруты и редиректы по авторизации
На этой странице
Защищённый маршрут показывает страницу только авторизованному (или имеющему роль) пользователю, а остальных перенаправляет на вход с сохранением адреса возврата. На клиенте это делают компонентом-обёрткой (<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)
Сервер проверяет доступ всегда