fix: close admin user security gaps

This commit is contained in:
Bastian Wagner
2026-08-01 00:19:49 +02:00
parent e6acfdcac7
commit bec1826bfa
15 changed files with 566 additions and 103 deletions

View File

@@ -120,3 +120,70 @@ Every production behavior above was added only after the corresponding expected
- The lock/concurrency and migration tests are focused unit/SQL-shape tests; no live PostgreSQL instance was available for a two-connection race test or an actual migration run/revert. A database-backed integration test remains advisable before production rollout. - The lock/concurrency and migration tests are focused unit/SQL-shape tests; no live PostgreSQL instance was available for a two-connection race test or an actual migration run/revert. A database-backed integration test remains advisable before production rollout.
- Removing superseded generic user CRUD/read routes and `DELETE auth/me` is intentionally security-hardening and may affect undocumented external clients. Repository frontend searches showed no use of those removed routes. - Removing superseded generic user CRUD/read routes and `DELETE auth/me` is intentionally security-hardening and may affect undocumented external clients. Repository frontend searches showed no use of those removed routes.
- Full unrelated backend test-suite repair was intentionally out of scope; the focused Task 1 + Task 2 suite and backend build are green. - Full unrelated backend test-suite repair was intentionally out of scope; the focused Task 1 + Task 2 suite and backend build are green.
## Fix Round 1
### Review findings addressed
- Removed `linkPlayerId` from the validated public registration DTO and from internal create DTO plumbing. `AuthController.register` now has a concrete `AuthRegisterLoginDto` body rather than `any`, `AuthService.register` copies only the four permitted registration fields, and the obsolete `UsersService.linkPlayerToUserId` path was removed. Only `AdminUsersService` now changes `Player.user`.
- Rebuilt existing-account social login around one database transaction. Candidate user rows are locked, any email change uses a narrow repository update, the user is reloaded with current role/status under an alias-scoped row lock, inactive state is rechecked, and only then is the JWT signed. The same method covers Facebook, Google, Twitter, and Apple.
- Restricted `GET users/:id/teams` to the authenticated user's own ID. The query now returns an explicit minimal projection containing only player ID/name and team ID/name, matching the fields consumed by the current modern team selector.
- Removed body coercion for role/status mutation IDs. Genuine integer numbers are required; booleans and numeric strings are rejected.
- Added a focused Nest HTTP boundary suite with actual URI versioning, global validation, controller decorators, JWT guard behavior, real `RolesGuard`, and HTTP serialization assertions.
### RED evidence
1. Registration isolation:
- Command: `npm test -- --runInBand auth.controller.spec.ts auth.service.spec.ts -t "narrow validated registration|public registration player"`
- Failure: controller parameter metadata was `Object` instead of `AuthRegisterLoginDto`; registration still attempted public player linkage.
2. Social-login race:
- Command: `npm test -- --runInBand auth.service.spec.ts -t "concurrently deactivated social|locks and reloads an existing"`
- Failure: existing flow bypassed the transaction repository, used entity-wide `UsersService.update`, and signed stale state.
3. Self-only safe team bootstrap:
- Command: `npm test -- --runInBand users.controller.security.spec.ts users.teams.spec.ts`
- Failure: `findMyTeams` did not exist and the controller still delegated arbitrary IDs to raw `findTeams`.
4. Strict numeric role/status bodies:
- Command: `npm test -- --runInBand admin-users.controller.spec.ts -t "non-number role"`
- Failure: both JSON `true` and `"1"` were coerced to valid enum ID `1`.
5. Nest HTTP boundary:
- Command: `npm test -- --runInBand admin-users.http.spec.ts`
- Initial infrastructure failure: the focused module did not wire the existing database-backed `IsNotExist` validator container. The test module was corrected to use the real validator with a mocked repository; no validation was weakened.
### Files added
- `src/users/admin-users.http.spec.ts`
- `src/users/users.teams.spec.ts`
- `src/users/dto/user-team-response.dto.ts`
### Files modified
- `src/auth/auth.controller.ts`
- `src/auth/auth.controller.spec.ts`
- `src/auth/auth.service.ts`
- `src/auth/auth.service.spec.ts`
- `src/auth/dto/auth-register-login.dto.ts`
- `src/users/admin-users.controller.spec.ts`
- `src/users/dto/admin-user.dto.ts`
- `src/users/dto/create-user.dto.ts`
- `src/users/users.controller.ts`
- `src/users/users.controller.security.spec.ts`
- `src/users/users.service.ts`
### GREEN evidence
- Focused Task 1 + Task 2 tests:
- Command: `npm test -- --runInBand users.service.spec.ts users.teams.spec.ts users.controller.security.spec.ts admin-users.controller.spec.ts admin-users.service.spec.ts admin-users.http.spec.ts auth.controller.spec.ts auth.service.spec.ts jwt.strategy.spec.ts logging.service.spec.ts AddPlayerLookupIndexes.spec.ts`
- Result: **11 suites passed, 56 tests passed, 0 failed**.
- Targeted ESLint across all Fix Round 1 source/spec files: **exit 0, no findings**.
- Backend build via `npm run build`: **exit 0**.
- `git diff --check`: **exit 0**.
- Both frontend directories: **no changes**.
### Client contract impact
- Both frontend codebases currently send `linkPlayerId` during invite registration. The backend now strips it and performs no assignment, as required; registration still succeeds, but player linkage must subsequently use the guarded admin assignment endpoint.
- Both frontends call `GET users/:currentUserId/teams`. That self-ID URL remains valid. The modern selector consumes only the retained player/team ID and name fields. The legacy frontend also displayed team balance and team role from this response; those sensitive/unneeded fields are no longer returned, and the legacy frontend was intentionally not edited.
### Remaining limitation
- No ready local PostgreSQL test database/harness was available without new infrastructure. No dependencies or testcontainers were added. Concurrency remains covered by transaction/alias-lock assertions and stale-state regressions; migration remains covered by exact up/down SQL and metadata tests. A live two-connection PostgreSQL race and migration run/revert remain recommended before rollout.

