Magic-Link-Login

Pilot

Antworten auf die drei haeufigsten Login-Probleme: Email kommt nicht, Link abgelaufen, falsche Adresse. Inklusive Eskalations-Pfad zu Ops.

Phase 2 · 1st-Level-Hilfe

Problem 1: „Die Login-Email kommt nicht an“

Wenn trotzdem nicht da: Ops pruefen, ob sellx_central tatsaechlich eine Email verschickt hat (AuditLog nach email.sent filtern). Falls Eintrag fehlt: SMTP-Problem auf Server-Seite (siehe SMTP & Magic-Links).

Problem 2: „Der Link ist abgelaufen“

Magic-Links sind 24h gueltig. Nach Ablauf ruft der Kunde die Login-Seite erneut auf, gibt die Email ein und erhaelt einen neuen Link.

Problem 3: „Falsche Email-Adresse hinterlegt“

Kunde hat sich mit tippfehler@firma.de statt korrekt@firma.de registriert. Selbst im Portal nicht aenderbar (Phase 2). Ops muss die Email-Adresse manuell in der DB patchen.

Eskalation an Ops: Bitte folgenden AuditLog-Eintrag mit Verweis auf das Ticket anlegen und Ops via internen Channel benachrichtigen.

SQLemail-fix.sql

UPDATE self_service_customers
SET email = 'korrekt@firma.de',
    updated_at = datetime('now')
WHERE email = 'tippfehler@firma.de';

INSERT INTO audit_log (id, operator_id, action, target, request_id, created_at)
VALUES (
  gen_random_uuid(),
  'support-1',
  'customer.email_corrected',
  'customer:<id>',
  gen_random_uuid(),
  datetime('now')
);

FAQ

Wie lange ist ein Magic-Link gueltig?

Magic-Links sind 24 Stunden gueltig. Nach Ablauf muss ein neuer Link ueber die Login-Seite angefordert werden.

Ich habe mehrere Magic-Links bekommen — welcher gilt?

Jeder neue Login-Versuch erzeugt einen neuen Magic-Link und invalidiert alle vorherigen. Es gilt immer der juengste Link.

Kann ich mehrere Geraete gleichzeitig eingeloggt haben?

Ja. sellx-Central verwaltet pro Kunde eine Session-Liste. Logins auf weiteren Geraeten erweitern die Liste, einzelne Logins loeschen nur die jeweilige Session.

Was tun bei „Login fehlgeschlagen: invalid_grant“?

Der Link wurde bereits verwendet oder ist abgelaufen. Neuen Magic-Link anfordern. Falls der Fehler bei einem frischen Link auftritt: Ops prueft sellx_central-Logs (siehe Eskalation).

Google-Login (optional)

Falls der Pilotkunde sellx_central mit Google-Login konfiguriert hat (Phase 2, ffc9156), erscheint auf der Login-Seite zusaetzlich ein „Mit Google anmelden“-Button.

Konfiguration: Google-Cloud-Projekt → OAuth-Client → Authorized Redirect URI: https://portal.sellx.dev/api/auth/callback/google. Die GOOGLE_CLIENT_ID und GOOGLE_CLIENT_SECRET werden in den Env-Vars des Portals gesetzt.

Wie der Login beim Endkunden aussieht

Schritt-fuer-Schritt-Anleitung mit Screenshots im Funktions-Handbuch.