Plugin: PSK nicht mehr world-readable #31

Merged
jochen merged 3 commits from fix/psk-permissions into master 2026-11-11 08:57:35 +00:00
Collaborator

Problem

Der Status-Tab meldet auth_psk_file is world-readable für /usr/local/etc/mdns-bridge.psk, und das stimmt: Die Template-Engine von OPNsense schreibt jede gerenderte Datei mit 0644. In +TARGETS lassen sich keine Rechte angeben.

setup.sh hat die Datei danach auf 0640 root:mdnsbridge gesetzt, aber nur beim Start bzw. bei Apply. Templates werden aber auch ohne Start neu gerendert, z. B.:

  • template reload im post-install bei jedem Paket-Upgrade,
  • Apply mit deaktiviertem Dienst.

Danach war der Schlüssel für alle lokalen Benutzer lesbar, bis zum nächsten Start.

Änderung

  • Der PSK wird jetzt nach /usr/local/etc/mdns-bridge/psk gerendert. Das Verzeichnis hat 0750 root:mdnsbridge: Auch eine 0644-Datei darin können nur root und der Daemon lesen, egal wann gerendert wird.
  • Das Verzeichnis legt das post-install an, bevor die Templates gerendert werden. setup.sh hält es bei jedem Start/Apply aktuell.
  • Das post-install löscht die alte Datei /usr/local/etc/mdns-bridge.psk.
  • build-plugin.sh unterstützt jetzt ein optionales +POST_INSTALL.pre, wie bei opnsense/plugins.
  • Daemon-Prüfung: Eine Schlüsseldatei gilt nur dann als world-readable, wenn auch alle Verzeichnisse auf dem Weg für „others“ betretbar sind. Unit-Test dazu.
  • Doku: opnsense/README.md.

Tests

  • cargo fmt/clippy/test (43 Tests).
  • render_templates.py: alle Szenarien ok.
  • Mit einem pkg-Stub erzeugtes Manifest: das post-install ist syntaktisch ok, das Snippet steht vor template reload.

Auf der Box nach dem Upgrade prüfen:

  • ls -ld /usr/local/etc/mdns-bridge /usr/local/etc/mdns-bridge/psk soll drwxr-x--- root mdnsbridge zeigen.
  • /usr/local/etc/mdns-bridge.psk ist weg.
  • Der Status-Tab zeigt keine Warnung mehr.
  • Die Peers sind weiterhin authenticated=true (nach Apply bzw. Neustart).

🤖 Generated with Claude Code

https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp

## Problem Der Status-Tab meldet `auth_psk_file is world-readable` für `/usr/local/etc/mdns-bridge.psk`, und das stimmt: Die Template-Engine von OPNsense schreibt jede gerenderte Datei mit 0644. In `+TARGETS` lassen sich keine Rechte angeben. `setup.sh` hat die Datei danach auf 0640 root:mdnsbridge gesetzt, aber nur beim Start bzw. bei Apply. Templates werden aber auch ohne Start neu gerendert, z. B.: - `template reload` im post-install bei jedem Paket-Upgrade, - Apply mit deaktiviertem Dienst. Danach war der Schlüssel für alle lokalen Benutzer lesbar, bis zum nächsten Start. ## Änderung - Der PSK wird jetzt nach `/usr/local/etc/mdns-bridge/psk` gerendert. Das Verzeichnis hat 0750 root:mdnsbridge: Auch eine 0644-Datei darin können nur root und der Daemon lesen, egal wann gerendert wird. - Das Verzeichnis legt das post-install an, bevor die Templates gerendert werden. `setup.sh` hält es bei jedem Start/Apply aktuell. - Das post-install löscht die alte Datei `/usr/local/etc/mdns-bridge.psk`. - `build-plugin.sh` unterstützt jetzt ein optionales `+POST_INSTALL.pre`, wie bei opnsense/plugins. - Daemon-Prüfung: Eine Schlüsseldatei gilt nur dann als world-readable, wenn auch alle Verzeichnisse auf dem Weg für „others“ betretbar sind. Unit-Test dazu. - Doku: opnsense/README.md. ## Tests - cargo fmt/clippy/test (43 Tests). - render_templates.py: alle Szenarien ok. - Mit einem pkg-Stub erzeugtes Manifest: das post-install ist syntaktisch ok, das Snippet steht vor `template reload`. Auf der Box nach dem Upgrade prüfen: - `ls -ld /usr/local/etc/mdns-bridge /usr/local/etc/mdns-bridge/psk` soll `drwxr-x--- root mdnsbridge` zeigen. - `/usr/local/etc/mdns-bridge.psk` ist weg. - Der Status-Tab zeigt keine Warnung mehr. - Die Peers sind weiterhin `authenticated=true` (nach Apply bzw. Neustart). 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
Plugin: PSK in a directory only root and the daemon can enter
Some checks failed
ci / rust (push) Has been cancelled
582e7a5da7
The template engine writes every rendered file 0644, on each template
reload - also on install/upgrade and with the service disabled, where
setup.sh (chmod 0640) does not run. The PSK at
/usr/local/etc/mdns-bridge.psk was therefore readable by every local
user, and --check-config in the Status tab warned about it.

- PSK target is now /usr/local/etc/mdns-bridge/psk; the directory is
  0750 root:mdnsbridge (created by post-install before the templates
  are rendered, kept by setup.sh).
- post-install removes the old /usr/local/etc/mdns-bridge.psk.
- build-plugin.sh: optional +POST_INSTALL.pre snippet, as in
  opnsense/plugins.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
build-plugin.sh: +POST_INSTALL.pre snippet; README: PSK location
Some checks failed
ci / rust (push) Has been cancelled
8ed6231d4b
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
config: a key file is only world-readable if others can reach it
All checks were successful
build-freebsd / freebsd (pull_request) Successful in 2m59s
build-freebsd / release (pull_request) Has been skipped
ci / rust (push) Successful in 3m34s
ci / rust (pull_request) Successful in 3m37s
2ba62eda80
The check looked at the file's mode only. A 0644 file in a 0750
directory is not readable by other users - which is how the plugin now
protects the PSK, since the template engine always writes 0644.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
jochen approved these changes 2026-11-11 08:57:19 +00:00
jochen merged commit 1f262538ae into master 2026-11-11 08:57:35 +00:00
jochen deleted branch fix/psk-permissions 2026-11-11 08:57:36 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
jochen/mdns-bridge!31
No description provided.