Dokumentspeicher konfigurieren (Local, Azure, S3)

Die Einstellungen des Dokumentenspeichers legen fest, wo der MobilityManager hochgeladene Dateien schreibt. Es gibt eine aktive Konfiguration, und sie gilt global. Sie können den Speicher auf einen lokalen Festplattenpfad, Azure Blob Storage oder einen S3-kompatiblen Bucket verweisen. Dieser Artikel erläutert jeden Anbieter und wie Sie sicher zwischen ihnen wechseln.

Erforderliche Berechtigung

Das Lesen und Aktualisieren der Einstellungen des Dokumentenspeichers erfordert settings:manage. Konfigurieren Sie sie unter /admin/document-management.

Die drei Anbieter

Local

Basispfad (erforderlich) — das Verzeichnis, in dem Dokumente gespeichert werden. Der Wert wird vor dem Speichern validiert und normalisiert.
Verschlüsselungsschlüssel — ein optionaler base64-codierter 32-Byte-AES-Schlüssel, der in der Datenbank gehalten wird. Wenn die Verschlüsselung im Ruhezustand aktiviert ist, ist eine Verschlüsselungsschlüssel-Referenz erforderlich und muss sich aus der Konfiguration auflösen lassen.

Azure Blob

Containername (erforderlich).
Referenz der Verbindungszeichenfolge (erforderlich) — eine Secret-Referenz, nicht die rohe Verbindungszeichenfolge.
Blob-Service-URI (optional).

S3

Bucket-Name (erforderlich).
Region (erforderlich).
Access-Key-Referenz und Secret-Key-Referenz (beide erforderlich) — Secret-Referenzen.
Service-URL (optional) — legen Sie diese für S3-kompatible Endpunkte fest.

Hinweis: Cloud-Zugangsdaten werden als Secret-Referenzen gespeichert, die die Plattform aus ihrer sicheren Konfiguration auflöst. Die rohen Zugangsdaten und der lokale Verschlüsselungsschlüssel werden von der Einstellungs-API niemals zurückgegeben — ein Lesevorgang meldet lediglich, ob ein lokaler Schlüssel gesetzt ist, sodass die Benutzeroberfläche eine Schlüsselrotation anbieten kann, ohne den Wert offenzulegen.

Anbieter wechseln

Öffnen Sie /admin/document-management.
Wählen Sie den Anbieter: Local, Azure Blob oder S3.
Füllen Sie die Pflichtfelder dieses Anbieters aus.
Speichern. Die Plattform validiert die Eingabe, aktiviert den neuen Anbieter und leert die Felder, die zu den anderen Anbietern gehören.

Es werden nur unterstützte Anbieterwerte akzeptiert; alles andere wird mit einer Meldung "Unsupported providerType" abgewiesen. Fehlende Pflichtfelder geben einen eindeutigen Validierungsfehler zurück, der das Feld benennt.

Umgang mit dem lokalen Verschlüsselungsschlüssel

Wenn Sie eine Local-Konfiguration speichern, ohne einen neuen Verschlüsselungsschlüssel anzugeben, bleibt der vorhandene Schlüssel erhalten. Ein neu angegebener Wert muss ein gültiger base64-codierter 32-Byte-AES-Schlüssel sein, andernfalls wird das Speichern abgewiesen.

Warnung: Das Ändern des lokalen Verschlüsselungsschlüssels macht Dokumente, die unter dem vorherigen Schlüssel verschlüsselt wurden, dauerhaft nicht mehr entschlüsselbar — es gibt keine erneute Verschlüsselung und keinen Schlüsselbund. Rotieren Sie den Schlüssel nur, wenn Sie dies verstehen; die Plattform bewahrt den aktuellen Schlüssel bei jedem Speichervorgang, der ihn auslässt, gerade zur Vermeidung eines versehentlichen Verlusts.

Tipp: Ein Anbieterwechsel ändert, wohin neue Dokumente geschrieben werden. Vorhandene Dokumente verbleiben am vorherigen Speicherort. Planen Sie eine Migration, wenn Sie historische Dateien unter dem neuen Anbieter benötigen.

Nach dem Speichern überprüfen

Öffnen Sie die Einstellungen erneut, um den aktiven Anbieter und seine Felder zu bestätigen.
Laden Sie ein Testdokument hoch und bestätigen Sie, dass es gespeichert und abrufbar ist.
Bestätigen Sie bei Local mit aktivierter Verschlüsselung, dass sich die Schlüsselreferenz auflöst.