• 2026.10.10-mobile-browser.2 82328aca6f

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

    ENZCOM Mobile – browserbestätigte Kontoübergabe 0.1.0

    Vorab-Entwicklungsrelease 2026.10.10-mobile-browser.2. Nicht produktiv aktiviert.
    Dieser Serverbaustein ergänzt den verschlüsselten Mail-/DAV-Handoff um echte
    Nextcloud-Sitzungsprüfung, Browserfreigabe, Geräte-API und Hintergrundbereinigung.
    Der Android-Setup-Aufrufer und der gemeinsame produktive Anmeldetest fehlen noch.
    Vorhandene mobile Konten oder Anwendungen werden durch dieses Release nicht geändert.

    Ablauf und Vertrauensgrenzen

    1. Der native Setup-Client startet mit einem bereits bestätigten, eigenen
      Nextcloud-Gerätezugang. Er erzeugt eine zufällige 32-stellige Request-ID und
      Gerätekennung (Hex), einen nicht exportierbaren RSA-Schlüssel sowie voneinander
      unabhängige Poll- und Browsernachweise (je 32 zufällige Bytes, Hex).
    2. POST /ocs/v2.php/apps/enzcom_mobile_enrollment/api/v1/begin nimmt id,
      device, publicKey (SPKI-PEM), poll, nonce entgegen. Jede Geräte-API
      verlangt OCS-APIRequest: true und HTTP-Basic mit dem ursprünglichen nativen
      App-Passwort. Browser-Cookies, das allgemeine Kennwort oder ein anderes Token
      desselben Kontos reichen nicht. TLS ist für die tatsächliche Bereitstellung Pflicht.
    3. Identität, E-Mail-Adresse und Dienstziele werden serverseitig abgeleitet.
      Die Antwort enthält den unveränderlich gebundenen Kontext, Zustand und einen
      relativen authorizationPath. Der Client darf nur den erwarteten HTTPS-Ursprung
      verwenden und muss Kontext, Schlüsselbindung und Ablauf prüfen. Keine fremden
      URLs aus Eingaben oder Weiterleitungen übernehmen.
    4. Der Client öffnet diese Seite mit #nonce=<Browsernachweis> als Fragment,
      niemals als Query-Parameter. Die Seite entfernt das Fragment, hält den
      höchstens zehn Minuten nutzbaren Nachweis nur im Sitzungsspeicher dieses Tabs
      und führt gegebenenfalls durch die reguläre Nextcloud-Anmeldung zurück.
      Die Rücksprung-URL enthält keinen Nachweis. Gesperrter Tabspeicher führt nicht
      zu einem unsicheren URL-Fallback. Ein Browser-/Tabwechsel verlangt Neustart.
    5. Erst POST /authorize/{id}/review bindet den Nachweis an die echte
      Browser-Sitzung des richtigen Kontos. GET bindet nichts. Review und Freigabe
      verlangen den nativen CSRF-Nachweis; ein OCS-Header wird ausdrücklich abgelehnt.
    6. POST /authorize/{id} bestätigt mit dem echten Konto-Kennwort in derselben
      Anfrage
      (PasswordConfirmationRequired(strict: true) plus eigene Prüfung).
      Auch SSO-/Backend-Ausnahmen ersetzen diese Prüfung nicht. Kein App-Passwort
      als Ersatz und kein Übertragen des Konto-Kennworts an Mail oder DAV. Der Browser
      speichert dieses Kennwort nicht im Tabspeicher; JavaScript kann eine physische
      Löschung sämtlicher Speicher-/Netzwerkpuffer nicht garantieren.
    7. Der vorhandene native Aussteller erzeugt ein gekoppeltes Mail-/DAV-Gerätepaar.
      Verschlüsselung erfolgt mit RSA-OAEP-256 (auch MGF1-SHA256) und A256GCM. Erst
      nach bestätigter Ausgabe und erneuter Berechtigungsprüfung wird es abrufbar.
      Die Browserantwort enthält nur den Zustand, niemals Passwort oder Ciphertext.
    8. POST .../poll mit id,poll liefert wiederholt denselben verschlüsselten
      Umschlag, ausschließlich an den ursprünglichen Gerätezugang. POST .../ack
      verlangt zusätzlich den zufälligen, mitverschlüsselten receipt. Der Client
      darf erst nach bestätigter Speicherung durch beide geschützten Mail-/DAV-
      Empfänger quittieren. Die technische Quittierung allein beweist keinen Sync.
    9. POST .../cancel mit id,poll sperrt weitere Auslieferung. Begonnene Ausgabe
      wird widerrufen: zuerst DAV, dann Mail. Fehler bleiben REVOKE_PENDING und
      werden wiederholt geprüft. ACKED wird durch späten Abbruch nicht widerrufen.

    Alle Antworten sind no-store. Kein Kennwort oder Pollnachweis gehört in URLs,
    Logs, Kundentexte oder Browser-Speicher. Der kurzlebige Browsernachweis allein
    berechtigt weder zur Ausgabe noch zum Abruf. Server bindet Konto, ursprüngliche
    Token-ID, Browser-Sitzung, Anfrage, Empfänger, Dienstziele und Ablauf. Änderungen
    der Berechtigung oder unbekannter Directory-Status stoppen die Ausgabe/Auslieferung.
    Wiederholungen stellen keine zusätzlichen Zugänge aus. Maximal 200 dauerhafte
    Anfragemarker je Konto; eine sichere spätere Aufbewahrungsstrategie ist noch offen.

    Paketinhalte und Voraussetzungen

    • app/: eigenständige Nextcloud-App enzcom_mobile_enrollment 0.1.0, AGPL-3.0-or-later.
    • platform/: Erweiterung des bestehenden ENZCOM-Platform-Geräteausstellers.
      enrollmentCurrent ist eine interne, nicht ausstellende Statusprüfung;
      revokeEnrollment darf nur gebundene Journalanfragen bereinigen. Keine öffentliche
      Route mit frei wählbarem Besitzer oder frei wählbaren Credential-IDs.
    • baseline/: öffentliche Policy-2-Quellen zur Reproduktion. Nicht blind über
      eine neuere Installation kopieren; insbesondere vorhandene Betreiberänderungen
      und aktuelle Token-Policy erhalten.
    • tests/: ausschließlich isolierte Testadapter. Nie produktiv installieren.
      Das separate App-Archiv enthält keine dieser Ersatzdienste.

    Vorausgesetzt: Nextcloud 34, PHP >=8.5 mit OpenSSL, PDO-SQLite und POSIX,
    ENZCOM Platform mit nativer Gerätepolicy 2, eigenem device_management_enabled
    und vorhandener Mail-/DAV-Lifecycle-Anbindung. Betreiberseitige Dienstziele werden
    als App-Konfiguration targets mit exakt server,dav,imap,smtp gesetzt.
    server muss dem kanonischen overwrite.cli.url entsprechen, DAV HTTPS,
    IMAP imaps://…:993, SMTP smtps://…:465 oder smtp+starttls://…:587.
    Die tatsächliche Discovery-/Mandantenzuordnung darf dadurch nicht ersetzt werden.

    Der zusätzliche Schalter heißt enrollment_enabled, Standard aus (0).
    Nicht Nextclouds reservierten App-Schlüssel enabled überschreiben.
    Ein privates, dauerhaftes Verzeichnis /var/lib/enzcom-mobile-enrollment muss dem
    Web-/Cron-Benutzer gehören (0700); handoff.sqlite verlangt 0600. Nicht im Webroot
    ablegen. SQLite verwendet sofortige Schreibtransaktionen und synchronous=FULL.
    Kein Cleartext-Gerätepasswort wird dort gespeichert. Nach Ack wird die aktive
    Ciphertext-Nutzlast entfernt; dies ist keine physische Secure-Erase-Garantie.

    Der registrierte Cleanup-Job hat ein Mindestintervall von 60 Sekunden. Die
    tatsächliche Ausführung hängt vom Nextcloud-Cron ab; entsprechend überwachen.
    Er erledigt Ablauf/Widerruf auch ohne weiteres Polling. Unsichere Teilergebnisse
    werden nicht als Erfolg markiert. Abmeldung/Kontowechsel nach erfolgreicher
    Einrichtung benötigen weiterhin den gesonderten Geräte-Lifecycle.

    Noch kein automatischer Produktivinstaller: Zuerst aktuelle Server-/Image-
    Quellen konsolidieren, Dienstintegration und Android-Aufrufer fertigstellen,
    Sicherung/Rollback und kontrollierte Freigabe der Gesamtfunktion vorbereiten.

    Prüfungen und Grenzen

    Der HTTP-Test installiert eine frische echte Nextcloud in einem Wegwerfcontainer.
    Echte Benutzer, Cookie-Sitzungen, native App-Tokens, CSRF, Kennwortbestätigung,
    OCS-Middleware und SQLite werden verwendet. Directory und externer Maildienst
    sind ausdrücklich synthetisch. Zufällige Testzugänge bleiben im Container-Tmpfs;
    ausgegeben werden nur benannte Prüfergebnisse. Kein Zugriff auf Produktivdaten.
    Zusätzlich laufen 102 bestehende Aussteller-/Lifecycle-Regressionen und 23
    JavaScript-Ablauffälle. Letztere verwenden eine synthetische DOM-/HTTP-Umgebung,
    keinen optisch abgenommenen oder realen SSO-Browser.

    Abgedeckt: fremde Konten, fehlende/unechte Browserfreigabe, CSRF, OCS-Bypass,
    Sitzungsbindung, Cookie-only-API, abweichendes Ursprungstoken, verlorene Antworten,
    verschlüsselte Quittierung, Rechteentzug, Ablauf, Widerruf/Teilfehler und Wiederholung.
    Keine pauschale Sicherheitsgarantie, kein realer Stalwart-/Directory-/OIDC-
    Ende-zu-Ende-Nachweis und noch kein vollständiger Einrichtungstest am Fairphone.

    Reproduktion: node tests/browser.mjs, sh tests/regressions.sh (PHP 8.5).
    Für HTTP sh tests/run-http.sh <lokales Nextcloud-34.0.4-PHP-8.5-Image> verwenden.
    Das Image muss den normalen Quellbaum /usr/src/nextcloud enthalten; keine
    produktiven Volumes/Umgebungsvariablen übergeben. Das Testscript erstellt nur
    flüchtige Daten und ersetzt seine isolierten Dienste durch die Testadapter.
    Im eingesetzten Testhost wurde das PIDs-Cgroup-Limit nicht unterstützt; Docker
    meldet das ausdrücklich. Netzwerkisolation, Read-only-Root und Speicherlimit
    bleiben gesetzt. Ein Host-Härtungsnachweis ist damit nicht verbunden.

    Revision .2 korrigiert ausschließlich die dokumentierte SMTP-STARTTLS-URI auf
    smtp+starttls://…:587. Der App-/Servicecode bleibt gegenüber .1 unverändert;
    Tests werden für den vollständigen neuen Quellstand erneut ausgeführt.

    Downloads