Hardware-Reaktivierung

Pilot

Wenn der Kunde einen neuen Server / ein neues Laptop hat, muss das sellx Hub-Lizenz-Token an die neue Hardware gebunden werden. Pilot-Feature (Phase-2-Folge #2, c1d3aa4).

Phase 2 · 1st-Level-Hilfe

Wann tritt das Problem auf?

Kunde meldet: „Hub startet, fragt aber nach Aktivierung“ oder „Plugin-Liste ist leer“ obwohl Subscription in Central aktiv ist. Im AuditLog von Central findet sich:

SQLaudit-check.sql

SELECT * FROM audit_log
WHERE action = 'license.hardware_mismatch'
ORDER BY created_at DESC LIMIT 10;

Die token_version wurde nicht inkrementiert, aber der Hardware-Fingerprint im JWT passt nicht mehr zur aktuellen Maschine (Phase 2 — Hardware-Binding).

Schritt-fuer-Schritt: Was der Kunde im Portal tut

Portal aufrufen

Der Kunde navigiert zu https://portal.sellx.dev/dashboard/hardware und sieht dort aktuelle Hardware + Aktivierungs-Button.

Aktivieren klicken

Portal ruft POST /api/v2/customers/me/reactivate auf. sellx_central prueft Subscription-Status (muss active oder trialing sein).

Token-Version wird inkrementiert

license.token_version_incremented im AuditLog. Aktuelles JWT verliert sofort Gueltigkeit.

Hub ruft neuen Token ab

Innerhalb von max. 60s pollt Hub den /api/v2/license/activate Endpoint mit dem aktuellen hardware_fingerprint + dem alten Token. Central signiert ein neues JWT mit der inkrementierten Token-Version und dem neuen Fingerprint.

Hub speichert neuen Token

In %APPDATA%/sellx-hub/license.jwt, Plugins sind sofort wieder nutzbar.

Was der Supporter prueft

Subscription in Central aktiv?

SELECT subscription_status FROM self_service_customers WHERE email = ? — muss 'active' oder 'trialing' sein.

AuditLog-Eintrag vorhanden?

Phase 2 hat das Hintergrund-Polling im Hub implementiert. Wenn der Eintrag nach 2 Min nicht da ist, hat der Hub den Endpoint nicht erreicht.

Mehrere Reaktivierungs-Versuche am Tag?

Pruefen

Koennte auf wiederholten Token-Verlust deuten (z.B. Hub-Datenbank wird bei jedem Boot geloescht). Engineering-Channel informieren.

Falsche Email im Hub gespeichert?

Pruefen

Hub-Logs auf '[license] Email mismatch' greppen. Wenn die lokale Hub-Email von der Central-Email abweicht, lehnt Central die Reaktivierung ab.

FAQ

Wieviele Reaktivierungen sind erlaubt?

Maximal 3 pro 30 Tage. Bei Ueberschreitung lehnt Central mit HTTP 429 ab — Ops muss manuell helfen.

Funktioniert Reaktivierung in der Grace-Period?

Nein — bei subscription_status = grace lehnt Central ab. Kunde muss erst Plan aktivieren (Stripe-Checkout).

Werden Plugins durch die Reaktivierung neu installiert?

Nein. Nur das Lizenz-Token wird erneuert. Alle Plugin-Installationen, Workspace-Tabs und Settings bleiben unveraendert.

Kann ich die Reaktivierung auch per Email anfordern?

Nein — Reaktivierung laeuft ausschliesslich ueber das Portal unter /dashboard/hardware. Email-Anfragen loesen Ops-Eskalation aus.

Reaktivierung klappt nicht

Symptom:Kunde klickt „Aktivieren“, bekommt aber nach 2 Min immer noch kein neues Token. Hub zeigt wieder „Aktivierung erforderlich“.

Diagnose-Schritte fuer Ops:

Bashops-diag.sh

# 1. AuditLog der letzten 10 Minuten
SELECT * FROM audit_log
WHERE customer_id = 'cust_abc'
  AND created_at > datetime('now', '-10 minutes')
ORDER BY created_at DESC;

# 2. Aktuelle License ansehen
SELECT * FROM licenses
WHERE customer_id = 'cust_abc';

# 3. Hub hat versucht zu pollen — sieht man in sellx_central-Logs
grep 'license.activate' sellx_central.log | tail -20

# 4. Falls gar keine Anfrage ankommt: Hub-Polling-Check
#    -> Bug: alter Token nicht mehr valide, aber Hub versucht es mit
#       altem Hardware-Fingerprint. Phase-2-Fix: token_version_incremented
#       muss VOR dem ersten Hub-Poll erfolgen.

Letzter Ausweg (Ops manuell): IReactivationService.ForceReactivate(customerId) via dotnet run --project tools/reactivate-cli. Setzt Token-Version und Hardware-Fingerprint in einem Schritt. AuditLog zwingend erforderlich.

Was der Kunde im Hub sieht

Einstellungen → Hardware-Status und Re-Aktivierung aus Endkunden-Sicht (mit Screenshots).