Ablage auf WORM-Speicher

Worum es geht

WORM heißt write once, read many: einmal schreiben, beliebig oft lesen, nie ändern. CRMS legt die Bytes jedes endgültigen Dokuments in einen solchen Speicher. Technisch ist das ein S3-Bucket mit Object Lock. S3 ist eine weit verbreitete Schnittstelle für Objektspeicher (zum Beispiel MinIO, AWS, OBS). Object Lock ist die Funktion von S3, die ein Objekt bis zu einem Datum sperrt.

CRMS sperrt im Compliance-Modus. In diesem Modus kann niemand ein Objekt vor Ablauf der Sperre löschen oder ändern, auch nicht der Betreiber mit vollen Rechten am Bucket.

Was beim Ablegen passiert

• Der Bucket sieht nur verschlüsselte Bytes. Wer den Bucket lesen kann, kann das Dokument noch lange nicht lesen.
• Die Sperre wird auf die volle Sekunde aufgerundet. Sie ist nie kürzer als das, was die Revision festhält.
• Jeder Zugriff nennt die Versionskennung. Auf einem gesperrten Bucket „gelingt“ ein Löschen ohne Version, setzt aber nur eine Löschmarke, und das Objekt bleibt. CRMS fragt deshalb immer genau die Version an.

Die Schlüssel

Jeder Dokumentschlüssel wird selbst verschlüsselt gespeichert, „eingepackt“ mit dem Schlüssel-Schlüssel aus CODAMAI_CRMS_DOCUMENT_KEY (256 Bit, Base64). Den Schlüssel-Schlüssel braucht CRMS, solange Dokumentrevisionen an sind. Fehlt er, startet CRMS nicht.

Das Einpacken ist an Kennung und Eigentümer des Dokumentschlüssels gebunden. Kopiert jemand eingepackte Bytes in eine andere Zeile, lassen sie sich dort nicht auspacken.

Ein eigener Schlüssel je Dokument erlaubt das Löschen durch Schlüsselvernichtung, siehe Aufbewahrung, Legal Hold und Löschung.

Was CRMS beim Start prüft

CODAMAI_CRMS_STORAGE_ALLOW_UNLOCKED=true ist nur für die Entwicklung gedacht. Ohne Sperre ist der Speicher kein WORM-Speicher mehr.

Der Bucket

• Er heißt so, wie CODAMAI_CRMS_DOCUMENT_BUCKET sagt. Die Variable ist Pflicht.
• Du legst ihn an, nicht CRMS, und zwar mit Object Lock. Auf vielen S3-Speichern lässt sich Object Lock nicht nachträglich einschalten. Wer einen Bucket anlegen darf, könnte ihn auch ohne Sperre anlegen. Deshalb tut CRMS es nicht selbst.
• Die Verbindung ist für alle CodamAI-Module dieselbe: CODAMAI_S3_ENDPOINT, CODAMAI_S3_ACCESS_KEY, CODAMAI_S3_SECRET_KEY, dazu CODAMAI_S3_REGION (Standard us-east-1) und CODAMAI_S3_PATH_STYLE (Standard true, MinIO braucht das). Jedes Modul nennt nur seinen eigenen Bucket. Alle Variablen stehen unter Konfiguration.

Wer den Speicher mitbringt

Sind Dokumentrevisionen aus (CODAMAI_CRMS_DOCUMENT_REVISIONS=false), braucht keine Betriebsart einen Speicher. FINAL wird dann abgelehnt. Mehr zu den Betriebsarten unter Eingebettet oder als eigener Dienst.

Fehler aus dem Speicher

Fallen

Weiter

• Aufbewahrung, Legal Hold und Löschung
• Konfiguration
• Was ein endgültiges Dokument ist