Version 2.7.0: Pruefung beim Oeffnen, Unterschrift in menschlichem Mass

apps/tesm/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tesm"
-version = "2.6.1"
+version = "2.7.0"
 description = "TESM -- Verwaltung und Ueberwachung von PoE-Endgeraeten und Aruba-Switchen"
 requires-python = ">=3.11"
 dependencies = [

apps/tesm/src/tesm/blueprints/fileshare.py

@@ -215,6 +215,22 @@ def upload(token: str):
     return redirect(url_for("fileshare.browse", share=token, path=relative))
 
 
+@bp.get("/<token>/signature")
+@permission_required("fileshare.view")
+def signature_state(token: str):
+    """Passt die Datei noch zu ihrem Eintrag im Aenderungsprotokoll?
+
+    Die Vorschau fragt das beim Oeffnen. Eine unterschriebene Fassung, die
+    seither veraendert wurde, sieht man einer PDF sonst nicht an -- und genau
+    das ist die Frage, die man sich vor einer Unterschrift stellt.
+    """
+    mount = _mount_or_404(token)
+    try:
+        return service.signaturstand(db(), mount, request.args.get("path") or "")
+    except service.FileshareError as exc:
+        return {"error": str(exc)}, 400
+
+
 @bp.get("/<token>/folders")
 @permission_required("fileshare.view")
 def folders(token: str):

apps/tesm/src/tesm/services/fileshare.py

@@ -21,6 +21,7 @@ Sicherheitsrelevante Aenderungen gegenueber dem Vorgaenger:
 
 from __future__ import annotations
 
+import hashlib
 import zlib
 import logging
 import mimetypes
@@ -604,6 +605,83 @@ def resolve_path(mount: Mount, relative: str) -> Path:
     return target
 
 
+#: Wie eine unterschriebene Fassung im Aenderungsprotokoll steht. Die
+#: Pruefsumme ist der Anker -- sie steht im selben Eintrag wie der Name, den
+#: der Unterschreibende angegeben hat.
+SIGNATUR_AKTION = "fileshare.form_signed"
+
+
+def pruefsumme(pfad: Path) -> str:
+    """SHA-256 der Datei, blockweise gelesen."""
+    kessel = hashlib.sha256()
+    with pfad.open("rb") as strom:
+        for block in iter(lambda: strom.read(1024 * 1024), b""):
+            kessel.update(block)
+    return kessel.hexdigest()
+
+
+def signaturstand(conn: sqlite3.Connection, mount: "Mount", relative: str) -> dict[str, Any]:
+    """Ist diese Datei die, die unterschrieben wurde?
+
+    Drei moegliche Antworten, und die dritte ist die wichtigste:
+
+    * ``unveraendert`` -- es gibt einen Protokolleintrag mit genau dieser
+      Pruefsumme. Die Datei ist Byte fuer Byte die unterschriebene.
+    * ``veraendert`` -- es gibt einen Eintrag zu genau diesem Ablageort, aber
+      mit anderer Pruefsumme. Jemand hat nach der Unterschrift etwas an der
+      Datei geaendert. Das ist der Fall, wegen dem es diese Pruefung gibt.
+    * ``unbekannt`` -- kein Eintrag. Kein Verdacht: die meisten Dateien in
+      einer Freigabe sind nie durch TESM gegangen.
+
+    Gesucht wird nur in der Datenbank. Ausgelagerte Protokolltage (Archiv)
+    bleiben aussen vor -- ein Dateidialog darf nicht minutenlang suchen.
+    """
+    ziel = resolve_path(mount, relative)
+    if not ziel.is_file():
+        return {"status": "unbekannt"}
+    hash_ = pruefsumme(ziel)
+
+    zeile = Database.one(
+        conn,
+        "SELECT ts, actor, detail FROM audit_log WHERE action=? AND detail LIKE ? "
+        "ORDER BY id DESC LIMIT 1",
+        (SIGNATUR_AKTION, f"%sha256={hash_}%"),
+    )
+    if zeile is not None:
+        return {
+            "status": "unveraendert",
+            "sha256": hash_,
+            "zeit": str(zeile["ts"]),
+            "konto": str(zeile["actor"]),
+            "namen": _namen_aus_detail(str(zeile["detail"])),
+        }
+
+    # Nichts mit dieser Pruefsumme -- aber vielleicht etwas zu diesem Ort.
+    zeile = Database.one(
+        conn,
+        "SELECT ts, actor, detail FROM audit_log WHERE action=? AND detail LIKE ? "
+        "ORDER BY id DESC LIMIT 1",
+        (SIGNATUR_AKTION, f"{mount.label}:{relative} sha256=%"),
+    )
+    if zeile is not None:
+        return {
+            "status": "veraendert",
+            "sha256": hash_,
+            "zeit": str(zeile["ts"]),
+            "konto": str(zeile["actor"]),
+            "namen": _namen_aus_detail(str(zeile["detail"])),
+        }
+    return {"status": "unbekannt", "sha256": hash_}
+
+
+def _namen_aus_detail(detail: str) -> list[str]:
+    """Die angegebenen Namen aus dem Protokolltext -- ohne sie zu deuten."""
+    marke = "angegeben unterschrieben von: "
+    if marke not in detail:
+        return []
+    return [teil.strip() for teil in detail.split(marke, 1)[1].split(",") if teil.strip()]
+
+
 def list_directory(mount: Mount, relative: str = "") -> dict[str, Any]:
     path = resolve_path(mount, relative)
     if not path.is_dir():

apps/tesm/src/tesm/templates/tesm/fileshare.html

@@ -103,6 +103,7 @@
                       <button class="link-icon file-name" type="button"
                               data-dialog-open="file-preview"
                               data-fill-Src="{{ url_for('fileshare.preview', token=token, path=entry.relative) }}"
+                              data-fill-Pruefung="{{ url_for('fileshare.signature_state', token=token, path=entry.relative) }}"
                               data-fill-Kind="{{ entry.preview_kind }}"
                               data-fill-Pfad="{{ entry.relative }}"
                               data-fill-Name="{{ entry.name }}"
@@ -131,6 +132,7 @@
                       <button class="btn btn--sm btn--ghost" type="button"
                               data-dialog-open="file-preview"
                               data-fill-Src="{{ url_for('fileshare.preview', token=token, path=entry.relative) }}"
+                              data-fill-Pruefung="{{ url_for('fileshare.signature_state', token=token, path=entry.relative) }}"
                               data-fill-Kind="{{ entry.preview_kind }}"
                               data-fill-Pfad="{{ entry.relative }}"
                               data-fill-Name="{{ entry.name }}"
@@ -332,6 +334,9 @@
           </div>
         </div>
         {% endif %}
+        {# Das Ergebnis der Pruefung steht über der Leiste – wer eine
+           unterschriebene Fassung öffnet, soll es sehen, bevor er liest. #}
+        <p class="viewer__pruefung" data-viewer-pruefung hidden></p>
         <div class="viewer__bar" data-viewer-leiste hidden>
           <button class="btn btn--sm btn--ghost" type="button" data-viewer-zoom="aus"
                   aria-label="Verkleinern">{{ icon('minus', size=15) }}</button>