Client- und Bundle-Anbindung#

Eigener HTTP-Client#

Ein Client braucht HTTP POST, HMAC-SHA256 und sichere zufällige Nonces. Er erstellt eine JSON-Nutzlast, signiert die exakten Bytes mit Pfad, Key-ID, Zeitstempel und Nonce und sendet den Umschlag. Die Antwort wird vor der JSON-Auswertung signaturgeprüft. Das genaue Format und feste Testvektoren stehen unter Sicherheit.

Der öffentliche Python-Referenzclient zeigt den vollständigen Ablauf. Mit GET /v1/health kann der Client die API-Zeit für einen Zeitversatz ermitteln. Diese öffentliche Antwort ist kein signierter Datenbanknachweis.

Bei einem Timeout für dieselbe logische Schreiboperation dieselbe Nutzlast und denselben idempotencyKey verwenden, aber einen neuen Umschlag mit neuer Nonce signieren. Das gilt nur innerhalb des dokumentierten Aufbewahrungsfensters.

BlackICE-Bundles#

Server-Bundles laufen in einer Sandbox. SDK 1.1.0 bietet ausgehendes GET und POST über re.net.Http; deshalb sind auch Update und Delete hier POST-Operationen. Ziele müssen im Manifest erlaubt sein:

[Networking]
allowed = ["https://db.example.com"]

Der private VFS-Ordner wird nicht an Spieler gestreamt, bleibt aber durch Betriebssystemrechte zu schützen.

Verwende normalerweise den lt_database-Connector, statt Signatur und HTTP selbst in jedem Bundle zu implementieren. Dein Consumer bindet gemeinsame Typen und Helper ein und ruft Db.Sync, Insert, Find, Update, Upsert, Delete, Count oder Flush auf. Die tatsächlichen Connector-Exporte heißen Call und TakeResult; der Helper abstrahiert sie.

Reihenfolge#

1. API mit Key und eingeschränkten Namespaces betreiben.
2. API-Host im Connector-Manifest erlauben.
3. URL, Key-ID und Secret im privaten VFS eintragen.
4. Connector starten und lt-db-health prüfen.
5. Consumer starten, Schema deklarieren und auf erfolgreichen Callback warten.

Das erklärte C#-Beispiel zeigt alle Schritte innerhalb des Consumers. Für die gemeinsame Installation den Schnellstart lesen.

Bei Write-behind Db.IsQueued(result) prüfen. Db.Flush liefert einen Bericht; halted, remaining und deadLettered auswerten. Mit immediate: true einzelne Änderungen vor einer davon abhängigen Aktion live anwenden.