OpenVelo Agent
af3c24275d
- Backend: NestJS 10 + TypeORM (better-sqlite3) feature-modular layout.
- Entities: user, setting, category, challenge, challenge_file, solve,
refresh_token, blog_post. Auto-run migrations + idempotent 6-system-
category seed on startup.
- Argon2id password hashing with policy check; JWT access + rotating
refresh tokens (HttpOnly cookie); CSRF middleware (SameSite + custom
X-CSRF-Token header); global JWT auth guard with @Public() opt-out;
per-IP login backoff + per-IP registration rate limit.
- Endpoints: auth (login/refresh/logout/csrf), users (first-admin
registration), system (bootstrap/event status/SSE), admin (guarded
user CRUD with last-admin invariant), frontend module (uploads +
SPA fallback).
- Security: helmet+CSP+HSTS-gated-by-TLS, CORS allowlist, structured
global exception filter, Zod request validation pipes, OpenAPI 3.1
served at /api/docs and /api/docs-json, 10 canonical themes under
backend/themes/.
- Frontend: Angular 17 standalone components, lazy-loaded feature routes,
signals, functional HttpInterceptorFn (csrf + auth), functional
CanActivateFn auth guard, HttpOnly-cookie-based auth service.
- Tests: Jest + supertest, 46 tests across 13 suites covering
migrations, env schema, theme loader, event status, login backoff,
registration rate limit, ApiError shape, bootstrap integration,
auth refresh rotation, admin guard, last-admin invariant, SSE flat
payloads. Single-command runner: `npm test`.
108 lines
4.0 KiB
TypeScript
108 lines
4.0 KiB
TypeScript
process.env.DATABASE_PATH = ':memory:';
|
|
process.env.THEMES_DIR = './themes';
|
|
process.env.FRONTEND_DIST = './frontend/dist';
|
|
|
|
import { Test } from '@nestjs/testing';
|
|
import { INestApplication, ValidationPipe } from '@nestjs/common';
|
|
import { HttpAdapterHost } from '@nestjs/core';
|
|
import cookieParser from 'cookie-parser';
|
|
import request from 'supertest';
|
|
import { CookieAccessInfo } from 'cookiejar';
|
|
import { AppModule } from '../../backend/src/app.module';
|
|
import { GlobalExceptionFilter } from '../../backend/src/common/filters/global-exception.filter';
|
|
|
|
describe('Auth refresh rotation', () => {
|
|
let app: INestApplication;
|
|
|
|
beforeAll(async () => {
|
|
const moduleRef = await Test.createTestingModule({ imports: [AppModule] }).compile();
|
|
app = moduleRef.createNestApplication();
|
|
app.use(cookieParser());
|
|
app.useGlobalPipes(new ValidationPipe({ whitelist: true, forbidNonWhitelisted: false, transform: true }));
|
|
const httpAdapterHost = app.get(HttpAdapterHost);
|
|
app.useGlobalFilters(new GlobalExceptionFilter(httpAdapterHost));
|
|
await app.init();
|
|
|
|
const server = app.getHttpServer();
|
|
await request(server).post('/api/v1/auth/register-first-admin')
|
|
.send({ username: 'admin', password: 'Sup3rSecret!Pass' })
|
|
.expect(201);
|
|
});
|
|
|
|
afterAll(async () => {
|
|
await app.close();
|
|
});
|
|
|
|
it('GET /api/v1/auth/csrf always sets the cookie and returns a non-empty token', async () => {
|
|
const server = app.getHttpServer();
|
|
const agent = request.agent(server);
|
|
const res = await agent.get('/api/v1/auth/csrf').expect(200);
|
|
expect(res.body.csrfToken).toBeDefined();
|
|
expect(res.body.csrfToken.length).toBeGreaterThan(0);
|
|
const cookies = res.headers['set-cookie'] as unknown as string[];
|
|
expect(cookies?.some((c) => c.startsWith('csrf='))).toBe(true);
|
|
});
|
|
|
|
it('login returns an access token and sets the rt refresh cookie', async () => {
|
|
const server = app.getHttpServer();
|
|
const agent = request.agent(server);
|
|
|
|
const res = await agent.post('/api/v1/auth/login')
|
|
.send({ username: 'admin', password: 'Sup3rSecret!Pass' })
|
|
.expect(201);
|
|
expect(res.body.accessToken).toBeDefined();
|
|
const cookies = res.headers['set-cookie'] as unknown as string[];
|
|
const rt = cookies.find((c) => c.startsWith('rt='));
|
|
expect(rt).toBeDefined();
|
|
expect(rt).toMatch(/HttpOnly/);
|
|
});
|
|
|
|
it('refresh rotates the refresh cookie and returns a new access token', async () => {
|
|
const server = app.getHttpServer();
|
|
const agent = request.agent(server);
|
|
|
|
await agent.post('/api/v1/auth/login')
|
|
.send({ username: 'admin', password: 'Sup3rSecret!Pass' })
|
|
.expect(201);
|
|
|
|
const cookies: any = agent.jar.getCookies(CookieAccessInfo.All);
|
|
const rt = cookies.find((c: any) => c.name === 'rt');
|
|
const csrf = cookies.find((c: any) => c.name === 'csrf');
|
|
expect(rt).toBeDefined();
|
|
expect(csrf).toBeDefined();
|
|
|
|
const refresh = await agent.post('/api/v1/auth/refresh')
|
|
.set('X-CSRF-Token', csrf.value)
|
|
.set('Cookie', `rt=${rt.value}`)
|
|
.send({})
|
|
.expect(200);
|
|
expect(refresh.body.accessToken).toBeDefined();
|
|
expect(refresh.body.user.username).toBe('admin');
|
|
});
|
|
|
|
it('logout invalidates the refresh token', async () => {
|
|
const server = app.getHttpServer();
|
|
const agent = request.agent(server);
|
|
|
|
await agent.post('/api/v1/auth/login')
|
|
.send({ username: 'admin', password: 'Sup3rSecret!Pass' })
|
|
.expect(201);
|
|
|
|
const cookies: any = agent.jar.getCookies(CookieAccessInfo.All);
|
|
const rt = cookies.find((c: any) => c.name === 'rt');
|
|
const csrf = cookies.find((c: any) => c.name === 'csrf');
|
|
|
|
await agent.post('/api/v1/auth/logout')
|
|
.set('X-CSRF-Token', csrf.value)
|
|
.set('Cookie', `rt=${rt.value}`)
|
|
.send({})
|
|
.expect(204);
|
|
|
|
// Reusing the same refresh cookie must fail
|
|
await agent.post('/api/v1/auth/refresh')
|
|
.set('X-CSRF-Token', csrf.value)
|
|
.set('Cookie', `rt=${rt.value}`)
|
|
.send({})
|
|
.expect(401);
|
|
});
|
|
}); |