Repository navigation
·
10 commits
to main
since this release
Immutable
release. Only release title and notes can be modified.
This release has three themes: security fixes, hardened email authentication, and better Nix support. If you use the email channel, read Potentially Breaking Changes before updating. The new email checks are on by default and may reject mail your current setup accepts.
Highlights
Security fixes
- A task could plant a symlink in
/inbox, and the gateway would write the next attachment through it, anywhere on the host the gateway user can write. Attachments are now never written through a link. (#681) Authentication-Resultsis now parsed per RFC 8601. Before, admarc=passinside a sender-controlled quoted value was accepted even when the server's DMARC result wasfail. (#686)- A From header with several addresses was accepted as the one in angle brackets, and replies went to all of them. They now go only to the authenticated address. (#686)
- The proxy logged presigned AWS URLs after re-signing them. These carry the real credentials and a valid signature, and reached the network log, the dashboard and syslog. (#698)
- Container environment values, including secrets, are no longer passed on podman's command line. There, any local user could read them through
/proc, and journald recorded them. (#699) - Prompts, email subjects and raw container output are no longer logged. Redaction now also covers exceptions, tracebacks and
airut-sandbox. (#698)
Email hardening
- A valid DKIM signature by the From domain is now required, set with
email.auth.dkim_verification(defaultboth). (#688) - When Airut verifies the signature itself, it acts only on the header fields the signature covers. (#691)
- A message must name the channel in To or Cc, set with
email.auth.require_channel_recipient(defaulttrue). (#692) - A From header must be a single, plainly written mailbox, and it is size-limited before parsing, so a crafted From can't stall the worker pool. (#686, #687)
- Header sections that parsers can read differently are rejected: lines that aren't header fields, bare CRs, and repeated fields that may appear only once. (#689, #690)
Better Nix support
- New guide to building a repo's container image from its Nix flake:
doc/nix-images.md. (#670) - The proxy CA is now trusted on images without
update-ca-certificates, including throughNIX_SSL_CERT_FILEandGIT_SSL_CAINFO. (#662) - An image can ship an environment hook at
/etc/airut/env.sh(Nix devShell, conda, mise). It is loaded before each command. (#664) - The image build context can now include subdirectories, and symlinks to files elsewhere in the repo, such as
flake.nix. (#665) - The config path comes from
--configor$AIRUT_CONFIG, and the state directory from$AIRUT_STATE_DIRor systemd'sStateDirectory=. (#672) - New
!file PATHconfig values for secrets delivered as files, plus tag-free spellings such as{"!env": "NAME"}for generated configs. (#674) - The dashboard config editor is read-only when the config is a symlink, isn't writable, or
--read-only-configis set. (#673) - Installs in the Nix store are detected, and
airut updateandinstall-servicedefer to the Nix configuration. (#675) airut check --offlinevalidates a config inside a Nix build, andcheckwarns about secrets in the Nix store. (#677)
Potentially Breaking Changes
Email authentication. Mail that fails the new checks is rejected as auth_failed with no reply, and the log names the failing check. After updating, adjust the config for each case that applies:
- Microsoft 365: set
email.auth.dkim_verification: server. Exchange often changes messages after they are signed, which breaks Airut's own verification. - Senders whose domain doesn't sign its own mail with DKIM (for example, Google Workspace signing as
gappssmtp.com): set up DKIM for the domain, or setdkim_verification: none. Domains that sign only with Ed25519 needserver. - Senders who don't name the channel in To or Cc (Bcc, alias, group address, forwarding), or whose provider doesn't sign
To(Microsoft 365, Outlook.com) underboth/airut: setemail.auth.require_channel_recipient: false. - Some From and DMARC formats are now rejected: a From with a comment after a bare address (
user@example.com (Name)),<or>in the display name, or a server DMARC result with no matchingheader.from. Common clients and servers (Gmail, Outlook/Exchange, Apple Mail, Thunderbird) are unaffected. - DNS: with
bothorairut, Airut looks up DKIM keys through the host's resolver. Make sure an attacker can't answer for it. See DNS for DKIM Keys.
Other:
- If a
secretsor credential name is a variable podman itself reads (such asPATH,HOME,LD_PRELOADorXDG_*), it now also changes how the host-side podman runs. Rename any such entry. (#699) airutsubcommands now reject unknown arguments (exit 2), and.envis read from the selected config file's directory. (#672)- Library API:
Sandbox.ensure_image()now takes the repoImageBuildSpec. (#665)
Other Changes
- When the gateway stops or restarts, running tasks now get the
execution.shutdown_timeoutgrace period instead of being killed at once. (#671) - The email listener keeps retrying lost connections instead of giving up after 5 attempts, and backs off repeated IMAP IDLE errors. (#694, #695)
- The dashboard shows a repo as degraded while one of its listeners is disconnected. (#694)
- If one of a repo's listeners fails to start, its other listeners are now stopped instead of left running untracked. (#696)
- Email replies over the size limit now go out without the attachments that don't fit, instead of not at all. The limit is set with the new
smtp.max_message_size_mb(default 25). (#679) - Files that couldn't be delivered are moved to
/storage/undelivered/, and the agent is told on its next turn. (#680) - Fixed a stray
/opt/claude/claudeline at the start of every prompt. (#669) - The proxy now streams responses instead of buffering them, which cuts memory use and delivers server-sent events as they arrive. (#663)
- The dashboard, scheduler and config watcher no longer keep running when the gateway is stopped during boot. (#684)
- The GraphQL filter now explicitly blocks operations with no fields, which graphql-core 3.3.2 now parses. (#700)
- Dependencies: mitmproxy 12.3.1 in the proxy container (rebuilt automatically), slack-sdk 3.46.0, and dkimpy and dnspython added, plus routine bumps. (#676, #685, #688, #700)
- CI-only: the suite's CPU cost is roughly halved, and tests no longer fail when run in a different order. (#668, #683, #684)
Upgrade
airut update
Then make any config changes listed under Potentially Breaking Changes above.
If airut check reports a pending config schema migration after updating, run airut migrate.