OpenCloud-Integration für Administrator:innen

Diese Anleitung beschreibt die Installation und den Betrieb der OpenCloud-Web-Erweiterung für SimpleDMS.

Unterstützte Versionen

  • OpenCloud: 7.2.4 und neuer
  • SimpleDMS: 1.17.0 und neuer

Installation

  1. Erzeuge ein starkes Passwort nur für diese Integration. Es muss die OpenCloud-Passwortrichtlinie für öffentliche Freigabelinks erfüllen.
  2. Setze die öffentliche OpenCloud-URL und das Passwort als Umgebungsvariablen für SimpleDMS:
SIMPLEDMS_OPENCLOUD_ORIGIN=https://cloud.example.com
SIMPLEDMS_OPENCLOUD_PUBLIC_LINK_PASSWORD=<same-policy-compliant-password>
  1. Lade die kompilierte Erweiterung simpledms-integration.zip aus dem aktuellen GitHub-Release herunter. Verwende nicht das automatisch erzeugte Quellcode-Archiv.
  2. Entpacke die ZIP-Datei nach $OC_DATA_DIR/web/assets/apps/simpledms-integration. manifest.json und das Verzeichnis js/ müssen direkt in diesem Verzeichnis liegen.
  3. Ergänze $OC_CONFIG_DIR/apps.yaml. Verwende dasselbe Passwort wie in SimpleDMS:
simpledms-integration:
  config:
    simpledmsBaseUrl: 'https://simpledms.example.com'
    opencloudPublicLinkPassword: '<same-policy-compliant-password>'
  1. Starte SimpleDMS und OpenCloud neu. Erstelle den SimpleDMS-Container neu, wenn du die Umgebungsvariablen über Docker Compose übergibst. Lade anschliessend OpenCloud Web im Browser neu.

Bei opencloud-compose liegt die Erweiterung unter opencloud-compose/config/opencloud/apps/simpledms-integration. Die Konfiguration liegt in opencloud-compose/config/opencloud/apps.yaml.

Admin-Konfiguration

  • SIMPLEDMS_OPENCLOUD_ORIGIN enthält die öffentliche OpenCloud-URL mit Protokoll, Hostname und gegebenenfalls Port, aber ohne Pfad.
  • simpledmsBaseUrl enthält die öffentliche SimpleDMS-Basis-URL.
  • SIMPLEDMS_OPENCLOUD_PUBLIC_LINK_PASSWORD und opencloudPublicLinkPassword müssen exakt übereinstimmen.
  • Öffentliche Freigabelinks müssen in OpenCloud aktiviert sein. Die vorgesehenen Benutzer:innen benötigen die Berechtigung, solche Links zu erstellen.
  • Beide öffentlichen URLs müssen HTTPS verwenden. HTTP ist nur für lokale Loopback-Entwicklung erlaubt. Dafür muss SimpleDMS mit -dev laufen.
  • Das SimpleDMS-Backend muss die öffentliche OpenCloud-URL erreichen und deren TLS-Zertifikat vertrauen.
  • Die OpenCloud-App-Konfiguration wird an den Browser ausgeliefert. Verwende deshalb ein eigenes Integrationspasswort und kein Kontopasswort.

Installation prüfen

  1. Melde dich mit einem regulären OpenCloud-Konto an, das öffentliche Freigabelinks erstellen darf.
  2. Wähle eine herunterladbare Datei. Nach SimpleDMS exportieren muss im Kontextmenü und im Tab Aktionen erscheinen.
  3. Starte den Export und schliesse den Import in SimpleDMS ab.
  4. Prüfe, ob die Datei in SimpleDMS verfügbar ist und der temporäre Freigabelink in OpenCloud entfernt wurde.

Hinweise

  • Die Erweiterung erstellt einen passwortgeschützten öffentlichen view-Link. SimpleDMS lädt die Datei über den öffentlichen WebDAV-Endpunkt von OpenCloud herunter.
  • Der Link ist kein Einmal-Token. Die Erweiterung widerruft ihn nach der Übertragung. Bleibt der Widerruf aus, läuft der Link am Ende des Tages ab.
  • Der ursprüngliche OpenCloud-Tab muss bis zum Ende der Übertragung geöffnet bleiben, damit der Link widerrufen werden kann.
  • Die Import-URL enthält kein Passwort, aber den Freigabe-Token und die Berechtigungs-ID. Protokolliere oder teile keine vollständigen Import- und Download-URLs.
  • In einem Container verweist localhost auf den Container selbst. Verwende für lokale Installationen eine OpenCloud-URL, die das SimpleDMS-Backend erreichen kann.

Fehlerbehebung

  • Aktion fehlt: Prüfe simpledmsBaseUrl, opencloudPublicLinkPassword und die Berechtigung für öffentliche Freigabelinks. Die Aktion erscheint nur für eine einzelne herunterladbare Datei.
  • Passwortanforderungen nicht erfüllt oder HTTP 400: Verwende in beiden Systemen ein Passwort, das die OpenCloud-Passwortrichtlinie erfüllt.
  • HTTP 401 beim Download: Stelle sicher, dass beide Konfigurationen exakt dasselbe Passwort enthalten. Starte SimpleDMS nach einer Änderung neu.
  • HTTP 403 beim Download: Prüfe, ob OpenCloud eine herunterladbare view-Freigabe erstellt hat.
  • HTTP 404 oder 410 beim Download: Starte einen neuen Export. Der Link fehlt, ist abgelaufen oder wurde widerrufen.
  • TLS- oder Verbindungsfehler: Prüfe DNS, Zertifikatsvertrauen und die direkte Erreichbarkeit von OpenCloud aus SimpleDMS.
  • Link bleibt nach dem Import bestehen: Lass den OpenCloud-Tab geöffnet und prüfe die Browser-Konsole auf Fehler beim Widerruf. Der Link bleibt andernfalls bis zum Ablauf nutzbar.

Verwandte Inhalte