Українська
Перехоплювач і охоронці маршрутів
Крок 1. Перехоплювач
Навіщо. Кожен виклик API, окрім анонімних кінцевих точок автентифікації, потребує Authorization: Bearer <token>. Додавання заголовка в кожен метод служби повторило б той самий рядок сорок разів і один раз про нього забуло б. Перехоплювач (interceptor) стоїть у конвеєрі HttpClient, як проміжне програмне забезпечення ASP.NET Core або DelegatingHandler: він бачить кожен запит на виході й кожну відповідь на поверненні.
Перехоплювач також обробляє прострочений токен. Проактивний таймер AuthService робить це рідкісним, але ноутбук, що спав годину, прокидається з мертвим токеном. Тоді API відповідає 401, а перехоплювач один раз оновлює токен і повторює запит. Користувач нічого не помічає.
Що зробити. Створіть перехоплювач:
ts
import { HttpErrorResponse, HttpInterceptorFn, HttpRequest } from '@angular/common/http';
import { inject } from '@angular/core';
import { Router } from '@angular/router';
import { catchError, from, switchMap, throwError } from 'rxjs';
import { AuthService } from './auth.service';
/** Auth routes that don't take a bearer token (the refresh cookie is enough, or nothing is). */
const ANONYMOUS = [
'/api/auth/register',
'/api/auth/login',
'/api/auth/refresh',
'/api/auth/logout',
];
function withToken(req: HttpRequest<unknown>, token: string | null): HttpRequest<unknown> {
return token ? req.clone({ setHeaders: { Authorization: `Bearer ${token}` } }) : req;
}
/**
* Adds the bearer token to /api calls and sends cookies to /api/auth. On a 401 it refreshes the
* session once and retries; if that fails the user is signed out.
*/
export const authInterceptor: HttpInterceptorFn = (req, next) => {
if (!req.url.startsWith('/api/')) {
return next(req);
}
if (req.url.startsWith('/api/auth/')) {
req = req.clone({ withCredentials: true });
}
if (ANONYMOUS.includes(req.url)) {
return next(req);
}
const auth = inject(AuthService);
const router = inject(Router);
const sentToken = auth.accessToken();
return next(withToken(req, sentToken)).pipe(
catchError((error: unknown) => {
if (!(error instanceof HttpErrorResponse) || error.status !== 401) {
return throwError(() => error);
}
// Another request may already have refreshed the session while this one was in flight.
const current = auth.accessToken();
const retryToken =
current && current !== sentToken ? Promise.resolve(current) : auth.refresh();
return from(retryToken).pipe(
switchMap((token) => {
if (!token) {
auth.endSession(router.url);
return throwError(() => error);
}
return next(withToken(req, token));
}),
);
}),
);
};- Функція, а не клас.
HttpInterceptorFn– це(req, next) => Observable<HttpEvent>.inject()працює всередині неї, бо Angular виконує перехоплювачі в контексті впровадження. Перехоплювачі на основі класів (HTTP_INTERCEPTORS) досі існують, але потребують більше церемоній. - Зачіпаються лише виклики
/api/; запит до іншого вузла або до статичного файла ніколи не отримує токена. withCredentials: trueдля/api/auth/– кінцеві точки автентифікації читають і записують cookie оновлення. Через проксі виклики мають те саме джерело, і браузер надіслав би cookie й так; прапорець зберігає працездатність, якщо API колись опиниться на іншому джерелі.- Кінцеві точки з
ANONYMOUSне отримують токена: уregisterіloginйого ще немає,refreshіlogoutпрацюють із cookie. Токен на них не зашкодив би, але 401 від них не повинен запускати оновлення –refresh, що оновлює сам себе, зациклився б. - Запити незмінні.
req.clone({ setHeaders: … })повертає новий запит; оригінал ніколи не змінюється. - Після 401 перехоплювач порівнює токен, який він надіслав, із поточним. Якщо тим часом оновив інший запит, поточний токен уже новий і його використовують одразу; інакше викликається єдине спільне
auth.refresh().from(promise)перетворює Promise на Observable, аswitchMapзамінює невдалу відповідь повтореним запитом. - Без циклу. Повтор викликає
next(...), решту конвеєра після цього перехоплювача, а не зновуHttpClient. Якщо повторений запит теж отримає 401, помилка просто піде до викликача. - Невдале оновлення означає, що сесії немає:
endSession(router.url)відправляє користувача на сторінку входу й запам’ятовує, де він був.
Оператори RxJS в одному абзаці
observable.pipe(op1, op2) будує новий Observable зі старого, так само як ланцюжок методів LINQ будує нову послідовність. catchError(fn) замінює помилку іншим Observable (тут – повтором), throwError(() => error) – це Observable, що лише завершується помилкою, а switchMap(fn) відображає кожне значення на новий Observable і продовжує вже з ним. Теми 17 і 18 додають debounceTime, distinctUntilChanged і filter.
Протестуйте його:
ts
import {
HttpClient,
HttpErrorResponse,
provideHttpClient,
withInterceptors,
} from '@angular/common/http';
import { HttpTestingController, provideHttpClientTesting } from '@angular/common/http/testing';
import { TestBed } from '@angular/core/testing';
import { provideRouter } from '@angular/router';
import { firstValueFrom } from 'rxjs';
import { ME, settle } from '../../../testing/fakes';
import { authInterceptor } from './auth.interceptor';
import { AuthService } from './auth.service';
const response = (token: string) => ({
accessToken: token,
accessTokenExpiresAt: new Date(Date.now() + 15 * 60_000).toISOString(),
user: ME,
});
describe('authInterceptor', () => {
let http: HttpClient;
let backend: HttpTestingController;
let auth: AuthService;
beforeEach(async () => {
TestBed.configureTestingModule({
providers: [
provideHttpClient(withInterceptors([authInterceptor])),
provideHttpClientTesting(),
provideRouter([{ path: '**', children: [] }]),
],
});
http = TestBed.inject(HttpClient);
backend = TestBed.inject(HttpTestingController);
auth = TestBed.inject(AuthService);
const login = auth.login({ login: 'alice', password: 'x' });
backend.expectOne('/api/auth/login').flush(response('token-1'));
await login;
});
afterEach(() => backend.verify());
it('adds the bearer token to API calls', async () => {
const result = firstValueFrom(http.get('/api/me'));
const req = backend.expectOne('/api/me');
expect(req.request.headers.get('Authorization')).toBe('Bearer token-1');
req.flush(ME);
await result;
});
it('leaves anonymous auth calls alone but sends cookies', async () => {
const result = firstValueFrom(http.post('/api/auth/refresh', null));
const req = backend.expectOne('/api/auth/refresh');
expect(req.request.headers.has('Authorization')).toBe(false);
expect(req.request.withCredentials).toBe(true);
req.flush(response('token-2'));
await result;
});
it('does not touch requests outside /api', async () => {
const result = firstValueFrom(http.get('/assets/x.json'));
const req = backend.expectOne('/assets/x.json');
expect(req.request.headers.has('Authorization')).toBe(false);
req.flush({});
await result;
});
it('refreshes once on 401 and retries with the new token', async () => {
const result = firstValueFrom(http.get('/api/chats'));
backend.expectOne('/api/chats').flush(null, { status: 401, statusText: 'Unauthorized' });
await settle();
backend.expectOne('/api/auth/refresh').flush(response('token-2'));
await settle();
const retry = backend.expectOne('/api/chats');
expect(retry.request.headers.get('Authorization')).toBe('Bearer token-2');
retry.flush({ items: [] });
expect(await result).toEqual({ items: [] });
});
it('signs out when the refresh fails', async () => {
const result = firstValueFrom(http.get('/api/chats'));
backend.expectOne('/api/chats').flush(null, { status: 401, statusText: 'Unauthorized' });
await settle();
backend.expectOne('/api/auth/refresh').flush(null, { status: 401, statusText: 'Unauthorized' });
await expect(result).rejects.toBeInstanceOf(HttpErrorResponse);
expect(auth.isAuthenticated()).toBe(false);
});
it('does not loop when the retried request is rejected again', async () => {
const result = firstValueFrom(http.get('/api/chats'));
backend.expectOne('/api/chats').flush(null, { status: 401, statusText: 'Unauthorized' });
await settle();
backend.expectOne('/api/auth/refresh').flush(response('token-2'));
await settle();
backend.expectOne('/api/chats').flush(null, { status: 401, statusText: 'Unauthorized' });
await expect(result).rejects.toMatchObject({ status: 401 });
backend.expectNone('/api/auth/refresh');
});
});provideHttpClient(withInterceptors([authInterceptor]))будує той самий конвеєр, що й у застосунку.beforeEachвиконує вхід через справжнійAuthService, тож кожен тест починається з токенаtoken-1.- Тести повтору відповідають на перший запит 401, дають виконатися промісу перехоплювача (
await settle()), відповідають на оновлення й перевіряють, що повторений запит несеtoken-2. - «does not loop» знову відповідає на повтор 401 і через
expectNoneстверджує, що другого оновлення не було.
Крок 2. Охоронці маршрутів
Навіщо. Більшість сторінок мають сенс лише для користувача, що увійшов, а сторінки входу й реєстрації – лише для гостя. Охоронець маршруту (guard) виконується до того, як маршрутизатор активує маршрут, і або пропускає його, або перенаправляє. Це функція зручності користувача, а не безпеки: API перевіряє токен у кожному запиті, що б не показував клієнт.
Що зробити. Створіть охоронців. Маршрути теми 17 їх використовують.
ts
import { inject } from '@angular/core';
import { CanActivateFn, Router } from '@angular/router';
import { AuthService } from './auth.service';
/** Pages that need a session. The session is restored by an app initializer before routing. */
export const authGuard: CanActivateFn = (_route, state) => {
const auth = inject(AuthService);
if (auth.isAuthenticated()) {
return true;
}
return inject(Router).createUrlTree(['/login'], {
queryParams: state.url && state.url !== '/' ? { returnUrl: state.url } : undefined,
});
};
/** Sign-in and register pages: signed-in users go straight to their chats. */
export const guestGuard: CanActivateFn = () =>
inject(AuthService).isAuthenticated() ? inject(Router).createUrlTree(['/chats']) : true;CanActivateFn– функція, що повертаєtrue, щоб дозволити навігацію, абоUrlTree, щоб перенаправити. ПоверненняUrlTreeкраще, ніж викликrouter.navigateусередині охоронця: маршрутизатор скасовує поточну навігацію й чисто починає нову.authGuardзберігає запитаний URL у?returnUrl=, тож після входу користувач потрапляє туди, куди хотів.- Охоронці синхронні. Вони можуть такими бути, бо сесію відновлено до першої навігації – це наступний крок.
Крок 3. Відновлення сесії під час запуску
Навіщо. Коли сторінка завантажується, маршрутизатор одразу зіставляє URL і запускає охоронців. Якби restoreSession() ще чекала на API, authGuard побачив би гостя й перенаправив користувача, що увійшов, на /login. Ініціалізатор застосунку (app initializer) – це функція, яку Angular виконує – і, якщо вона повертає Promise, чекає на неї – перед запуском маршрутизатора.
Що зробити. Замініть створений app.config.ts його остаточною версією:
ts
import { provideHttpClient, withInterceptors } from '@angular/common/http';
import {
ApplicationConfig,
inject,
provideAppInitializer,
provideBrowserGlobalErrorListeners,
} from '@angular/core';
import { provideRouter, withComponentInputBinding, withRouterConfig } from '@angular/router';
import { routes } from './app.routes';
import { authInterceptor } from './core/auth/auth.interceptor';
import { AuthService } from './core/auth/auth.service';
export const appConfig: ApplicationConfig = {
providers: [
provideBrowserGlobalErrorListeners(),
provideHttpClient(withInterceptors([authInterceptor])),
provideRouter(
routes,
withComponentInputBinding(),
// chats/:chatId/info reads :chatId from its parent route.
withRouterConfig({ paramsInheritanceStrategy: 'always' }),
),
// Turn the refresh cookie into a session before the first navigation runs the guards.
provideAppInitializer(() => inject(AuthService).restoreSession()),
],
};provideHttpClient(withInterceptors([authInterceptor]))вмикає перехоплювач у конвеєр кожногоHttpClientу застосунку.withComponentInputBinding()дозволяє маршрутизатору встановлювати параметри маршруту й параметри запиту як вхідні параметри компонентів: сторінка оголошуєchatId = input.required<string>()і отримує:chatId(теми 17 і 19).paramsInheritanceStrategy: 'always'робить параметри батьківських маршрутів видимими для дочірніх; панель відомостей про чат із теми 21 за адресоюchats/:chatId/infoчитає:chatIdвід батька. Поточні версії Angular типово використовують'always'(старіші використовували'emptyOnly'); явне налаштування документує, що панель на це покладається.provideAppInitializer(() => inject(AuthService).restoreSession())один раз під час запуску виконує оновлення й чекає на нього.restoreSessionніколи не генерує виняток, тож відвідувач без cookie просто починає без входу.
Перевірка
powershell
npm test -- --watch=false Test Files 4 passed (4)
Tests 19 passed (19)Запустіть API й клієнт (./Run.ps1 api, ./Run.ps1 web) і відкрийте http://localhost:4200 з відкритою вкладкою Network в інструментах розробника. Під час кожного завантаження надсилається рівно один запит: POST /api/auth/refresh, на який відповідь 401 Unauthorized, бо сесії ще немає. Сторінка лишається порожньою; сторінку входу додасть тема 17.