- SSRF protection: DNS resolution + private IP blocking on metadata fetcher - Upload security: CSP/X-Frame-Options headers, SVG forced download, nosniff - Auth hardening: JWT secret min length, password min 8 chars, token revocation via password_changed_at - Attachment ownership verification before linking to messages - Message length limit (4000 chars) enforced on client and server - Asset URL validation on avatar/banner updates - Federation instance validation (domain regex, origin scheme, length limits) - DB indexes on all FK columns for query performance - Migrations: nullable moderator columns, dm_messages reply_to FK constraint - File cleanup on avatar/banner replacement and space deletion - Fastify trustProxy, AbortController on fetches, typing map size cap
247 lines
9.1 KiB
TypeScript
247 lines
9.1 KiB
TypeScript
import type { FastifyInstance } from 'fastify';
|
|
import crypto from 'crypto';
|
|
import { eq, like, or, and, ne, sql } from 'drizzle-orm';
|
|
import { authenticate, requireAdmin, hashPassword } from '../utils/auth.js';
|
|
import { getStorageStats, getOrphanedFiles, cleanupStorage } from '../utils/storageJanitor.js';
|
|
import { getDb, schema } from '../db/index.js';
|
|
import { connectionManager } from '../ws/handler.js';
|
|
import { tombstoneUser } from '../utils/userDeletion.js';
|
|
import { deleteUploadFile } from '../utils/fileCleanup.js';
|
|
import { sanitizeUser } from '../utils/sanitize.js';
|
|
import type { AdminUser, AdminUserListResponse, AdminResetPasswordResponse } from '@backspace/shared';
|
|
|
|
function toAdminUser(row: typeof schema.users.$inferSelect): AdminUser {
|
|
return {
|
|
id: row.id,
|
|
username: row.username,
|
|
displayName: row.displayName,
|
|
avatar: row.avatar,
|
|
avatarColor: row.avatarColor,
|
|
status: row.status ?? 'offline',
|
|
isAdmin: row.isAdmin === 1,
|
|
isDeleted: row.isDeleted === 1,
|
|
homeInstance: row.homeInstance,
|
|
createdAt: row.createdAt,
|
|
};
|
|
}
|
|
|
|
export async function adminRoutes(app: FastifyInstance): Promise<void> {
|
|
// ─── Storage Management ──────────────────────────────────────────────────
|
|
|
|
// GET /api/admin/storage/stats — storage overview
|
|
app.get('/api/admin/storage/stats', { preHandler: [authenticate, requireAdmin] }, async (_request, reply) => {
|
|
try {
|
|
const stats = getStorageStats();
|
|
return reply.code(200).send(stats);
|
|
} catch (err: any) {
|
|
return reply.code(500).send({ error: `Failed to compute storage stats: ${err.message}`, statusCode: 500 });
|
|
}
|
|
});
|
|
|
|
// GET /api/admin/storage/orphans — list orphaned files
|
|
app.get('/api/admin/storage/orphans', { preHandler: [authenticate, requireAdmin] }, async (_request, reply) => {
|
|
try {
|
|
const orphans = getOrphanedFiles();
|
|
return reply.code(200).send({ orphans });
|
|
} catch (err: any) {
|
|
return reply.code(500).send({ error: `Failed to list orphaned files: ${err.message}`, statusCode: 500 });
|
|
}
|
|
});
|
|
|
|
// POST /api/admin/storage/cleanup — delete orphaned files
|
|
app.post<{ Body: { dryRun?: boolean } }>('/api/admin/storage/cleanup', { preHandler: [authenticate, requireAdmin] }, async (request, reply) => {
|
|
try {
|
|
const dryRun = request.body?.dryRun ?? false;
|
|
const result = cleanupStorage(dryRun);
|
|
return reply.code(200).send(result);
|
|
} catch (err: any) {
|
|
return reply.code(500).send({ error: `Cleanup failed: ${err.message}`, statusCode: 500 });
|
|
}
|
|
});
|
|
|
|
// ─── User Management ────────────────────────────────────────────────────
|
|
|
|
// GET /api/admin/users — paginated user list with search
|
|
app.get<{ Querystring: { q?: string; page?: string; pageSize?: string; showDeleted?: string } }>(
|
|
'/api/admin/users',
|
|
{ preHandler: [authenticate, requireAdmin] },
|
|
async (request, reply) => {
|
|
const db = getDb();
|
|
const q = request.query.q?.trim() || '';
|
|
const page = Math.max(1, parseInt(request.query.page || '1', 10) || 1);
|
|
const pageSize = Math.min(100, Math.max(1, parseInt(request.query.pageSize || '50', 10) || 50));
|
|
const showDeleted = request.query.showDeleted === 'true';
|
|
|
|
const conditions = [];
|
|
if (!showDeleted) {
|
|
conditions.push(eq(schema.users.isDeleted, 0));
|
|
}
|
|
if (q) {
|
|
const pattern = `%${q}%`;
|
|
conditions.push(or(
|
|
like(schema.users.username, pattern),
|
|
like(schema.users.displayName, pattern),
|
|
)!);
|
|
}
|
|
|
|
const where = conditions.length > 0 ? and(...conditions) : undefined;
|
|
|
|
const countResult = db.select({ count: sql<number>`count(*)` })
|
|
.from(schema.users)
|
|
.where(where)
|
|
.get();
|
|
const total = countResult?.count ?? 0;
|
|
|
|
const rows = db.select()
|
|
.from(schema.users)
|
|
.where(where)
|
|
.orderBy(sql`${schema.users.createdAt} DESC`)
|
|
.limit(pageSize)
|
|
.offset((page - 1) * pageSize)
|
|
.all();
|
|
|
|
const response: AdminUserListResponse = {
|
|
users: rows.map(toAdminUser),
|
|
total,
|
|
page,
|
|
pageSize,
|
|
};
|
|
|
|
return reply.code(200).send(response);
|
|
},
|
|
);
|
|
|
|
// PATCH /api/admin/users/:id/role — promote/demote admin
|
|
app.patch<{ Params: { id: string }; Body: { isAdmin: boolean } }>(
|
|
'/api/admin/users/:id/role',
|
|
{ preHandler: [authenticate, requireAdmin] },
|
|
async (request, reply) => {
|
|
const { id: targetId } = request.params;
|
|
const { isAdmin } = request.body;
|
|
|
|
if (typeof isAdmin !== 'boolean') {
|
|
return reply.code(400).send({ error: 'isAdmin must be a boolean', statusCode: 400 });
|
|
}
|
|
|
|
const db = getDb();
|
|
const target = db.select().from(schema.users).where(eq(schema.users.id, targetId)).get();
|
|
if (!target) {
|
|
return reply.code(404).send({ error: 'User not found', statusCode: 404 });
|
|
}
|
|
if (target.isDeleted === 1) {
|
|
return reply.code(400).send({ error: 'Cannot change role of a deleted user', statusCode: 400 });
|
|
}
|
|
|
|
// Promote: block federated users
|
|
if (isAdmin && target.homeInstance) {
|
|
return reply.code(403).send({ error: 'Federated users cannot be promoted to admin', statusCode: 403 });
|
|
}
|
|
|
|
// Demote: prevent removing the last admin
|
|
if (!isAdmin && target.isAdmin === 1) {
|
|
const adminCount = db.select({ count: sql<number>`count(*)` })
|
|
.from(schema.users)
|
|
.where(and(eq(schema.users.isAdmin, 1), eq(schema.users.isDeleted, 0)))
|
|
.get();
|
|
if ((adminCount?.count ?? 0) <= 1) {
|
|
return reply.code(400).send({ error: 'Cannot demote the last admin', statusCode: 400 });
|
|
}
|
|
}
|
|
|
|
db.update(schema.users)
|
|
.set({ isAdmin: isAdmin ? 1 : 0 })
|
|
.where(eq(schema.users.id, targetId))
|
|
.run();
|
|
|
|
const updated = db.select().from(schema.users).where(eq(schema.users.id, targetId)).get()!;
|
|
|
|
// Broadcast user_updated so the target's UI reflects the isAdmin change
|
|
connectionManager.sendToUser(targetId, {
|
|
type: 'user_updated',
|
|
user: sanitizeUser(updated),
|
|
});
|
|
|
|
return reply.code(200).send(toAdminUser(updated));
|
|
},
|
|
);
|
|
|
|
// POST /api/admin/users/:id/reset-password — generate temporary password
|
|
app.post<{ Params: { id: string } }>(
|
|
'/api/admin/users/:id/reset-password',
|
|
{ preHandler: [authenticate, requireAdmin] },
|
|
async (request, reply) => {
|
|
const { id: targetId } = request.params;
|
|
const db = getDb();
|
|
|
|
const target = db.select().from(schema.users).where(eq(schema.users.id, targetId)).get();
|
|
if (!target) {
|
|
return reply.code(404).send({ error: 'User not found', statusCode: 404 });
|
|
}
|
|
if (target.isDeleted === 1) {
|
|
return reply.code(400).send({ error: 'Cannot reset password of a deleted user', statusCode: 400 });
|
|
}
|
|
if (target.homeInstance) {
|
|
return reply.code(400).send({ error: 'Federated users authenticate via their home instance', statusCode: 400 });
|
|
}
|
|
|
|
const temporaryPassword = crypto.randomBytes(12).toString('base64url');
|
|
const hash = await hashPassword(temporaryPassword);
|
|
|
|
db.update(schema.users)
|
|
.set({ passwordHash: hash, passwordChangedAt: Date.now() })
|
|
.where(eq(schema.users.id, targetId))
|
|
.run();
|
|
|
|
// Force re-auth by disconnecting all sessions
|
|
connectionManager.forceDisconnectUser(targetId);
|
|
|
|
const response: AdminResetPasswordResponse = { temporaryPassword };
|
|
return reply.code(200).send(response);
|
|
},
|
|
);
|
|
|
|
// DELETE /api/admin/users/:id — tombstone a user account
|
|
app.delete<{ Params: { id: string } }>(
|
|
'/api/admin/users/:id',
|
|
{ preHandler: [authenticate, requireAdmin] },
|
|
async (request, reply) => {
|
|
const { id: targetId } = request.params;
|
|
const db = getDb();
|
|
|
|
if (targetId === request.userId) {
|
|
return reply.code(400).send({ error: 'Use account settings to delete your own account', statusCode: 400 });
|
|
}
|
|
|
|
const target = db.select().from(schema.users).where(eq(schema.users.id, targetId)).get();
|
|
if (!target) {
|
|
return reply.code(404).send({ error: 'User not found', statusCode: 404 });
|
|
}
|
|
if (target.isDeleted === 1) {
|
|
return reply.code(400).send({ error: 'User is already deleted', statusCode: 400 });
|
|
}
|
|
|
|
// Check if user owns any spaces
|
|
const ownedSpaces = db.select({ id: schema.spaces.id, name: schema.spaces.name })
|
|
.from(schema.spaces)
|
|
.where(eq(schema.spaces.ownerId, targetId))
|
|
.all();
|
|
if (ownedSpaces.length > 0) {
|
|
return reply.code(400).send({
|
|
error: 'User owns spaces — transfer ownership first',
|
|
statusCode: 400,
|
|
ownedSpaces,
|
|
});
|
|
}
|
|
|
|
const filesToDelete = tombstoneUser(targetId);
|
|
for (const filename of filesToDelete) {
|
|
deleteUploadFile(filename);
|
|
}
|
|
|
|
connectionManager.forceDisconnectUser(targetId);
|
|
|
|
return reply.code(200).send({ success: true });
|
|
},
|
|
);
|
|
}
|