📖 ~4 min read • Source: FreeBSD VuXML
VuXML topic: OpenVPN — out-of-bounds write in legacy key-method 1
Related CVEs: CVE-2017-12166 CVE-2017-7478 CVE-2017-7479 CVE-2017-7508 CVE-2017-7512 CVE-2017-7520 CVE-2017-7521 CVE-2017-7522
Upstream summary: Steffan Karger reports: The bounds check in read_key() was performed after using the value, instead of before. If 'key-method 1' is used, this allowed an attacker to send a malformed packet to trigger a stack buffer overflow. […] Note that 'key-method 1' has been replaced by 'key method 2' as the default in OpenVPN 2.0 (released on 2005-04-17), and explicitly deprecated in 2.4 and marked for removal in 2.5. This should limit the amount of users impacted by this issue.
Table of contents
Symptom & Impact
On FreeBSD 15 hosts that have openvpn-polarssl installed, operators see behaviour consistent with the FreeBSD VuXML entry: pkg audit flags the installed version; any daemon, CLI tool, or application linked against openvpn-polarssl may misbehave or fail to start after upgrade; and — for security-rated advisories — the host is exposed to the vulnerabilities above. Impact ranges from a single restart cycle to full availability incidents on jails, bhyve guests, or downstream consumers that depend on openvpn-polarssl.
Environment & Reproduction
Reproduction targets FreeBSD 15. Confirm release, installed package, and capture baseline state:
freebsd-version -kru
uname -a
pkg info openvpn-polarssl
pkg query "%n-%v" openvpn-polarssl
pkg audit -F
service -e
Trigger the workflow that exposes openvpn-polarssl — multiple vulnerabilities (8 CVEs) — patch and remediation guide while collecting:
tail -200 /var/log/messages
dmesg -a | tail -200
tail -200 /var/log/pkg.log
Root Cause Analysis
Root cause is tracked at FreeBSD VuXML. The FreeBSD ports security team shipped a corrective openvpn-polarssl port revision; hosts on an outdated build remain exposed. Correlate package logs with system logs and kernel state to isolate the change that triggered the failure mode:
tail -500 /var/log/pkg.log
tail -500 /var/log/messages
sysctl kern.lastpid
sysctl kern.osreldate # numeric __FreeBSD_version, e.g. 1400097
Quick Triage
Run these checks on FreeBSD 15 to confirm the failure mode and current state of openvpn-polarssl:
pkg version -v openvpn-polarssl # installed vs available version
pkg audit openvpn-polarssl # advisory match for this package
tail -100 /var/log/messages
dmesg -a | tail -100
kldstat # kernel module state (for kernel/driver pkgs)
pfctl -sr 2>/dev/null || ipfw list # only if pf/ipfw is enabled
# If openvpn-polarssl ships an rc.d service (script name may differ from the pkg name,
# e.g. bind918→named, php83→php-fpm), check it:
service -e | grep -i openvpn-polarssl && service <rc-script-name> status
Step-by-Step Diagnosis
-
List enabled services (only relevant if the package provides one).
service -e -
Follow live logs.
tail -F /var/log/messages dmesg -
Validate firewall rules (skip if neither pf nor ipfw is enabled).
pfctl -sr -v 2>/dev/null || ipfw show -
Check package integrity for
openvpn-polarssl.pkg check -B openvpn-polarssl pkg check -d openvpn-polarssl # verify shared-library deps -
Reinstall
openvpn-polarsslif integrity check fails.pkg install -fy openvpn-polarssl -
Correlate findings with
/var/log/pkg.logand FreeBSD VuXML to pin the commit that introduced openvpn-polarssl — multiple vulnerabilities (8 CVEs) — patch and remediation guide.
Solution – Primary Fix
Install the corrective openvpn-polarssl port revision referenced by FreeBSD VuXML:
sudo pkg update
sudo pkg upgrade openvpn-polarssl # or: sudo pkg upgrade -y for the whole system
# If openvpn-polarssl provides an rc.d service, restart it (script name may differ from pkg name):
# sudo service <rc-script-name> restart
pkg audit openvpn-polarssl # confirm no remaining advisory for this package
For ports-tree builders (FreeBSD 13.x and earlier used portsnap; on FreeBSD 14+ the ports tree is fetched with Git):
# FreeBSD 14+ (portsnap was removed):
sudo pkg install -y git-lite
sudo git clone --depth 1 https://git.FreeBSD.org/ports.git /usr/ports
# FreeBSD 13.x and earlier:
# sudo portsnap fetch update
cd /usr/ports/<category>/openvpn-polarssl
sudo make deinstall reinstall clean
Reboot only if the package ships a kernel module or replaces a shared library used by long-running daemons.
Need help rolling this patch across a FreeBSD fleet? Our IT Solutions & Services team manages FreeBSD jail/bhyve patch windows. Get in touch for a free consultation.
Solution – Alternative Approaches
If the primary fix is not viable, choose from these alternatives:
-
Lock the package until the fix is vetted:
sudo pkg lock openvpn-polarssl -
Downgrade to a known-good revision.
pkg install pkgname-VERSIONis not a real downgrade syntax — fetch a specific build instead:# 1. Discover available versions across configured repos: pkg search -e openvpn-polarssl pkg rquery -r FreeBSD-quarterly '%n-%v' openvpn-polarssl # 2. Install from a specific saved .pkg file: sudo pkg add -f /path/to/openvpn-polarssl-<older-version>.pkg # 3. Or switch the host repo to the quarterly branch (see snippet below) and: sudo pkg upgrade -fr FreeBSD-quarterly openvpn-polarssl -
Switch the pkg repository between
quarterlyandlatestby editing/usr/local/etc/pkg/repos/FreeBSD.conf:FreeBSD: { url: "pkg+https://pkg.FreeBSD.org/${ABI}/quarterly", mirror_type: "srv", signature_type: "fingerprints", fingerprints: "/usr/share/keys/pkg", enabled: yes } -
Isolate the affected service in a jail with stricter firewall rules:
iocage create -n openvpn-polarssl-jail -r 15.0-CURRENT iocage set allow_raw_sockets=0 openvpn-polarssl-jail # or with Bastille: bastille create openvpn-polarssl-jail 15.0-CURRENT 10.0.0.10 -
Replace the service with a vendored static build for the period between exposure detection and full rollout.
Verification & Acceptance Criteria
All of these should pass after the fix:
pkg info openvpn-polarssl # shows the expected fixed version
pkg audit openvpn-polarssl # no advisory for this package (exit code 0)
tail -50 /var/log/messages # no new errors after upgrade
# If openvpn-polarssl ships a service, confirm it is running under its rc.d name:
# service <rc-script-name> status
The original reproduction for openvpn-polarssl — multiple vulnerabilities (8 CVEs) — patch and remediation guide must not trigger across two consecutive runs.
Rollback Plan
Capture state before any change (only ZFS root has boot environments — UFS hosts skip bectl):
pkg query "%n-%v" > /root/pkg-pre.txt
# ZFS-on-root only:
sudo bectl create pre-openvpn-polarssl-patch
To revert if the upgrade is bad, reinstall the previously saved .pkg file:
sudo pkg add -f /var/cache/pkg/openvpn-polarssl-<previous-version>.pkg
# Or activate the pre-patch boot environment and reboot (ZFS-on-root only):
sudo bectl activate pre-openvpn-polarssl-patch
sudo shutdown -r now
For kernel/loader changes on a UFS host, boot the previous kernel from the loader prompt (press 3 at the menu, then boot kernel.old).
Prevention & Hardening
Prevent recurrence on FreeBSD 15 hosts running openvpn-polarssl:
-
Enable the daily security pkg audit in
/etc/periodic.conf:daily_status_security_pkgaudit_enable="YES" -
Subscribe to
freebsd-security-notificationsat lists.freebsd.org. -
Mirror through a local pkg repository managed by
poudriere:poudriere jail -c -j 15amd64 -v 15.0-CURRENT poudriere ports -c -p default poudriere bulk -j 15amd64 -p default <category>/openvpn-polarssl -
Version-pin sensitive packages:
sudo pkg lock openvpn-polarssl -
Take an automatic ZFS boot-environment snapshot before every upgrade (ZFS root only):
sudo bectl create pre-upgrade-$(date +%Y%m%d) -
Monitor file integrity (create a baseline, verify against it later):
# Create a baseline (use -c; target /usr/local/etc, /etc, /boot — NOT /): sudo mtree -c -K sha256digest -p /usr/local/etc > /var/db/usr-local-etc.mtree sudo mtree -c -K sha256digest -p /etc > /var/db/etc.mtree # Verify later: sudo mtree -p /usr/local/etc < /var/db/usr-local-etc.mtree # Or with AIDE for a richer ruleset: sudo pkg install -y aide && sudo aide --init && sudo aide --check -
Harden jails with
allow.*tunables in/etc/jail.conf:openvpn-polarssl_jail { allow.raw_sockets = 0; allow.sysvipc = 0; allow.mount = 0; allow.chflags = 0; }
Related Errors & Cross-Refs
Issues that commonly surface alongside openvpn-polarssl — multiple vulnerabilities (8 CVEs) — patch and remediation guide: pkg lock contention, mismatched ABI after kernel/userland skew, pf rule drift, and stale shared-library references after upgrade. Triage with:
freebsd-version -kru
uname -K
pkg check -d
pfctl -sr
View all freebsd-15 tutorials on the Tutorials Hub →
Browse all common problems & solutions on the Tutorials Hub.
References & Further Reading
Primary reference: FreeBSD VuXML. Useful manual pages on FreeBSD 15:
man pkg
man freebsd-update
man pfctl
man ipfw
man bectl
man periodic.conf
Other resources: the FreeBSD Handbook, the FreeBSD Security Advisories at security.freebsd.org, and the /usr/ports/UPDATING file for port-specific notes implicated in openvpn-polarssl — multiple vulnerabilities (8 CVEs) — patch and remediation guide.