Українська
Сесія
Крок 1. Де живуть токени
Навіщо. Тема 8 видала два токени, а тема 13 поклала токен оновлення в cookie HttpOnly з Path=/api/auth і SameSite=Strict. JavaScript узагалі не може прочитати це cookie – скрипт, упроваджений зловмисником, його не вкраде, – а браузер надсилає його лише до кінцевих точок автентифікації. Токен доступу надходить у тілі JSON відповідей login, register і refresh, і клієнт мусить десь його зберігати, щоб надсилати з кожним запитом.
Таблиця 16.2. Де вебклієнт може зберігати токен доступу
| Місце | Переживає перезавантаження | Може прочитати впроваджений скрипт | Chatex |
|---|---|---|---|
localStorage | так | так – викрадені токени лишаються дійсними 15 хвилин | ні |
| cookie | так | ні, якщо HttpOnly, але тоді воно надсилається автоматично, що потребує захисту від CSRF | лише для токена оновлення |
| пам’ять (поле служби) | ні | лише поки сторінка відкрита | так |
Зберігання токена доступу в пам’яті втрачає його під час кожного перезавантаження, і це нормально: під час запуску застосунок викликає POST /api/auth/refresh, браузер додає cookie, а API відповідає свіжим токеном доступу й профілем користувача. Сесія переживає перезавантаження завдяки cookie, а не сховищу.
Крок 2. AuthService
Навіщо. Одна служба володіє сесією: хто увійшов, поточний токен доступу, вхід і вихід та поновлення токена. Решта клієнта читає з неї користувача й просить у неї токен.
Найтонша частина – поновлення. API ротує токен оновлення при кожному використанні й вважає повторне використання старого крадіжкою: відкликає всі сесії користувача (тема 8). Якщо два запити помітять прострочений токен одночасно й обидва викличуть refresh, другий виклик подасть токен, який перший щойно замінив, – і користувача буде вилучено з усіх пристроїв. Тому оновлення має бути single-flight: щонайбільше один запит оновлення одночасно, спільний для всіх, кому він потрібен.
Що зробити. Створіть службу:
ts
import { Injectable, computed, inject, signal } from '@angular/core';
import { Router } from '@angular/router';
import { firstValueFrom } from 'rxjs';
import { AuthApi } from '../api/chatex-api';
import { AuthResponse, LoginRequest, MyProfileDto, RegisterRequest } from '../api/models';
/** Refresh this long before the access token expires. */
const REFRESH_AHEAD_MS = 60_000;
/** A token closer than this to expiry is refreshed before use. */
const MIN_TOKEN_LIFE_MS = 20_000;
/**
* Holds the session. The access token lives only in memory; the refresh token is an HttpOnly cookie
* the browser sends to /api/auth. Refreshing is single-flight: the server rotates the refresh token on
* every use and treats reuse of an old one as theft (it revokes every session), so two parallel
* refresh calls must never happen.
*/
@Injectable({ providedIn: 'root' })
export class AuthService {
private readonly api = inject(AuthApi);
private readonly router = inject(Router);
private readonly token = signal<string | null>(null);
private expiresAt = 0;
private refreshInFlight: Promise<string | null> | null = null;
private refreshTimer: ReturnType<typeof setTimeout> | undefined;
readonly user = signal<MyProfileDto | null>(null);
readonly isAuthenticated = computed(() => this.user() !== null && this.token() !== null);
/** Increases on every sign-out so other services can drop per-user caches. */
readonly sessionEpoch = signal(0);
accessToken(): string | null {
return this.token();
}
/** At startup: turn the refresh cookie (if any) into a session. Never throws. */
async restoreSession(): Promise<void> {
await this.refresh();
}
async login(body: LoginRequest): Promise<void> {
this.apply(await firstValueFrom(this.api.login(body)));
}
async register(body: RegisterRequest): Promise<void> {
this.apply(await firstValueFrom(this.api.register(body)));
}
/** Returns the new access token, or null (and signs out locally) when the session is gone. */
refresh(): Promise<string | null> {
this.refreshInFlight ??= this.doRefresh().finally(() => (this.refreshInFlight = null));
return this.refreshInFlight;
}
/** A token that is good for at least a few more seconds, refreshing when needed. */
async getValidToken(): Promise<string | null> {
const token = this.token();
if (token && this.expiresAt - Date.now() > MIN_TOKEN_LIFE_MS) {
return token;
}
return this.refresh();
}
async logout(): Promise<void> {
try {
await firstValueFrom(this.api.logout());
} catch {
// Signing out locally is what matters.
}
this.endSession();
}
async logoutAll(): Promise<void> {
await firstValueFrom(this.api.logoutAll());
this.endSession();
}
/** Clears the session and goes to the sign-in page (session expired, password changed, ...). */
endSession(returnUrl?: string): void {
this.clear();
void this.router.navigate(['/login'], {
queryParams: returnUrl && returnUrl !== '/' ? { returnUrl } : undefined,
});
}
setUser(user: MyProfileDto): void {
this.user.set(user);
}
private async doRefresh(): Promise<string | null> {
try {
const response = await firstValueFrom(this.api.refresh());
this.apply(response);
return response.accessToken;
} catch {
this.clear();
return null;
}
}
private apply(response: AuthResponse): void {
this.expiresAt = Date.parse(response.accessTokenExpiresAt);
this.token.set(response.accessToken);
this.user.set(response.user);
this.scheduleRefresh();
}
private scheduleRefresh(): void {
clearTimeout(this.refreshTimer);
const delay = Math.max(5_000, this.expiresAt - Date.now() - REFRESH_AHEAD_MS);
this.refreshTimer = setTimeout(() => void this.refresh(), delay);
}
private clear(): void {
clearTimeout(this.refreshTimer);
const hadSession = this.user() !== null;
this.token.set(null);
this.user.set(null);
this.expiresAt = 0;
if (hadSession) {
this.sessionEpoch.update((n) => n + 1);
}
}
}- Стан у сигналах.
tokenприватний: його змінює лише служба, а інші читають черезaccessToken().userпублічний і за домовленістю лише для читання (його записує тількиsetUser, після зміни профілю в темі 21).isAuthenticated– цеcomputedвід обох, тож охоронці й шаблони завжди бачать узгоджену відповідь. sessionEpochрахує виходи. Служби, що кешують дані користувача, – аватари в темі 18, сховища в темах 18–20, – читають його вeffectі очищують кеші, коли він змінюється, тож наступний користувач тієї самої вкладки браузера ніколи не бачить даних попереднього.refresh()– це single-flight у двох рядках.??=присвоює лише тоді, коли поле дорівнюєnullабоundefined: перший виклик запускаєdoRefresh()і зберігає проміс; кожен виклик, доки той не завершиться, отримує той самий проміс;finallyочищає поле для наступного оновлення. П’ять паралельних викликів – один запит (рис. 16.2).doRefresh()ніколи не генерує виняток: невдале оновлення – немає cookie, токен прострочений або відкликаний, сервер недоступний – очищає сесію й повертаєnull. ТомуrestoreSession()безпечно викликати під час запуску для відвідувача, який ніколи не входив.- Проактивне поновлення.
apply()зберігає час закінчення, аscheduleRefresh()ставить таймер за одну хвилину до нього (REFRESH_AHEAD_MS), але не раніше ніж через 5 секунд. Користувач, який тримає застосунок відкритим, отримує новий токен до закінчення старого, і запити рідко стикаються з 401. getValidToken()повертає поточний токен, якщо він живе ще щонайменше 20 секунд, а інакше спершу оновлює. Його використовує з’єднання SignalR (тема 20), бо WebSocket не можна повторити, як запит HTTP.logout()повідомляє серверу відкликати токен оновлення, але виходить локально, навіть якщо цей виклик не вдався;logoutAll()має дійти до сервера, тож пропускає помилки до виклику.endSession(returnUrl)очищає сесію й переходить на/login, запам’ятовуючи, де був користувач. Його викликає перехоплювач, коли оновлення не вдається.firstValueFrom(observable)перетворює Observable з однією відповіддю відHttpClientна Promise, тож служба може користуватисяasync/await, як C#.
Рис. 16.2. Два виклики, один запит оновлення
setTimeout без zone.js
scheduleRefresh використовує звичайний setTimeout. У застосунку без zone.js це нормально: зворотний виклик змінює сигнали (token, user), а сигнали планують перемальовування всього, що їх читає. З zone.js таймер ще й запустив би перевірку всього дерева компонентів.
Крок 3. Спільні тестові дані
Навіщо. Багатьом специфікаціям потрібне те саме: користувач, що ввійшов, інший користувач, повідомлення з ідентифікаторами, які сортуються як UUIDv7, і спосіб дати змогу виконатися відкладеним промісам. Усе це йде в один файл поза src/app, виключений зі збирання застосунку через tsconfig.app.json (тема 15).
Що зробити. Створіть підробки. Тема 20 додасть до цього файла підробку служби реального часу.
ts
import { signal } from '@angular/core';
import { MessageDto, MyProfileDto, UserSummaryDto } from '../app/core/api/models';
export const ME: MyProfileDto = {
id: '00000000-0000-7000-8000-00000000000a',
userName: 'alice',
email: '[email protected]',
displayName: 'Alice',
bio: null,
hasAvatar: false,
createdAt: '2026-11-01T10:00:00Z',
};
export const BOB: UserSummaryDto = {
id: '00000000-0000-7000-8000-00000000000b',
userName: 'bob',
displayName: 'Bob',
hasAvatar: false,
};
export function fakeAuth(user: MyProfileDto | null = ME) {
return {
user: signal(user),
sessionEpoch: signal(0),
isAuthenticated: signal(!!user),
};
}
/** Message ids sort like the server's UUIDv7 ids: by the number given. */
export function messageId(n: number): string {
return `00000000-0000-7000-8000-${n.toString().padStart(12, '0')}`;
}
export function message(n: number, overrides: Partial<MessageDto> = {}): MessageDto {
return {
id: messageId(n),
chatId: 'chat-1',
sender: BOB,
body: `message ${n}`,
replyToMessageId: null,
createdAt: new Date(Date.UTC(2026, 10, 10, 12, 0, n)).toISOString(),
editedAt: null,
isDeleted: false,
attachments: [],
...overrides,
};
}
/** Lets pending promise callbacks (firstValueFrom, async/await) run. */
export function settle(): Promise<void> {
return new Promise((resolve) => setTimeout(resolve, 0));
}MEіBOBвикористовують ідентифікатори у форматі UUIDv7, тож виглядають як справжні.fakeAuth()заміняєAuthServiceу тестах сховищ (тема 18): лише три сигнали, які ті читають.messageId(n)іmessage(n, overrides)будують повідомлення, ідентифікатори яких сортуються заn, як упорядковані за часом ідентифікатори сервера;Partial<MessageDto>дає тестові змогу змінити лише ті поля, що його цікавлять.settle()чекає одну макрозадачу (setTimeout(…, 0)), щоб уже заплановані зворотні викликиthenі код післяawaitвстигли виконатися.
Крок 4. Тестування сесії
Навіщо. Логіка сесії – саме той код, що ламається непомітно: два оновлення замість одного, сесія, яку не очищено, токен, який не використано повторно. Тести замінюють мережу HttpTestingController з Angular, який записує кожен запит і дозволяє тестові відповісти на нього, – клієнтським відповідником підробленого HttpMessageHandler.
Що зробити. Створіть специфікацію:
ts
import { provideHttpClient } from '@angular/common/http';
import { HttpTestingController, provideHttpClientTesting } from '@angular/common/http/testing';
import { TestBed } from '@angular/core/testing';
import { provideRouter } from '@angular/router';
import { ME, settle } from '../../../testing/fakes';
import { AuthResponse } from '../api/models';
import { AuthService } from './auth.service';
function authResponse(token: string): AuthResponse {
return {
accessToken: token,
accessTokenExpiresAt: new Date(Date.now() + 15 * 60_000).toISOString(),
user: ME,
};
}
describe('AuthService', () => {
let auth: AuthService;
let http: HttpTestingController;
beforeEach(() => {
TestBed.configureTestingModule({
providers: [
provideHttpClient(),
provideHttpClientTesting(),
provideRouter([{ path: '**', children: [] }]),
],
});
auth = TestBed.inject(AuthService);
http = TestBed.inject(HttpTestingController);
});
afterEach(() => http.verify());
it('restores the session from the refresh cookie', async () => {
const restored = auth.restoreSession();
http.expectOne({ method: 'POST', url: '/api/auth/refresh' }).flush(authResponse('t1'));
await restored;
expect(auth.isAuthenticated()).toBe(true);
expect(auth.user()?.userName).toBe('alice');
expect(auth.accessToken()).toBe('t1');
});
it('stays signed out when there is no session', async () => {
const restored = auth.restoreSession();
http
.expectOne('/api/auth/refresh')
.flush({ code: 'invalid_refresh_token' }, { status: 401, statusText: 'Unauthorized' });
await restored;
expect(auth.isAuthenticated()).toBe(false);
});
it('sends only one refresh request for parallel callers', async () => {
const first = auth.refresh();
const second = auth.refresh();
await settle();
http.expectOne('/api/auth/refresh').flush(authResponse('t2'));
expect(await first).toBe('t2');
expect(await second).toBe('t2');
});
it('clears the session when a refresh fails', async () => {
const login = auth.login({ login: 'alice', password: 'Passw0rd!' });
http.expectOne('/api/auth/login').flush(authResponse('t1'));
await login;
const epoch = auth.sessionEpoch();
const refreshed = auth.refresh();
http.expectOne('/api/auth/refresh').flush(null, { status: 401, statusText: 'Unauthorized' });
expect(await refreshed).toBeNull();
expect(auth.user()).toBeNull();
expect(auth.sessionEpoch()).toBe(epoch + 1);
});
it('reuses a fresh token instead of refreshing', async () => {
const login = auth.login({ login: 'alice', password: 'Passw0rd!' });
http.expectOne('/api/auth/login').flush(authResponse('t1'));
await login;
expect(await auth.getValidToken()).toBe('t1');
http.expectNone('/api/auth/refresh');
});
});provideHttpClientTesting()замінює бекенд HTTP тестовим контролером;provideRouterіз маршрутом-перехоплювачем усіх шляхів даєendSessionмісце, куди перейти.http.expectOne(...)стверджує, що очікує рівно один запит, який відповідає URL (або методу й URL), і повертає його;flush(body, { status })відповідає на нього. Відповідь 401 змушуєHttpClientзавершитися помилкою, як справжній сервер.afterEach(() => http.verify())провалює тест, якщо якийсь запит лишився без відповіді, – випадковий зайвий виклик не залишиться непоміченим.- «sends only one refresh request for parallel callers» – це тест single-flight: два виклики, потім
expectOne– два запити провалили б його з повідомленнямExpected one matching request for criteria "Match URL: /api/auth/refresh", found 2 requests. - «clears the session when a refresh fails» також перевіряє, що
sessionEpochзростає на одиницю.
Перевірка
powershell
npm test -- --watch=false Test Files 3 passed (3)
Tests 13 passed (13)Спробуйте тест single-flight: замініть ??= на = в refresh() і знову запустіть тести. Тест завершиться описаним вище повідомленням. Поверніть ??=.