Harlekin
cb66839a05
Auth.js übernimmt nur den OAuth-Ablauf mit state und PKCE, Scope identify. Das Zugangstoken des Nutzers wird danach verworfen: die Rollen holt der Bot mit seinem eigenen Token. Die Sitzung steht in der Datenbank, im Cookie liegt nur userId und sessionId. Ohne die Zeile in Session ist das Cookie wertlos, und nur so lässt sich eine Sitzung zurückziehen. Wer sich anmelden darf, steckt in lib/auth/signInPolicy.ts statt im Callback: das ist die Regel, an der alles hängt, und sie gehört einzeln prüfbar. Kein Guild-Mitglied, kein Zugang. Keine Rolle mit grantsMembership, kein Zugang. Notfall-Admins umgehen die Rolle, aber nicht die Guild-Mitgliedschaft. RoleMapping trägt jetzt grantsMembership, category und isPresent. Der Worker spiegelt jede Rolle der Guild hierher, damit im Adminbereich nichts von Hand eingetragen werden muss. Gelöschte Rollen werden nicht entfernt, sondern auf isPresent = false gesetzt: beim Umzug auf den echten Server bleiben sie als Vorlage stehen. Der Worker gleicht über Gateway-Ereignisse und zusätzlich alle fünf Minuten voll ab. Verliert jemand seine AfiS-Rolle, beendet er dessen Sitzungen sofort und setzt isActive auf false — der Datensatz bleibt, damit Autorenangaben in alten Akten gültig bleiben. Das passiert im Worker und nicht in der Web-App, weil es dort erst beim nächsten Request des Betroffenen griffe. Zwei Widersprüche der Dokumente aufgelöst, festgehalten in docs/13-entscheidungen.md: der Ausschluss schlägt auch den Admin (das Codebeispiel in 03-auth-und-rechte.md übergeht ihn, die Reihenfolge eine Zeile darüber nicht), und versiegelte Akten fallen im Where-Fragment heraus statt in einer Prüfung danach. 45 Tests, davon die Negativfälle aus docs/03 gegen eine echte Datenbank: Stufe 2 sieht die Stufe-4-Akte nicht und findet sie auch nicht in der Trefferzahl, ein Ausgeschlossener mit Stufe 5 kommt nicht heran, ein Rollenentzug beendet die Sitzungen, und ein Ausfall der Discord-API sieht nicht aus wie eine verweigerte Mitgliedschaft.
102 lines
2.9 KiB
TypeScript
102 lines
2.9 KiB
TypeScript
import { db } from '@/lib/db'
|
||
import { getEnv } from '@/lib/env'
|
||
import { TtlCache } from '@/lib/auth/cache'
|
||
import {
|
||
PERMISSIONS,
|
||
isPermission,
|
||
type EffectivePermissions,
|
||
type Permission,
|
||
} from '@/lib/auth/permissions'
|
||
|
||
/** Höchste Freigabestufe. */
|
||
const MAX_CLEARANCE = 5
|
||
|
||
/**
|
||
* 60 Sekunden Verfallszeit als Sicherheitsnetz. Der reguläre Weg ist die
|
||
* sofortige Verwerfung bei `member_changed` oder `role_mapping_changed`.
|
||
*/
|
||
const cache = new TtlCache<string, EffectivePermissions>(60_000, 200)
|
||
|
||
/** Wird vom LISTEN-Client aufgerufen, siehe lib/realtime/listener.ts. */
|
||
export function invalidateUser(userId: string): void {
|
||
cache.delete(userId)
|
||
}
|
||
|
||
/** Eine Änderung am Rollen-Mapping betrifft potenziell jeden. */
|
||
export function invalidateAll(): void {
|
||
cache.clear()
|
||
}
|
||
|
||
function bootstrapAdmin(userId: string): EffectivePermissions {
|
||
return {
|
||
userId,
|
||
clearanceLevel: MAX_CLEARANCE,
|
||
permissions: new Set<Permission>(PERMISSIONS),
|
||
isAdmin: true,
|
||
hasMembership: true,
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Löst die Rechte eines Nutzers aus `UserRole` × `RoleMapping` auf:
|
||
* höchste Stufe aller Rollen, Vereinigung aller Rechte.
|
||
*
|
||
* `hasMembership` ist eine Ergänzung gegenüber docs/03-auth-und-rechte.md und
|
||
* bildet den Türsteher ab: auf dem AfiS-Discord sind auch Gäste, die keine
|
||
* Akte sehen dürfen. Siehe docs/13-entscheidungen.md.
|
||
*
|
||
* Notfall-Admins aus `BOOTSTRAP_ADMIN_IDS` bekommen immer Stufe 5 und alle
|
||
* Rechte, ohne Datenbankabfrage. Ohne das sperrt man sich beim ersten Fehler
|
||
* in der Rollenverwaltung selbst aus.
|
||
*/
|
||
export async function resolvePermissions(userId: string): Promise<EffectivePermissions> {
|
||
const cached = cache.get(userId)
|
||
if (cached) return cached
|
||
|
||
if (getEnv().BOOTSTRAP_ADMIN_IDS.includes(userId)) {
|
||
const resolved = bootstrapAdmin(userId)
|
||
cache.set(userId, resolved)
|
||
return resolved
|
||
}
|
||
|
||
// Eine Abfrage, kein Nachfiltern in JavaScript.
|
||
const rows = await db.userRole.findMany({
|
||
where: { userId },
|
||
select: {
|
||
discordRoleId: true,
|
||
},
|
||
})
|
||
|
||
const roleIds = rows.map((r) => r.discordRoleId)
|
||
const mappings =
|
||
roleIds.length === 0
|
||
? []
|
||
: await db.roleMapping.findMany({
|
||
where: { discordRoleId: { in: roleIds } },
|
||
select: { clearanceLevel: true, permissions: true, grantsMembership: true },
|
||
})
|
||
|
||
let clearanceLevel = 0
|
||
let hasMembership = false
|
||
const permissions = new Set<Permission>()
|
||
|
||
for (const mapping of mappings) {
|
||
if (mapping.clearanceLevel > clearanceLevel) clearanceLevel = mapping.clearanceLevel
|
||
if (mapping.grantsMembership) hasMembership = true
|
||
for (const value of mapping.permissions) {
|
||
if (isPermission(value)) permissions.add(value)
|
||
}
|
||
}
|
||
|
||
const resolved: EffectivePermissions = {
|
||
userId,
|
||
clearanceLevel: Math.min(clearanceLevel, MAX_CLEARANCE),
|
||
permissions,
|
||
isAdmin: permissions.has('admin'),
|
||
hasMembership,
|
||
}
|
||
|
||
cache.set(userId, resolved)
|
||
return resolved
|
||
}
|