fix(kiosk): NFC-Login verlangt Pflicht-PIN als Zweitfaktor (Security-Audit K-3)

Bisher genügte die reine NFC-UID zum Einstempeln. Getestete Reader-Hardware
(günstiger USB-HID-RFID-Leser, EM4100 125kHz) liefert nur eine unverschlüsselte,
trivial klonbare Chip-ID - identisch zum in security_audit_kiosk_qr_nfc_2026_05_26
(K-3) beschriebenen Risiko, das bisher offen war.

- login_nfc() verlangt jetzt PIN, nutzt denselben Brute-Force-Lockout wie
  login_pin (keyed auf nfc_uid statt Personalnummer)
- Neuer Endpunkt POST /users/{id}/kiosk-nfc (Admin/HR) zum Zuordnen einer
  Karte zu einem Mitarbeiter - existierte bisher gar nicht, kiosk_nfc_uid
  war nur im Model vorhanden, nirgends setzbar
- Company-interner Unique-Check (eine Karte = ein Mitarbeiter)

Kein bestehendes Frontend nutzt NFC-Login bisher, daher kein Breaking Change.
Höhere Sicherheitsstufe (NTAG424 SUN, klon-resistent) bleibt vorgemerkt für
späteren Hardware-Wechsel (aktueller Reader kann keine Kryptografie).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Gis16MnuwkYcivLrSxK1pD
This commit is contained in:
2026-08-27 13:24:19 +02:00
co-authored by Claude Sonnet 5
parent cfa707d8f9
commit 3650da8022
7 changed files with 195 additions and 11 deletions
+41 -10
View File
@@ -3,7 +3,7 @@ Kiosk-User-Auth Service.
Unterstützte Methoden:
PIN → User über Personalnummer suchen, bcrypt-PIN prüfen
NFC → User über kiosk_nfc_uid suchen
NFC → User über kiosk_nfc_uid suchen, PIN als Pflicht-Zweitfaktor (K-3-Fix)
QR → QR-Token ist ein kurzlebiger Redis-Key (5 min, einmalig)
List → Kein Passwort, User wählt sich aus Liste (für vertrauenswürdige Umgebungen)
"""
@@ -181,20 +181,51 @@ class KioskAuthService:
async def login_nfc(
self,
nfc_uid: str,
pin: str,
company_id: uuid.UUID,
device_id: uuid.UUID,
db: AsyncSession,
) -> tuple[User, str]:
"""Authentifizierung per NFC-UID."""
user = await db.scalar(
select(User).where(
User.company_id == company_id,
User.kiosk_nfc_uid == nfc_uid,
User.is_active == True,
"""Authentifizierung per NFC-UID + Pflicht-PIN als Zweitfaktor.
Reine NFC-UIDs (MIFARE Classic/NTAG213 o.ä. wie sie günstige
HID-Keyboard-Reader liefern) sind trivial klonbar (Security-Audit
2026-05-26, K-3) die Karte allein ist daher kein ausreichender
Auth-Faktor. PIN-Pflicht macht aus "Karte kopiert" allein noch keinen
gültigen Login. Nutzt denselben Lockout-Mechanismus wie login_pin,
keyed auf die NFC-UID statt Personalnummer.
"""
import redis.asyncio as aioredis
from app.core.config import settings
redis_client = aioredis.from_url(settings.redis_url, decode_responses=True)
try:
await self._check_pin_lockout(device_id, nfc_uid, redis_client)
user = await db.scalar(
select(User).where(
User.company_id == company_id,
User.kiosk_nfc_uid == nfc_uid,
User.is_active == True,
)
)
)
if user is None:
raise HTTPException(status_code=401, detail="NFC-Karte nicht registriert.")
if user is None:
await self._record_pin_failure(device_id, nfc_uid, redis_client)
raise HTTPException(status_code=401, detail="NFC-Karte nicht registriert.")
if not user.kiosk_pin_hash:
raise HTTPException(
status_code=401,
detail="Kein PIN gesetzt. Bitte in den Profileinstellungen einen PIN vergeben.",
)
if not bcrypt.checkpw(pin.encode(), user.kiosk_pin_hash.encode()):
await self._record_pin_failure(device_id, nfc_uid, redis_client)
raise HTTPException(status_code=401, detail="Falscher PIN.")
await self._clear_pin_failures(device_id, nfc_uid, redis_client)
finally:
await redis_client.aclose()
session_token = await kiosk_session_service.create_session(
user_id=user.id,