View File

@@ -1,5 +1,6 @@
import { GUARDS_METADATA } from '@nestjs/common/constants'; import { GUARDS_METADATA } from '@nestjs/common/constants';
import { AuthController } from './auth.controller'; import { AuthController } from './auth.controller';
import { AuthRegisterLoginDto } from './dto/auth-register-login.dto';
describe('AuthController session enforcement', () => { describe('AuthController session enforcement', () => {
it('protects GET auth/me with JWT validation', () => { it('protects GET auth/me with JWT validation', () => {
@@ -15,4 +16,15 @@ describe('AuthController session enforcement', () => {
it('does not expose self-deletion that can race with an admin promotion', () => { it('does not expose self-deletion that can race with an admin promotion', () => {
expect(AuthController.prototype).not.toHaveProperty('delete'); expect(AuthController.prototype).not.toHaveProperty('delete');
}); });
it('uses the narrow validated registration DTO instead of an untyped body', () => {
const parameterTypes = Reflect.getMetadata(
'design:paramtypes',
AuthController.prototype,
'register',
);
expect(parameterTypes[0]).toBe(AuthRegisterLoginDto);
expect(AuthRegisterLoginDto.prototype).not.toHaveProperty('linkPlayerId');
});
}); });

View File

@@ -26,6 +26,7 @@ import {
ApiOkResponse, ApiOkResponse,
} from '@nestjs/swagger'; } from '@nestjs/swagger';
import { CreateInviteDTO } from './dto/create-invite.dto'; import { CreateInviteDTO } from './dto/create-invite.dto';
import { AuthRegisterLoginDto } from './dto/auth-register-login.dto';
@ApiTags('Auth') @ApiTags('Auth')
@Controller({ @Controller({
@@ -50,7 +51,7 @@ export class AuthController {
@Post('email/register') @Post('email/register')
@HttpCode(HttpStatus.CREATED) @HttpCode(HttpStatus.CREATED)
async register(@Body() createUserDto: any) { async register(@Body() createUserDto: AuthRegisterLoginDto) {
return this.service.register(createUserDto); return this.service.register(createUserDto);
} }

View File

@@ -13,6 +13,7 @@ describe('AuthService inactive-user enforcement and safe logging', () => {
let lockedUserQuery: any; let lockedUserQuery: any;
let userRepository: any; let userRepository: any;
let service: AuthService; let service: AuthService;
let mailService: any;
beforeEach(() => { beforeEach(() => {
jwtService = { jwtService = {
@@ -24,8 +25,10 @@ describe('AuthService inactive-user enforcement and safe logging', () => {
findOne: jest.fn(), findOne: jest.fn(),
update: jest.fn(), update: jest.fn(),
create: jest.fn(), create: jest.fn(),
linkPlayerToUserId: jest.fn(),
}; };
logger = { info: jest.fn(), debug: jest.fn() }; logger = { info: jest.fn(), debug: jest.fn() };
mailService = { userSignUp: jest.fn() };
confirmationUser = user(StatusEnum.inactive); confirmationUser = user(StatusEnum.inactive);
confirmationUser.hash = 'confirmation-hash'; confirmationUser.hash = 'confirmation-hash';
lockedUserQuery = { lockedUserQuery = {
@@ -45,7 +48,7 @@ describe('AuthService inactive-user enforcement and safe logging', () => {
jwtService, jwtService,
usersService, usersService,
{} as any, {} as any,
{} as any, mailService,
logger, logger,
dataSource, dataSource,
); );
@@ -70,10 +73,12 @@ describe('AuthService inactive-user enforcement and safe logging', () => {
}); });
it('rejects social login when the existing account is inactive', async () => { it('rejects social login when the existing account is inactive', async () => {
const inactive = user(StatusEnum.inactive); const inactive = socialUser(
usersService.findOne AuthProvidersEnum.google,
.mockResolvedValueOnce(inactive) RoleEnum.user,
.mockResolvedValueOnce(undefined); StatusEnum.inactive,
);
configureSocialQueries([inactive], inactive);
await expect( await expect(
service.validateSocialLogin(AuthProvidersEnum.google, { service.validateSocialLogin(AuthProvidersEnum.google, {
@@ -88,6 +93,61 @@ describe('AuthService inactive-user enforcement and safe logging', () => {
expect(jwtService.sign).not.toHaveBeenCalled(); expect(jwtService.sign).not.toHaveBeenCalled();
}); });
it('reloads and rejects a concurrently deactivated social user instead of signing stale state', async () => {
const stale = socialUser(
AuthProvidersEnum.google,
RoleEnum.admin,
StatusEnum.active,
);
const current = socialUser(
AuthProvidersEnum.google,
RoleEnum.user,
StatusEnum.inactive,
);
configureSocialQueries([stale], current);
await expect(
service.validateSocialLogin(AuthProvidersEnum.google, {
id: stale.socialId,
email: 'updated@example.com',
}),
).rejects.toBeInstanceOf(ForbiddenException);
expect(dataSource.transaction).toHaveBeenCalledTimes(1);
expect(userRepository.save).not.toHaveBeenCalledWith(stale);
expect(usersService.update).not.toHaveBeenCalled();
expect(jwtService.sign).not.toHaveBeenCalled();
});
it.each([
AuthProvidersEnum.facebook,
AuthProvidersEnum.google,
AuthProvidersEnum.twitter,
AuthProvidersEnum.apple,
])(
'locks and reloads an existing %s user, narrowly updates email, and signs the current role',
async (provider) => {
const stale = socialUser(provider, RoleEnum.admin, StatusEnum.active);
const current = socialUser(provider, RoleEnum.user, StatusEnum.active);
configureSocialQueries([stale], current);
const result = await service.validateSocialLogin(provider, {
id: stale.socialId,
email: 'updated@example.com',
});
expect(userRepository.update).toHaveBeenCalledWith(stale.id, {
email: 'updated@example.com',
});
expect(userRepository.save).not.toHaveBeenCalledWith(stale);
expect(jwtService.sign).toHaveBeenCalledWith({
id: current.id,
role: current.role,
});
expect(result.user).toBe(current);
},
);
it('never includes an email in an unknown-user login audit event', async () => { it('never includes an email in an unknown-user login audit event', async () => {
usersService.findOne.mockResolvedValue(undefined); usersService.findOne.mockResolvedValue(undefined);
@@ -154,6 +214,26 @@ describe('AuthService inactive-user enforcement and safe logging', () => {
expect(userRepository.save).toHaveBeenCalledWith(confirmationUser); expect(userRepository.save).toHaveBeenCalledWith(confirmationUser);
}); });
it('ignores a public registration player id and never mutates player ownership', async () => {
usersService.create.mockResolvedValue({
id: 8,
email: 'new@example.com',
});
await service.register({
email: 'new@example.com',
password: 'password',
firstName: 'New',
lastName: 'User',
linkPlayerId: 101,
} as any);
expect(usersService.create.mock.calls[0][0]).not.toHaveProperty(
'linkPlayerId',
);
expect(usersService.linkPlayerToUserId).not.toHaveBeenCalled();
});
function user(statusId: StatusEnum) { function user(statusId: StatusEnum) {
return { return {
id: 2, id: 2,
@@ -167,4 +247,45 @@ describe('AuthService inactive-user enforcement and safe logging', () => {
}, },
}; };
} }
function socialUser(
provider: AuthProvidersEnum,
roleId: RoleEnum,
statusId: StatusEnum,
) {
return {
...user(statusId),
email: 'old@example.com',
socialId: `${provider}-id`,
provider,
role: { id: roleId, name: roleId === RoleEnum.admin ? 'Admin' : 'User' },
hash: 'stale-hash',
};
}
function configureSocialQueries(candidates: any[], current: any) {
const candidateQuery = chain({ getMany: jest.fn(() => candidates) });
const reloadQuery = chain({ getOne: jest.fn(() => current) });
userRepository.createQueryBuilder = jest.fn((alias: string) =>
alias === 'socialCandidate' ? candidateQuery : reloadQuery,
);
userRepository.update = jest.fn();
}
function chain(overrides: Record<string, jest.Mock>) {
const query: Record<string, jest.Mock> = {};
[
'leftJoinAndSelect',
'where',
'orWhere',
'andWhere',
'setParameter',
'setParameters',
'setLock',
'orderBy',
].forEach((method) => {
query[method] = jest.fn(() => query);
});
return Object.assign(query, overrides);
}
}); });

View File

@@ -117,59 +117,68 @@ export class AuthService {
authProvider: string, authProvider: string,
socialData: SocialInterface, socialData: SocialInterface,
): Promise<{ token: string; user: User }> { ): Promise<{ token: string; user: User }> {
let user: User;
const socialEmail = socialData.email?.toLowerCase(); const socialEmail = socialData.email?.toLowerCase();
return this.dataSource.transaction(async (manager) => {
const userByEmail = await this.usersService.findOne({ const repository = manager.getRepository(User);
email: socialEmail, const candidateQuery = repository
.createQueryBuilder('socialCandidate')
.where(
'socialCandidate.socialId = :socialId AND socialCandidate.provider = :authProvider',
{ socialId: socialData.id, authProvider },
);
if (socialEmail) {
candidateQuery.orWhere('socialCandidate.email = :socialEmail', {
socialEmail,
}); });
user = await this.usersService.findOne({
socialId: socialData.id,
provider: authProvider,
});
if (user) {
await this.assertActiveUser(user);
if (socialEmail && !userByEmail) {
user.email = socialEmail;
} }
await this.usersService.update(user.id, user); const candidates = await candidateQuery
} else if (userByEmail) { .setLock('pessimistic_write', undefined, ['socialCandidate'])
user = userByEmail; .orderBy('socialCandidate.id', 'ASC')
await this.assertActiveUser(user); .getMany();
} else { const socialUser = candidates.find(
const role = plainToClass(Role, { (candidate) =>
id: RoleEnum.user, candidate.socialId === socialData.id &&
}); candidate.provider === authProvider,
const status = plainToClass(Status, { );
id: StatusEnum.active, const emailUser = socialEmail
}); ? candidates.find((candidate) => candidate.email === socialEmail)
: undefined;
user = await this.usersService.create({ let user = socialUser ?? emailUser;
if (!user) {
user = await repository.save(
repository.create({
email: socialEmail, email: socialEmail,
firstName: socialData.firstName, firstName: socialData.firstName,
lastName: socialData.lastName, lastName: socialData.lastName,
socialId: socialData.id, socialId: socialData.id,
provider: authProvider, provider: authProvider,
role, role: { id: RoleEnum.user } as Role,
status, status: { id: StatusEnum.active } as Status,
}); }),
);
user = await this.usersService.findOne({ } else if (
id: user.id, socialUser &&
}); socialEmail &&
!emailUser &&
socialUser.email !== socialEmail
) {
await repository.update(socialUser.id, { email: socialEmail });
} }
const currentUser = await repository
const jwtToken = await this.jwtService.sign({ .createQueryBuilder('currentSocialUser')
id: user.id, .leftJoinAndSelect('currentSocialUser.role', 'role')
role: user.role, .leftJoinAndSelect('currentSocialUser.status', 'status')
.where('currentSocialUser.id = :userId', { userId: user.id })
.setLock('pessimistic_write', undefined, ['currentSocialUser'])
.getOne();
if (!currentUser) throw new UnauthorizedException();
await this.assertActiveUser(currentUser);
const token = await this.jwtService.sign({
id: currentUser.id,
role: currentUser.role,
});
return { token, user: currentUser };
}); });
return {
token: jwtToken,
user,
};
} }
async register(dto: AuthRegisterLoginDto): Promise<void> { async register(dto: AuthRegisterLoginDto): Promise<void> {
@@ -179,8 +188,10 @@ export class AuthService {
.digest('hex'); .digest('hex');
const user = await this.usersService.create({ const user = await this.usersService.create({
...dto,
email: dto.email, email: dto.email,
password: dto.password,
firstName: dto.firstName,
lastName: dto.lastName,
role: { role: {
id: RoleEnum.user, id: RoleEnum.user,
} as Role, } as Role,
@@ -190,10 +201,6 @@ export class AuthService {
hash, hash,
}); });
if (user && dto.linkPlayerId != null) {
await this.usersService.linkPlayerToUserId(user, dto.linkPlayerId);
}
await this.logger.info({ await this.logger.info({
event: 'user_create', event: 'user_create',
details: `userId=${user.id}`, details: `userId=${user.id}`,

View File

@@ -23,7 +23,4 @@ export class AuthRegisterLoginDto {
@ApiProperty({ example: 'Doe' }) @ApiProperty({ example: 'Doe' })
@IsNotEmpty() @IsNotEmpty()
lastName: string; lastName: string;
@ApiProperty({ example: 27 })
linkPlayerId: number | null;
} }

View File

@@ -98,6 +98,17 @@ describe('admin user DTOs', () => {
expect(await validate(status)).not.toEqual([]); expect(await validate(status)).not.toEqual([]);
}); });
it.each([true, '1'])(
'rejects non-number role and status bodies: %p',
async (value) => {
const role = plainToInstance(AdminUserRoleDto, { role: value });
const status = plainToInstance(AdminUserStatusDto, { status: value });
expect(await validate(role)).not.toEqual([]);
expect(await validate(status)).not.toEqual([]);
},
);
it('validates player assignment filters and pagination bounds', async () => { it('validates player assignment filters and pagination bounds', async () => {
const valid = plainToInstance(AdminPlayerQueryDto, { const valid = plainToInstance(AdminPlayerQueryDto, {
assignment: 'assigned', assignment: 'assigned',

View File

@@ -0,0 +1,173 @@
import {
INestApplication,
UnauthorizedException,
ValidationPipe,
VersioningType,
} from '@nestjs/common';
import { Reflector } from '@nestjs/core';
import { AuthGuard } from '@nestjs/passport';
import { Test } from '@nestjs/testing';
import * as request from 'supertest';
import { useContainer } from 'class-validator';
import { DataSource } from 'typeorm';
import { AuthController } from '../auth/auth.controller';
import { AuthService } from '../auth/auth.service';
import { RoleEnum } from '../roles/roles.enum';
import { RolesGuard } from '../roles/roles.guard';
import validationOptions from '../utils/validation-options';
import { IsNotExist } from '../utils/validators/is-not-exists.validator';
import { AdminUsersController } from './admin-users.controller';
import { AdminUsersService } from './admin-users.service';
import { UsersController } from './users.controller';
import { UsersService } from './users.service';
describe('admin user HTTP security boundary', () => {
let app: INestApplication;
const safeUser = {
id: 2,
firstName: 'Target',
lastName: 'User',
email: 'target@example.com',
role: { id: RoleEnum.user, name: 'User' },
status: { id: 1, name: 'Active' },
assignments: [],
};
const adminService = {
updateProfile: jest.fn(() => safeUser),
updateRole: jest.fn(() => safeUser),
updateStatus: jest.fn(() => safeUser),
findPlayers: jest.fn(),
assignPlayer: jest.fn(),
unlinkPlayer: jest.fn(),
};
const usersService = {
findDirectory: jest.fn(),
findMyTeams: jest.fn(() => [
{
id: 11,
firstName: 'Pat',
lastName: 'Player',
team: { id: 4, name: 'Alpha' },
},
]),
};
const authService = { register: jest.fn() };
beforeAll(async () => {
const module = await Test.createTestingModule({
controllers: [AdminUsersController, UsersController, AuthController],
providers: [
Reflector,
RolesGuard,
IsNotExist,
{
provide: DataSource,
useValue: {
getRepository: () => ({ findOne: jest.fn(() => undefined) }),
},
},
{ provide: AdminUsersService, useValue: adminService },
{ provide: UsersService, useValue: usersService },
{ provide: AuthService, useValue: authService },
],
})
.overrideGuard(AuthGuard('jwt'))
.useValue({
canActivate(context) {
const httpRequest = context.switchToHttp().getRequest();
const token = httpRequest.headers.authorization;
if (token === 'Bearer admin') {
httpRequest.user = { id: 1, role: { id: RoleEnum.admin } };
return true;
}
if (token === 'Bearer user') {
httpRequest.user = { id: 7, role: { id: RoleEnum.user } };
return true;
}
throw new UnauthorizedException();
},
})
.compile();
app = module.createNestApplication();
useContainer(app, { fallbackOnErrors: true });
app.setGlobalPrefix('api');
app.enableVersioning({ type: VersioningType.URI });
app.useGlobalPipes(new ValidationPipe(validationOptions));
await app.init();
});
afterAll(() => app.close());
beforeEach(() => jest.clearAllMocks());
it('enforces JWT and current global admin role on an admin mutation', async () => {
await request(app.getHttpServer())
.patch('/api/v1/admin/users/2/role')
.send({ role: RoleEnum.user })
.expect(401);
await request(app.getHttpServer())
.patch('/api/v1/admin/users/2/role')
.set('Authorization', 'Bearer user')
.send({ role: RoleEnum.user })
.expect(403);
await request(app.getHttpServer())
.patch('/api/v1/admin/users/2/role')
.set('Authorization', 'Bearer admin')
.send({ role: RoleEnum.user })
.expect(200, safeUser);
});
it.each([true, '1'])(
'rejects non-numeric role JSON at the HTTP validation boundary: %p',
async (role) => {
await request(app.getHttpServer())
.patch('/api/v1/admin/users/2/role')
.set('Authorization', 'Bearer admin')
.send({ role })
.expect(422);
expect(adminService.updateRole).not.toHaveBeenCalled();
},
);
it('strips public player assignment input from registration', async () => {
await request(app.getHttpServer())
.post('/api/v1/auth/email/register')
.send({
email: 'new@example.com',
password: 'password',
firstName: 'New',
lastName: 'User',
linkPlayerId: 101,
})
.expect(201);
expect(authService.register).toHaveBeenCalledWith({
email: 'new@example.com',
password: 'password',
firstName: 'New',
lastName: 'User',
});
});
it('restricts team bootstrap to self and serializes only the safe projection', async () => {
await request(app.getHttpServer())
.get('/api/v1/users/8/teams')
.set('Authorization', 'Bearer user')
.expect(403);
const response = await request(app.getHttpServer())
.get('/api/v1/users/7/teams')
.set('Authorization', 'Bearer user')
.expect(200);
expect(response.body).toEqual([
{
id: 11,
firstName: 'Pat',
lastName: 'Player',
team: { id: 4, name: 'Alpha' },
},
]);
expect(JSON.stringify(response.body)).not.toMatch(
/provider|socialId|password|hash|balance|createdAt|updatedAt/i,
);
});
});

View File

@@ -24,13 +24,13 @@ export class AdminUserProfileDto {
} }
export class AdminUserRoleDto { export class AdminUserRoleDto {
@Type(() => Number) @IsInt()
@IsIn([RoleEnum.admin, RoleEnum.user]) @IsIn([RoleEnum.admin, RoleEnum.user])
role: RoleEnum; role: RoleEnum;
} }
export class AdminUserStatusDto { export class AdminUserStatusDto {
@Type(() => Number) @IsInt()
@IsIn([StatusEnum.active, StatusEnum.inactive]) @IsIn([StatusEnum.active, StatusEnum.inactive])
status: StatusEnum; status: StatusEnum;
} }

View File

@@ -1,13 +1,7 @@
import { Transform } from 'class-transformer'; import { Transform } from 'class-transformer';
import { ApiProperty } from '@nestjs/swagger'; import { ApiProperty } from '@nestjs/swagger';
import { Role } from '../../roles/entities/role.entity'; import { Role } from '../../roles/entities/role.entity';
import { import { IsEmail, IsNotEmpty, MinLength, Validate } from 'class-validator';
IsEmail,
IsNotEmpty,
IsOptional,
MinLength,
Validate,
} from 'class-validator';
import { Status } from '../../statuses/entities/status.entity'; import { Status } from '../../statuses/entities/status.entity';
import { IsNotExist } from '../../utils/validators/is-not-exists.validator'; import { IsNotExist } from '../../utils/validators/is-not-exists.validator';
import { IsExist } from '../../utils/validators/is-exists.validator'; import { IsExist } from '../../utils/validators/is-exists.validator';
@@ -51,6 +45,4 @@ export class CreateUserDto {
status?: Status; status?: Status;
hash?: string | null; hash?: string | null;
linkPlayerId?: number | null;
} }

View File

@@ -0,0 +1,11 @@
export class UserTeamReferenceDto {
id: number;
name: string;
}
export class UserTeamPlayerDto {
id: number;
firstName: string;
lastName: string;
team: UserTeamReferenceDto;
}

View File

@@ -1,4 +1,5 @@
import { UsersController } from './users.controller'; import { UsersController } from './users.controller';
import { ForbiddenException } from '@nestjs/common';
describe('UsersController admin mutation isolation', () => { describe('UsersController admin mutation isolation', () => {
it('does not expose generic create, update, or delete handlers that bypass safeguards', () => { it('does not expose generic create, update, or delete handlers that bypass safeguards', () => {
@@ -8,4 +9,17 @@ describe('UsersController admin mutation isolation', () => {
expect(UsersController.prototype).not.toHaveProperty('findAll'); expect(UsersController.prototype).not.toHaveProperty('findAll');
expect(UsersController.prototype).not.toHaveProperty('findOne'); expect(UsersController.prototype).not.toHaveProperty('findOne');
}); });
it('restricts team bootstrap to the authenticated user id', async () => {
const service = { findMyTeams: jest.fn(() => []) };
const controller = new UsersController(service as any);
const request = { user: { id: 7, role: { id: 2 } } };
expect(() => (controller as any).findTeamsOfPlayer(request, 8)).toThrow(
ForbiddenException,
);
await (controller as any).findTeamsOfPlayer(request, 7);
expect(service.findMyTeams).toHaveBeenCalledWith(7);
});
}); });

View File

@@ -7,6 +7,8 @@ import {
HttpStatus, HttpStatus,
HttpCode, HttpCode,
Request, Request,
ForbiddenException,
ParseIntPipe,
} from '@nestjs/common'; } from '@nestjs/common';
import { UsersService } from './users.service'; import { UsersService } from './users.service';
import { ApiBearerAuth, ApiTags } from '@nestjs/swagger'; import { ApiBearerAuth, ApiTags } from '@nestjs/swagger';
@@ -40,7 +42,13 @@ export class UsersController {
@Roles([RoleEnum.user, RoleEnum.admin]) @Roles([RoleEnum.user, RoleEnum.admin])
@Get(':id/teams') @Get(':id/teams')
@HttpCode(HttpStatus.OK) @HttpCode(HttpStatus.OK)
findTeamsOfPlayer(@Param('id') id: string) { findTeamsOfPlayer(
return this.usersService.findTeams({ id: +id }); @Request() request: { user: Pick<User, 'id' | 'role'> },
@Param('id', ParseIntPipe) id: number,
) {
if (request.user.id !== id) {
throw new ForbiddenException('Users may only load their own teams');
}
return this.usersService.findMyTeams(id);
} }
} }

View File

@@ -16,6 +16,7 @@ import {
UserDirectorySummaryDto, UserDirectorySummaryDto,
} from './dto/user-directory-response.dto'; } from './dto/user-directory-response.dto';
import { User } from './entities/user.entity'; import { User } from './entities/user.entity';
import { UserTeamPlayerDto } from './dto/user-team-response.dto';
@Injectable() @Injectable()
export class UsersService { export class UsersService {
@@ -113,33 +114,32 @@ export class UsersService {
await this.usersRepository.softDelete(id); await this.usersRepository.softDelete(id);
} }
async findTeams(fields: EntityCondition<User>) { async findMyTeams(userId: number): Promise<UserTeamPlayerDto[]> {
const user = await this.findOne(fields); const rows = await this.playersRepository
if (!user) { .createQueryBuilder('player')
return []; .innerJoin('player.team', 'team')
} .select([
'player.id AS player_id',
const players = await this.playersRepository.find({ 'player.firstName AS first_name',
where: { 'player.lastName AS last_name',
user: { 'team.id AS team_id',
id: user.id, 'team.name AS team_name',
}, ])
}, .where('player.userId = :userId', { userId })
relations: ['team'], .orderBy('player.id', 'ASC')
}); .getRawMany<{
return players; player_id: number | string;
} first_name: string;
last_name: string;
async linkPlayerToUserId(user: User, playerId: number): Promise<boolean> { team_id: number | string;
return new Promise<boolean>(async (resolve) => { team_name: string;
const player = await this.playersRepository.findOneByOrFail({ }>();
id: playerId, return rows.map((row) => ({
}); id: Number(row.player_id),
firstName: row.first_name,
player.user = user; lastName: row.last_name,
await this.playersRepository.save(player); team: { id: Number(row.team_id), name: row.team_name },
return resolve(true); }));
});
} }
private createSharedTeamsQuery(requesterId: number) { private createSharedTeamsQuery(requesterId: number) {

View File

@@ -0,0 +1,49 @@
import { UsersService } from './users.service';
describe('UsersService safe current-user teams', () => {
it('returns only the player and team fields required by team bootstrap', async () => {
const rows = [
{
player_id: 11,
first_name: 'Pat',
last_name: 'Player',
team_id: 4,
team_name: 'Alpha',
user_id: 7,
provider: 'google',
social_id: 'must-not-leak',
balance: '100.00',
},
];
const query = chain({ getRawMany: jest.fn(() => rows) });
const playersRepository = {
createQueryBuilder: jest.fn(() => query),
};
const service = new UsersService({} as any, playersRepository as any);
const result = await service.findMyTeams(7);
expect(result).toEqual([
{
id: 11,
firstName: 'Pat',
lastName: 'Player',
team: { id: 4, name: 'Alpha' },
},
]);
expect(JSON.stringify(result)).not.toMatch(
/user|provider|social|role|status|password|hash|balance|createdAt|updatedAt/i,
);
expect(query.where).toHaveBeenCalledWith('player.userId = :userId', {
userId: 7,
});
});
function chain(overrides: Record<string, jest.Mock>) {
const query: Record<string, jest.Mock> = {};
['innerJoin', 'select', 'where', 'orderBy'].forEach((method) => {
query[method] = jest.fn(() => query);
});
return Object.assign(query, overrides);
}
});