• 2026.10.10-mobile-pairing.2 fe8fc702a3

    enzcom-release hat es veröffentlicht 2026-10-10 09:44:33 +00:00 | 48 Commits zu main seit dieser Version

    ENZCOM Mobile: wiederholsichere gekoppelte Geräteanlage

    Entwicklungsbaustein 2026.10.10-mobile-pairing.2, noch ohne Produktivinstallation.
    Erweitert die vorhandene Plattform1.0.7 mit ID-basierter Tokenpolicy2. Keine neue
    HTTP-Route, keine Browser-Anmeldung und kein Android-Aufrufer in diesem Paket.
    Die gesamte zentrale Anmeldung ist damit ausdrücklich noch nicht fertig.

    Vertrag

    MailDevices::createForEnrollment(name, requestId, expectedEmail, deliver) ist
    eine interne Schnittstelle für einen späteren browserautorisierten Controller.
    Dieser muss Nextclouds strikte Kennwortbestätigung, CSRF und Rate-Limits erhalten.
    Die bestehende Browser-/Benutzer-/Dienst-/Erstellungsberechtigung wird zusätzlich
    vor und innerhalb der exklusiven Benutzersperre geprüft, bei Wartezeiten erneut.
    Der unveränderte Tokenadapter verwendet Besitzer und feste Token-ID.

    Der Aufrufer liefert eine zufällige 32-stellige Hex-Kennung für genau einen
    Einrichtungsfall und die zuvor authentifiziert gebundene E-Mail-Adresse.
    Die Kennung allein ist kein Berechtigungsnachweis. Ein vorhandener Geräte-Datensatz
    mit gleicher Kennung wird niemals automatisch übernommen.

    Vor dem ersten externen Schreibaufruf wird ein dauerhaftes, nichtgeheimes Journal
    angelegt. Der spätere Callback muss die einmal erhaltene Zugangsinformation
    verschlüsselt und empfängergebunden dauerhaft ablegen, bevor er zurückkehrt.
    Er muss bei fehlgeschlagener Ablage eine Exception werfen. Dieses Paket stellt
    noch keine solche Ablage oder Übertragung bereit; ein leerer Callback ist kein
    gültiger produktiver Aufrufer. Secrets werden nicht im Journal gespeichert.

    Erst nach Callback, erneuter Berechtigungsprüfung und aktiver nativer Kopplung
    lautet das Ergebnis HANDOFF_PREPARED. Das ist weder eine App-Einrichtung noch
    ein erfolgreicher Mail-/DAV-Netztest. Wiederholung prüft vorhandene Zuordnungen,
    liefert niemals erneut das Kennwort und erzeugt keine zweite Berechtigung.
    Nach Unklarheit, Widerruf oder fehlender Zuordnung folgt REVIEW_REQUIRED.
    Ein späterer Status-/Poll-Controller benötigt eigene aktuelle Autorisierungs-,
    Sitzungs-, Mandanten-, Ablauf- und Replayprüfungen.

    Bei Übergabefehlern wird zuerst DAV, danach Mail widerrufen. Die vorhandene
    Reconciliation bleibt für unklare externe Ergebnisse zuständig. Das neue Journal
    überlebt diese Bereinigung und verhindert eine automatische erneute Ausgabe.
    Pro Benutzer maximal200 Einrichtungsmarker; bei Erreichen stoppen, nicht alte
    Marker still löschen. Ablauf-/Abbruch-/Aufräumpolitik der gesamten Freigabe ist
    noch zu implementieren. Kein pauschales Versprechen sofortiger globaler Trennung.

    Reproduktion und Grenzen

    PHP8.3 oder neuer mit mbstring, keine Netzwerkverbindung erforderlich:

    sh test.sh
    

    102 Prüfungen:51 bestehende Lifecycle-/Autorisierungsfälle, an den aktuellen
    ID-Adapter angepasst, plus51 neue Übergabe-/Wiederholungs-/Fehlerfälle.
    Test läuft gegen echte Serviceklassen mit synthetischen In-Memory-Abhängigkeiten.
    Keine echten Konten, Mailinhalte, Credentials oder produktiven Konfigurationen
    werden benötigt. Kein echter SQL-/Redis-Lock-, HTTP-/Middleware-, Browser-,
    Kryptotransport- oder Android-Ende-zu-Ende-Nachweis.

    Version .2 ergänzt die im ersten eigenständigen Testpaket fehlende öffentliche
    Mail-Berechtigungsliste. Die Serviceänderungen selbst sind unverändert. Der
    Testbaukasten läuft jetzt ohne das historische Image als zusätzliche Quellbasis.
    Version .1 bleibt als Entwicklungsstand erhalten, für Reproduktion bitte .2 nutzen.

    baseline/ enthält die zu diesem Test gehörenden unveränderten aktuellen
    Token-/Mail-Adapter. Sie sind keine Aufforderung, diese Dateien produktiv zu
    überschreiben. overlay.json nennt Voraussetzungen und genau zwei Änderungen.
    apply.py prüft standardmäßig nur. --apply ist ausschließlich für einen
    angehaltenen, isolierten Entwicklungsbaum vorgesehen; vorher eigene Sicherung.
    Kein automatischer produktiver Rollout.

    Die historische Image-Quelle enthält noch Policy1, während der geprüfte
    Live-Adapter Policy2 verwendet. Deshalb vor einem späteren Produktivbau zwingend
    Live-/Build-/Image-Quellen konsolidieren und bestehende Policy2 erhalten. Nicht
    den historischen Image-Stand über die produktive Geräteverwaltung kopieren.

    Nächste Teile: verschlüsselte empfängergebundene Übergabe, browserautorisierter
    Controller, Poll-/Bestätigungs-/Abbruchprotokoll, Ablauf/Widerruf, Android-Aufrufer
    und Tests mit echten Nextcloud-Sitzungen vor dem produktiven Rollout.

    Downloads