Skip to content

v0.58.0

Choose a tag to compare

@github-actions github-actions released this 05 Nov 20:23
· 94 commits to main since this release

Read this before upgrading

This release has two breaks. They arrive together so that you meet them once.

The module ABI is now 2.0

The module contract is renamed to Alcifra.ModuleAbi, and its major version moves to 2. A module built for the earlier ABI is refused at startup, and the log names the reason. Its data is untouched, and it stays inactive until a current build is installed.

  • Upgrade the core and its modules together. Neither an old core nor a new one can load the other's modules.
  • First builds for ABI 2.0: Messenger 0.10.0, Tube 0.4.0, Encryption 0.8.0, Licensing 0.8.1 and Flight School 0.4.0. The pins in modules.env and the chart already name them.
  • Licences: a module that is already active stays active. Activating one again with a licence issued for ABI 1 is refused, and needs a new licence.
  • Module authors: build against Alcifra.ModuleAbi 2.0.0. The SimplArchive.ModuleAbi package no longer receives versions, and its earlier versions stay downloadable.

The names from before the rename are gone

These were announced with v0.55.0 and have now been removed:

  • Sign-in: the earlier client ids (saconsole, sapass, simplarchive-desktop, simplarchive-mobile, simplarchive-mobile-autofill) and the phone's earlier redirect. Startup removes those clients and their tokens, so a session held under one ends at its next request.
  • Command line: the simplarchive.cli package and the SACONSOLE_*, SA_URL and SA_TOKEN variables. Install alcifra.cli, and use ALCIFRA_URL, ALCIFRA_TOKEN and ALCIFRA_CLIENT_SECRET.
  • Webhooks: the X-SimplArchive-Signature header. Receivers must read X-Alcifra-Signature.
  • Mail domains: a pending claim is checked only at _alcifra-challenge. A domain already verified stays verified.
  • Links and archives: simplarchive:// links no longer open. A .simplarchive archive is refused, so export it again as .alcifra.
  • Phone licences: one issued under the earlier kind no longer verifies against ABI 2.0, and needs issuing again.
  • Images and chart: only ghcr.io/hebelconsulting/alcifra (with -ocr and -postfix) and the alcifra chart are published from now on.

What's new

  • Bookmarks. One file per collection, in the bookmark format every browser reads. The browser extension keeps each file you can read in step as a folder of its own, merging changes bookmark by bookmark. A team shares one by putting it in a shared folder, and that folder's rights decide who gets it. Extension 0.2.0 asks for the bookmarks permission, so browsers ask to accept it again.
  • Enrolling your own key under possession. On a tenant that binds certificates by possession, a member enrols a certificate by opening a challenge sealed to it, on the desktop and with alcifra. The Demo tenant now binds this way. The phone follows in its next release.
  • White-label editions delivered by the Licensing module. A vendor publishes an edition with alcifra edition publish, and each customer pulls images and charts with their own credential and downloads the clients from a page behind it.
  • Tube's pages are now built from components, and a module's downloads are saved under the document's name.

Fixed

  • A throttled or failed answer to a session renewal, such as a 429 or a 502 during a restart, no longer signs people out or deletes a refresh token that still works.

Every change in this release

  • test(realtime): a second in-process host gives the static logger back (#2162)
  • fix(client): a version row carries its size
  • ci: unit and integration tests run in jobs of their own
  • fix(offline): an archived document advertises its mask
  • ci(edition): a white-label edition's image is amd64, built on the owner's Mac
  • docs(tube): ADR 0009, the pages are Razor components
  • fix(edition): a white-label edition keeps its name on any server
  • feat(modules): a module may claim v2 and downloads at the root
  • feat(cli): alcifra edition publish, and the workflow that runs it
  • fix(modules): a module's download link is saved under the document's name
  • feat(chart): a chart names where a customer pulls, and every own image uses the pull secret
  • feat(certificates): under possession a member enrols their own by opening a challenge
  • Bookmark files a browser keeps in step (#1946)
  • A renewal the server could not answer no longer ends the session
  • ABI 2.0: the rename to Alcifra.ModuleAbi, with no bridge (#2136)
  • Pin the first module builds for ABI 2.0 (#2136)
  • Retire the names before the rename (#2028)
  • Pin Licensing 0.8.1
  • Test: a login whose hourly last-use write is due still succeeds
  • The public README says what bookmarks do
  • The runbook says a new major's pins start a clock on the kiosk

Full Changelog: v0.57.6...v0.58.0