Lizenzierungs-Konsole

Der Lizenzierungsbereich der Admin-Konsole ermöglicht es dir, Richtlinien zu erstellen, Schlüssel auszustellen und zu verwalten, Automatisierung zu konfigurieren und die Nutzung zu überwachen — alles ohne Code zu schreiben.

Zugang über die Seitenleiste: Licensing → Policies | Keys | Usage | Automation.

Richtlinien

Richtlinien definieren die Regeln für eine Lizenz: welche Funktionen enthalten sind, wie viele Plätze/Geräte erlaubt sind, wann sie abläuft und wie die Validierung funktioniert.

Richtlinie erstellen

1. Gehe zu Licensing → Policies und klicke auf New Policy
2. Schritt 1 — Gib einen Namen (z. B. „Pro Plan”) und Slug (z. B. pro-plan) ein
3. Schritt 2 — Dimensionen konfigurieren:
   • Schlüsselformat — Passe Präfix, Zeichensatz, Segmentanzahl/-länge und Trennzeichen an. Eine Live-Vorschau zeigt das generierte Format (z. B. VIG-XXXX-XXXX-XXXX-XXXX)
   • Plätze — Aktivieren, um gleichzeitige Benutzer zu begrenzen. Standard-Maximum festlegen
   • Geräte — Aktivieren, um aktivierte Geräte zu begrenzen. Standard-Maximum festlegen
   • Funktionen — Aktivieren, um eine Reihe von Feature-Flags zu definieren (z. B. analytics, export, api-access)
   • Ablauf — Aktivieren, um einen Standard-Ablauf in Tagen festzulegen
4. Schritt 3 — Validierungsmodus wählen:
   • Online — Jede Validierung ruft die API auf (am besten für SaaS)
   • Hybrid — Online zuerst, JWT-Fallback offline (am besten für Desktop)
   • Offline — Nur JWT, kein Netzwerk erforderlich (am besten für Air-Gapped-Umgebungen)

Richtlinie bearbeiten

Klicke in der Richtlinienliste auf das ⋮-Menü → Edit. Du kannst Name, Validierungsmodus, Dimensionen, Offline-Karenzzeit und Widerrufs-TTL ändern.

Richtliniendetails anzeigen

Klicke auf ⋮ → View, um die vollständige Richtlinien-Detailseite anzuzeigen, einschließlich:

• Status, Validierungsmodus und Dimensionsübersicht
• Richtlinienkonfiguration (Offline-Karenz, Widerrufs-TTL, Standard-Plätze/-Geräte/-Ablauf)
• Schlüsselformat-Vorschau
• Alle unter dieser Richtlinie ausgestellten Schlüssel

Schlüssel

Schlüssel ausstellen

1. Gehe zu Licensing → Keys und klicke auf Issue Key
2. Wähle eine Richtlinie
3. Wähle den Lizenznehmertyp (USER, ORG, DEVICE)
4. Gib optional eine Lizenznehmer-ID und Notizen ein
5. Klicke auf Issue Key

Der Schlüssel wird im in der Richtlinie definierten Format generiert (z. B. VIG-A8BC-D3EF-G4HJ-K5LM).

Schlüssellisten-Funktionen

• Suche — Nach Schlüsselzeichenkette oder Lizenznehmer-ID filtern
• Statusfilter — Nur aktive, gesperrte, abgelaufene oder widerrufene Schlüssel anzeigen
• Ablaufwarnungen — Schlüssel, die innerhalb von 7 Tagen ablaufen, zeigen ein bernsteinfarbenes „Läuft bald ab”-Badge
• CSV-Export — Die vollständige Schlüsselliste als CSV herunterladen
• Paginierung — Durch große Schlüsselmengen navigieren

Schlüsselaktionen

Über das ⋮-Menü bei jedem Schlüssel:

Schlüssel-Detailseite

Klicke auf View, um die vollständige Schlüssel-Detailseite mit drei Tabs anzuzeigen:

• Entitlements — Lizenznehmer-Informationen, Funktionen, Ablauf, Plätze, Richtlinie, Erstellungsdatum
• Seats — Zugewiesene Benutzer anzeigen, neue Plätze zuweisen, Plätze freigeben
• Devices — Aktivierte Geräte anzeigen, Geräte entfernen

Validierungstester

Klicke auf Validate Key auf der Schlüsselseite, um den Validierungstester zu öffnen. Füge einen beliebigen Schlüssel ein, um ihn gegen die API zu testen — sieh, ob er gültig ist, und überprüfe Funktionen, Status und Ablauf.

Nutzung

Die Seite Licensing → Usage zeigt aggregierte Statistiken:

• KPI-Karten: Gesamte Richtlinien, gesamte Schlüssel, aktiv, widerrufen, gesperrt, abgelaufen
• Richtlinienverteilung: Wie viele Schlüssel pro Richtlinie ausgestellt sind
• Neueste Schlüssel: Die zuletzt ausgestellten Schlüssel mit Status-Badges

Automatisierung

Automatisierungsregeln verbinden Zahlungsereignisse mit Lizenzaktionen. Wenn ein Kunde bezahlt, wird automatisch ein Schlüssel ausgestellt.

Regel erstellen

1. Gehe zu Licensing → Automation und klicke auf New Rule
2. Gib einen Regelnamen ein
3. Wähle den Anbieter (Stripe, PayPal oder Manual)
4. Wähle das auslösende Ereignis (z. B. Checkout Completed)
5. Wähle die Aktion (z. B. Issue Key)
6. Verknüpfe optional eine Richtlinie (erforderlich für die Aktion Issue Key)

Unterstützte Anbieter und Ereignisse

Webhook-Einrichtung

Damit die Automatisierung funktioniert, musst du Webhooks in deinem Zahlungsanbieter konfigurieren:

Stripe:

1. Gehe zum Stripe-Dashboard → Developers → Webhooks
2. Endpunkt hinzufügen: https://your-auris-domain/api/licensing/webhooks/stripe
3. Ereignisse auswählen: checkout.session.completed, invoice.paid
4. Kopiere das Signiergeheimnis nach STRIPE_LICENSING_WEBHOOK_SECRET

PayPal:

1. Gehe zum PayPal Developer Dashboard → Webhooks
2. Endpunkt hinzufügen: https://your-auris-domain/api/licensing/webhooks/paypal
3. Setze PAYPAL_LICENSING_WEBHOOK_SECRET und PAYPAL_LICENSING_WEBHOOK_ID