Skip to content

OpenGewerk 0.6.4

Choose a tag to compare

@github-actions github-actions released this 30 Oct 05:14
· 156 commits to main since this release
v0.6.4
22fe6e3

Bitte gleich auf 0.6.5 aktualisieren. Die Migration 0095_address_confirmations dieser Fassung bestätigt auf einer Instanz keine E-Mail-Adresse, die es schon gibt, anders als unten beschrieben; 0.6.5 holt das mit 0096_confirm_existing_addresses nach.

Diese Fassung enthält eine Sicherheitskorrektur. Was betroffen war, steht im Abschnitt „Sicherheit“ und im Advisory. Wer OpenGewerk betreibt, aktualisiert bitte bald.

Eine Sicherheitsfassung mit dem letzten Punkt aus der Sicherheitsprüfung der Handwerkersoftware vom Oktober 2026: Eine neue E-Mail-Adresse gilt erst, wenn der Link in einer Mail an sie geöffnet ist (#754). Damit ist jeder Befund und jeder Hinweis dieser Prüfung behoben.

Ohne Mailserver der Instanz ändert sich ab dieser Fassung keine E-Mail-Adresse mehr, der Name schon; wer Adressen ändern will, richtet im Bereich der Instanz einen Mailserver ein. Jede Adresse, die es beim Update schon gibt, gilt als bestätigt. Wer ein Konto zum Betreiber benennt oder über add-staff oder add-tenant an die Arbeit setzt, braucht dafür eine bestätigte Adresse.

Aktualisiert wird wie bei jeder Fassung, vorher gesichert. Eine Migration kommt dazu, 0095_address_confirmations.

Sicherheit

  • Eine neue E-Mail-Adresse gilt erst, wenn der Link in einer Mail an sie geöffnet ist (#754). Unter „Konto“ und als Berichtigung unter „Zugänge“ wartet sie, an sie geht ein Link, der einen Tag und einmal gilt, und bis dahin gilt die bisherige; „Mail erneut senden“ und „Verwerfen“ stehen daneben. Die Seite des Links bestätigt erst mit einem Knopf. Danach steht die Änderung im Änderungsprotokoll jedes Betriebs des Kontos, ein offener Link für ein neues Passwort endet, und die bisherige Adresse bekommt einen Hinweis. Ohne Mailserver der Instanz ändert sich keine Adresse, der Name schon. Wer die Instanz betreibt, ein Konto über add-staff oder add-tenant an die Arbeit setzt oder es per Link einlädt, findet es nur noch über eine bestätigte Adresse; eine Einladung per Mail bestätigt sie beim Einlösen. Die Migration 0095_address_confirmations bringt die Tabelle auth_address_confirmations und setzt jede Adresse, die es schon gibt, auf bestätigt (Moritz, 30.10.2026). Warum: Eine Adresse kam bisher ohne Nachweis an ein Konto, und spätere Vergaben fanden das Konto genau über sie; wer eine fremde Adresse eintrug, bekam so eine Benennung oder einen Zugang, der einer anderen Person galt (Befund N28 der Sicherheitsprüfung).

Behoben

  • „Faktor zurücksetzen“ steht auch in der Liste der Zugänge mit Dialogen (StaffDialogsScreen), die OpenGewerk Haustechnik nutzt, mit derselben Rückfrage wie in StaffScreen. Warum: #762 hatte den Knopf nur in StaffScreen eingebaut; in der Haustechnik setzte den zweiten Faktor eines Zugangs dann nur reset-second-factor auf dem Server zurück, obwohl die Route der Leitung offensteht.
  • Der Knopf „Faktor zurücksetzen“ heißt für Bildschirmleser „Faktor zurücksetzen für “, in beiden Listen der Zugänge. Warum: Sein Name war „Zweiten Faktor von zurücksetzen“ und enthielt den sichtbaren Text nicht; wer mit Sprache steuert, sagt, was er sieht, und traf ihn so nicht. Die Prüfung der Breiten in der Haustechnik (axe, label-content-name-mismatch) hat es gezeigt.

Installieren und aktualisieren

Das Paket opengewerk-0.6.4.tar.gz enthält den Ordner opengewerk/docker. Zum Installieren entpacken, mit tar --no-same-owner -xzf opengewerk-0.6.4.tar.gz, und im Ordner opengewerk sh docker/start.sh aufrufen. Für ein Update das neue Paket genauso an dieselbe Stelle entpacken, die .env bleibt, und derselbe Befehl. Gebaut wird dabei nichts, geholt werden die Abbilder dieser Fassung, für x86_64 und ARM64:

  • ghcr.io/opengewerk/opengewerk:0.6.4 (sha256:17a45e3a5d4f2c038d28a3528012ec72eb305e30971ba7c54baaebe4900b0e85)
  • ghcr.io/opengewerk/backup:0.6.4 (sha256:60d264a7cf9706b838838b2650b05656db06bfc2362ed98f27bc28b5ad19ba97)

Dieselben Abbilder liegen mit denselben Digests und Signaturen auch auf Docker Hub, als opengewerk/opengewerk:0.6.4 und opengewerk/backup:0.6.4. Das Paket holt sie trotzdem aus ghcr.io, denn Docker Hub begrenzt anonyme Pulls.

Gebraucht werden Docker und Docker Compose ab 2.22. Beide Abbilder sind ohne Schlüssel über Sigstore signiert. Prüfen:

cosign verify ghcr.io/opengewerk/opengewerk:0.6.4 \
  --certificate-identity https://github.com/opengewerk/opengewerk/.github/workflows/release.yml@refs/tags/v0.6.4 \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

Das Paket ist im selben Lauf genauso signiert. Vor dem Entpacken prüfen, mit opengewerk-0.6.4.tar.gz.sigstore.json daneben:

cosign verify-blob opengewerk-0.6.4.tar.gz \
  --bundle opengewerk-0.6.4.tar.gz.sigstore.json \
  --certificate-identity https://github.com/opengewerk/opengewerk/.github/workflows/release.yml@refs/tags/v0.6.4 \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com