Lizenzierung
Pläne, Plätze, Sitzungen, Instanzen, Domains, Check-ins, Karenzzeiten, Offline-Lizenzdateien, jeder Lizenzstatus, in dem sich die Brücke befinden kann, und wie man jeden einzelnen behebt.
Eine SQLly Embedded-Lizenz gibt an, wie viele Personen SQLly gleichzeitig nutzen können, von welcher Domain, auf wie vielen Bridges und bis wann. Die Bridge erzwingt dies anhand einer von sqlly.app unterzeichneten Genehmigung. Diese Seite behandelt die Regeln, dann jeden Zustand, in dem sich eine Bridge befinden kann, und was in jedem Fall zu tun ist.
Pläne
| Plan | Lizenzplätze | Tabs pro Seat | Bridges | Check-ins | Pro Jahr |
|---|---|---|---|---|---|
| SQLly Embedded Testversion | 1 | 1 | 1 | ja | kostenlos für 3 Monate |
| SQLly Embedded 5 | 5 | 4 | 1 | ja | $200 |
| SQLly Embedded 25 | 25 | 4 | 1 | ja | $500 |
| SQLly Embedded 100 | 100 | 4 | 1 | ja | $2000 |
| SQLly Embedded Offline 5 | 5 | 4 | keine Begrenzung | nie (Lizenzdatei) | $500 |
| SQLly Embedded Offline 25 | 25 | 4 | keine Begrenzung | nie (Lizenzdatei) | $1000 |
| SQLly Embedded Offline 100 | 100 | 4 | keine Begrenzung | nie (Lizenzdatei) | $5000 |
| SQLly Embedded 5 (mit Lifetime) | 5 | 4 | 1 | ja | In SQLly Lifetime enthalten, läuft nie ab |
Jedes sqlly.app-Konto bekommt die Testversion automatisch. Pläne kaufst du auf SQLly Embedded-Seite kaufen und auf der deiner Embedded-Seite. Brauchst du andere Konditionen, etwa mehr Benutzerplätze, mehr Bridges, ein festes Enddatum oder eine längere Karenzzeit? Wir können eine Lizenz mit eigenen Bedingungen ausstellen. Frag uns.
Die Regeln
Lizenzplätze
Lizenzplätze sind gleichzeitige Benutzer über jede Brücke der Lizenz hinweg. Ein Benutzer belegt einen Platz, solange er SQLly offen hat oder ein nicht abgelaufenes Start-Token besitzt, und gibt ihn frei, sobald beides weg ist. Jeder Platz darf mehrere Tabs gleichzeitig offen haben (siehe Tabelle). Deine App übergibt die Benutzer-ID beim Erstellen des Tokens, also entscheidest du, was als „ein Benutzer“ zählt.
Domain
Eine Domain pro Lizenz, und jede Subdomain davon ist eingeschlossen (example.com deckt ab app.example.com und eu.app.example.com). Die Brücke akzeptiert nur Browser, deren Origin übereinstimmt, plus localhost während --allow-localhost-origins aktiv ist. Lege die Domain jederzeit auf deiner Embedded-Seite fest, oder lass den ersten Check-in von einer Bridge, die mit --domain gestartet wurde, sie binden. Eine Lizenz ohne Domain funktioniert nur auf localhost, was für die Entwicklung ausreicht.
Bridges (Instanzen)
Eine verbundene Lizenz führt eine festgelegte Anzahl von Bridge-Prozessen gleichzeitig aus, einen bei Standardplänen. Einer zweiten Bridge mit derselben Lizenz wird mitgeteilt, dass sie nicht zugelassen ist, während die erste weiterhin eincheckt. Der Slot wird sofort frei, wenn eine Bridge sauber stoppt (Strg-C oder ein Dienststopp), oder 40 Minuten nachdem eine Bridge aufhört, einzuchecken. Offline-Lizenzen zählen Bridges nicht.
Check-ins (verbundene Lizenzen)
- Beim Start und alle 20 Minuten checkt die Bridge ein und erhält einen frisch signierten Grant, der 40 Minuten gültig ist.
- Wenn Check-ins fehlschlagen (sqlly.app oder dein ausgehendes Netz ist nicht erreichbar), arbeitet die Bridge weiter, bis 40 Minuten nach seiner letzten gültigen Zuweisung, dann geht veraltet und pausiert Abfragen. Der nächste erfolgreiche Check-in setzt die Arbeit ohne Neustart oder Seitenaktualisierung fort.
- Die Funktion des Admins Jetzt einchecken (
POST /manage/license/checkin) versucht sofort erneut.
Ablauf und Kulanz
Jede Lizenz funktioniert weiterhin für 15 Tage nach Ablauf ihrer Laufzeit (individuelle Lizenzen können ihre eigene Kulanzfrist festlegen). Während der Kulanzfrist sieht jeder SQLly-Benutzer „Die SQLly-Embedded-Lizenz für diese Website läuft in N Tagen ab. Bitte deinen Administrator, sie zu erneuern.“ Danach stoppen Abfragen mit "…ist abgelaufen." Die Erneuerung (die jährliche Zahlung für verbundene Pläne, eine neue Lizenzdatei für Offline-Pläne) bringt die Bridge ohne Neustart zurück: verbundene Bridges erfahren es beim nächsten Check-in, Offline-Bridges innerhalb einer Minute.
Offline-Lizenzdateien
Offline-Pläne sind für Server, die SQLly niemals kontaktieren dürfen. Lege zuerst die Domain auf deiner Embedded-Seite fest (die Datei enthält sie), dann Lizenzdatei herunterladen und starte die Bridge mit --license-file. Die Bridge liest die Datei jede Minute neu, Erneuern heißt also, die Datei zu ersetzen. Eine beschädigte oder fehlende Datei nach gutem Start behält die letzte gültige Lizenz und protokolliert eine Warnung. Beim Start ist das fatal, damit du es bemerkst.
Schlüssel und verknüpfte Installationen
Eine verbundene Lizenz hat einen Seiten-Schlüssel den du auf deiner Embedded-Seite generierst (wenn du ihn neu generierst, werden Bridges, die den alten verwenden, getrennt), plus beliebig viele verknüpfte Schlüssel, jeweils einen pro Installation, die über den Link-Flow. Jede verknüpfte Installation ist unter der Lizenz aufgeführt, wo du sie widerrufen kannst, ohne die anderen anzutasten.
Lizenzstatus
GET /manage/status zeigt den Zustand als license.state. Nur ok und grace führen Abfragen aus und stellen Start-Token aus.
| Status | Aktiv? | Was es bedeutet | Was zu tun ist |
|---|---|---|---|
ok | ja | Kürzlich überprüft; alles funktioniert. | Nichts. |
grace | ja | Der Zeitraum ist vor weniger Tagen abgelaufen, als die Kulanzfrist umfasst. Benutzer sehen einen Countdown. | Erneuern oder die Offline-Lizenzdatei ersetzen. |
stale | nein | Seit 40 Minuten kein erfolgreicher Check-in. | Prüfe den ausgehenden HTTPS-Verkehr vom Bridge-Host zu sqlly.app und die Host-Uhr (NTP), dann Jetzt einchecken. |
not_admitted | nein | Eine andere Bridge hält den Instanzplatz der Lizenz. | Stoppe die andere Bridge oder warte 40 Minuten, nachdem sie sich zuletzt gemeldet hat. |
expired | nein | Die Gnadenfrist ist vorbei. | Plan erneuern oder kaufen; offline: Datei herunterladen und ersetzen. |
revoked | nein | Der Schlüssel wurde regeneriert, die Installation wurde entkoppelt oder die Lizenz wurde widerrufen. | Verwende den aktuellen Schlüssel von deiner Embedded-Seite oder verknüpfe die Installation erneut. |
domain_mismatch | nein | Die Bridge wurde gestartet mit einem --domain der die Lizenz nicht gebunden ist. | Ändern SQLLY_EMBEDDED_DOMAIN oder der Domain auf deiner Embedded-Seite, damit sie übereinstimmen. |
unlicensed | nein | Gestartet ohne Schlüssel oder Datei und noch nicht verknüpft. Profile können trotzdem eingerichtet und getestet werden. | Verknüpfe über deine Admin-App oder starte mit einem Schlüssel oder einer Datei neu. |
Im Verweigerungszustand bleiben geöffnete SQLly-Tabs verbunden, und jede Anfrage erhält die Erklärung, die SQLly in seiner Statuszeile und als Benachrichtigung zeigt. Neue Tabs bekommen den Satz mitgeteilt und werden geschlossen (Code 4503), und Start-Tokens erhalten 503 license_not_ok mit demselben Satz in message.
Fehlerbehebung
| Symptom | Ursache und Lösung |
|---|---|
Die Bridge beendet sich beim Start mit unknown license key | Der Schlüssel wurde neu erzeugt oder falsch eingegeben. Kopiere den aktuellen Schlüssel von deiner Embedded-Seite. |
| Die Bridge beendet sich mit einem Fehler in der Lizenzdatei | Die Datei fehlt, ist beschädigt, über ihrem Hard-Stop-Datum hinaus oder für einen anderen Schlüssel signiert. Lade sie erneut herunter. |
| Browser erhält HTTP 403 vom WebSocket | Der Ursprung der Seite ist nicht die lizenzierte Domain, eine Subdomain oder localhost. Trage die Domain ein oder prüfe --allow-localhost-origins. |
Der Start schlägt fehl mit seat_limit | Alle Plätze sind belegt. Einen freigeben (DELETE /manage/seats/{user}) oder zu einem größeren Tarif wechseln. |
| Ein neuer Tab zeigt an, dass der Benutzer die maximale Anzahl an offenen Sitzungen hat | Du hast bereits so viele Tabs offen, wie dein Platz erlaubt. Schließe einen. |
| SQLly meldet, dass die Proxy-Sitzung nicht verbunden ist | Die Bridge wurde neu gestartet oder das Token ist abgelaufen. Lade die Seite neu; deine App erstellt ein neues Token. |
Status zeigt fromCache: true | Die Bridge wurde gestartet, während sqlly.app nicht erreichbar war, und läuft mit ihrer zwischengespeicherten Berechtigung. Sie benötigt innerhalb von 40 Minuten nach dieser Berechtigung ein erfolgreiches Check-in. |