NeoFS REST Gateway v0.17.0, S3 Gateway v0.43.0 fügen Sitzungstoken v2 hinzu

Neo SPCC hat kürzlich aktualisierte Versionen beider NeoFS-Zugriffsgateways veröffentlicht – REST Gateway v0.17.0 und S3 Gateway v0.43.0. Beide Versionen führen Session-Token-v2-Unterstützung ein, hängen vom NeoFS SDK Go RC18 ab und erfordern zum Erstellen Go 1.25 oder höher.

Die Gateways dienen als primäre Schnittstellen für Anwendungen, die mit dem dezentralen NeoFS-Speicher interagieren. Das REST-Gateway bietet HTTP-API-Zugriff, während das S3-Gateway eine Amazon S3-kompatible Schnittstelle bietet. Der Sitzungstoken v2, der erstmals in NeoFS Node v0.51.0 eingeführt wurde, ermöglicht eine detailliertere Zugriffskontrolle für Container- und Objektoperationen und ersetzt den vorherigen gemischten Sitzungs- und Trägertoken-Ansatz. Da nun beide Gateways das neue Format unterstützen, ist das koordinierte Upgrade, das mit NeoFS Node v0.52.0 und SDK RC18 begann, im gesamten NeoFS-Stack abgeschlossen.

REST-Gateway v0.17.0

Die wichtigste Ergänzung in v0.17.0 ist eine API zur Verwaltung von Containerattributen, die neue REST-Endpunkte für GET- und PUT-Vorgänge für Containerattribute verfügbar macht. Containerattribute sind Schlüsselwert-Metadaten, die das Verhalten und die Berechtigungen von Containern steuern. Bisher war für deren Verwaltung eine direkte Protokollinteraktion erforderlich. Die neue API bringt diese Funktionalität in jede Anwendung, die die REST-Schnittstelle verwendet.

Die Version umfasst außerdem eine umfassende Session-V2-Token-Validierung und einen Fix für ein Produktionsproblem, bei dem ungültige HTTP-Bearer-Tokens eine Panik verursachten. Mehrere veraltete Endpunkte, einschließlich der Such- und Container-Put-APIs, wurden zusammen mit den Konfigurationsoptionen „container_ops_poll_interval“ und „container_ops_timeout“ entfernt. Zu den Abhängigkeitsaktualisierungen gehört die Umstellung von neo-go von v0.116.0 auf v0.118.0.

S3 Gateway v0.43.0

S3 Gateway v0.43.0 bietet eine vollständige Neugestaltung der mehrteiligen Upload-Objektzuordnung, behebt einen Fehler, der Uploads mit mehr als 300 Teilen verhinderte, und behebt Fehler beim Abrufen einzelner Teile aus mehrteiligen Objekten. Die neue Architektur führt eine hierarchische Struktur mit Teilungsketten auf Teilebene und Objektebene ein und eliminiert mehrere Zwischenmetadatenattribute, die vom vorherigen System verwendet wurden.

Die mehrteilige Neugestaltung ist für Benutzer, die über die S3-Schnittstelle mit großen Dateien arbeiten, von Bedeutung, da die bisherige Obergrenze von 300 Teilen die maximale Dateigröße effektiv begrenzte. Die neue Architektur beseitigt diese Einschränkung und stellt gleichzeitig korrekte Metadaten und Nutzlast-Hashes für einzelne Teile sicher.

Parallel zur Multipart-Überarbeitung wurde die maximale Einzelpartgröße von 5 GB auf 4 GB reduziert, um sie an die NeoFS-Funktionen anzupassen. Die Mindestteilgröße bleibt gemäß S3-Spezifikation bei 5 MiB. Betreiber, die den Unterschied berücksichtigen, sollten beachten, dass die AWS S3-Spezifikation bis zu 5 GB pro Teil zulässt.

Die Unterstützung der Session-Token-v2-Authentifizierung rundet die wichtigsten Änderungen ab. Wie beim REST-Gateway wurde die Konfigurationsoption „container_ops_poll_interval“ entfernt. Zu den Abhängigkeitsaktualisierungen gehören neo-go v0.118.0, NATS v1.49.0 und AWS SDK v2 v1.41.2.

Beide Gateway-Releases sind auf GitHub unter den folgenden Links verfügbar: https://github.com/nspcc-dev/neofs-rest-gw/releases/tag/v0.17.0 https://github.com/nspcc-dev/neofs-s3-gw/releases/tag/v0.43.0