Java-Schwachstelle CVE-2026-114938 („Java4Shell“): Prüfung und Absicherung für On-Premises-Installationen

Am 17.11.2026 wurde eine Schwachstelle im Base64-Decoder von Java veröffentlicht. Betroffen sind Java 17.0.6 und neuer, 21 und 25. Ausnutzbar ist sie nur auf x86-64-Prozessoren mit der Befehlssatzerweiterung AVX-512 VBMI (z. B. Intel Xeon ab „Ice Lake“, AMD ab „Zen 4“). ARM-Systeme sind nicht betroffen. Bei virtuellen Maschinen zählt der Prozessor, den der Hypervisor an die VM weitergibt.

Diese Anleitung gilt für Installationen, die Sie selbst betreiben. Jeder Abschnitt steht für sich: Lesen Sie nur die Abschnitte der FTAPI-Produkte, die Sie einsetzen. Die FTAPI Cloud und die von FTAPI betriebenen IEE-Gateways sind nach unserer Prüfung nicht ausnutzbar; dort ist nichts zu tun.

Die Maßnahme ist eine Übergangslösung: Sie schaltet die hardwarebeschleunigte Base64-Verarbeitung ab. Funktion und Verhalten der Anwendung ändern sich dadurch nicht. Sobald korrigierte Versionen verfügbar sind, informieren wir Sie; danach entfernen Sie die Maßnahme wieder.

Ist ein Server betroffen?

Die Prüfung ist für alle Produkte gleich: Entscheidend ist, ob der Prozessor des Servers AVX-512 VBMI bereitstellt. Prüfen Sie jeden Server, bei Clustern jeden Knoten.

Linux (Shell):

uname -m
grep -cw avx512vbmi /proc/cpuinfo

Betroffen, wenn die erste Zeile x86_64 lautet und die zweite größer als 0 ist.

Windows (PowerShell), mit einer Java-Laufzeit auf dem Server, z. B. der von SecuTransfer mitgelieferten:

& "<Installationsverzeichnis>\ftapi-server\jre\windows\bin\java.exe" -Xlog:os+cpu -version 2>&1 | Select-String 'avx512_vbmi(?!2)'

Betroffen, wenn eine Zeile ausgegeben wird. Keine Ausgabe: nicht betroffen.

Hinweis: Die Java-Einstellung UseBASE64Intrinsics (z. B. aus java -XX:+PrintFlagsFinal -version) steht auf fast allen Servern auf true und bedeutet allein nicht, dass ein Server betroffen ist. Entscheidend ist AVX-512 VBMI.

SecuTransfer

Die Maßnahme setzt die Umgebungsvariable JAVA_TOOL_OPTIONS für den SecuTransfer-Dienst. Der Dienst muss dafür einmal neu gestartet werden; SecuTransfer ist währenddessen kurz nicht erreichbar. Gilt ab Version 4.48.

Linux (systemd)

  1. Als root die Zusatzdatei anlegen und den Dienst neu starten (Shell):
mkdir -p /etc/systemd/system/ftapi.service.d
cat > /etc/systemd/system/ftapi.service.d/cve-2026-114938.conf <<'EOF'
[Service]
Environment="JAVA_TOOL_OPTIONS=-XX:-UseBASE64Intrinsics"
EOF
systemctl daemon-reload
systemctl restart ftapi
  1. Prüfen, ob die Maßnahme aktiv ist (Shell). Erwartete Ausgabe: Picked up JAVA_TOOL_OPTIONS: -XX:-UseBASE64Intrinsics
journalctl -u ftapi --since "10 minutes ago" --no-pager | grep "Picked up JAVA_TOOL_OPTIONS"

Die Datei liegt außerhalb des Installationsverzeichnisses und bleibt bei SecuTransfer-Updates erhalten.

Entfernen nach dem Update auf eine korrigierte Version (Shell, als root):

rm /etc/systemd/system/ftapi.service.d/cve-2026-114938.conf
systemctl daemon-reload
systemctl restart ftapi

Windows (Dienst „FTAPI Server“)

  1. Sichern Sie die Datei <Installationsverzeichnis>\ftapi-server\ftapi-server.xml.
  2. Fügen Sie in dieser Datei unterhalb der vorhandenen <env ... />-Zeilen ein (XML):
<env name="JAVA_TOOL_OPTIONS" value="-XX:-UseBASE64Intrinsics"/>
  1. Starten Sie den Dienst neu (PowerShell als Administrator):
Restart-Service -Name FTAPI
  1. Prüfen Sie, ob die Maßnahme aktiv ist (PowerShell). Erwartete Ausgabe: eine Zeile mit Picked up JAVA_TOOL_OPTIONS: -XX:-UseBASE64Intrinsics
Select-String -Path "<Installationsverzeichnis>\ftapi-server\service-logs\ftapi-server.err.log" -Pattern "Picked up JAVA_TOOL_OPTIONS"

Wichtig: Ein SecuTransfer-Update, das den Ordner ftapi-server ersetzt, setzt ftapi-server.xml zurück. Prüfen Sie nach jedem Update, ob die Zeile noch vorhanden ist, bis Sie eine Version mit korrigierter Java-Laufzeit installiert haben.

Entfernen nach dem Update auf eine korrigierte Version: die <env name="JAVA_TOOL_OPTIONS" .../>-Zeile löschen und den Dienst neu starten.

Docker

  1. Setzen Sie am SecuTransfer-Container die Umgebungsvariable JAVA_EXTRA_OPTS=-XX:-UseBASE64Intrinsics (z. B. in Ihrer Compose- oder Env-Datei) und erzeugen Sie den Container neu.
  2. Prüfen Sie, ob die Maßnahme aktiv ist (Shell auf dem Docker-Host). Erwartete Ausgabe: -XX:-UseBASE64Intrinsics
docker top <Container> | grep -o -- -XX:-UseBASE64Intrinsics

Entfernen nach dem Update auf eine korrigierte Version: JAVA_EXTRA_OPTS wieder entfernen und den Container neu erzeugen.

Versionen vor 4.48 verwenden einen anderen Startmechanismus. Bitte wenden Sie sich an unseren Support.

IEE-Gateway (CipherMail)

Die Maßnahme folgt dem Hinweis von CipherMail. Sie legt für jeden CipherMail-Backend-Dienst eine systemd-Zusatzdatei an; andere Java-Programme auf dem Gateway bleiben unverändert.

  1. Als root die Zusatzdateien anlegen (Shell):
for s in ciphermail-backend ciphermail-portal-backend ciphermail-company-portal-backend; do
systemctl cat "$s" >/dev/null 2>&1 || continue
mkdir -p /etc/systemd/system/$s.service.d
printf '[Service]\nEnvironment=JAVA_TOOL_OPTIONS=-XX:-UseBASE64Intrinsics\n' \
> /etc/systemd/system/$s.service.d/base64-intrinsics.conf
done
systemctl daemon-reload
  1. Die laufenden Dienste neu starten (Shell, als root). Dienste, die auf Ihrem Gateway gestoppt sind, bleiben gestoppt. E-Mails, die währenddessen eingehen, werden von Postfix zwischengespeichert und anschließend zugestellt. Bei einem Cluster einen Knoten nach dem anderen.
for s in ciphermail-backend ciphermail-portal-backend ciphermail-company-portal-backend; do
systemctl cat "$s" >/dev/null 2>&1 && systemctl try-restart "$s"
done
  1. Prüfen, ob die Maßnahme aktiv ist (Shell). Erwartete letzte Zeile: Picked up JAVA_TOOL_OPTIONS: -XX:-UseBASE64Intrinsics. Für die anderen neu gestarteten Dienste wiederholen.
journalctl -u ciphermail-backend -b | grep "Picked up JAVA_TOOL_OPTIONS"

Die Zusatzdatei bleibt erhalten, wenn das CipherMail-Playbook erneut ausgeführt wird.

Process Client

Bis ein ProcessClient-Release mit einer gepatchten Java-Laufzeitumgebung verfügbar ist, setzen Sie für den ProcessClient diese eine Umgebungsvariable:

JDK_JAVA_OPTIONS=-XX:-UseBASE64Intrinsics

Sie schaltet nur die fehlerhafte Hardwarebeschleunigung ab. Java verwendet dann seine reguläre Base64-Implementierung, und der ProcessClient arbeitet genau wie zuvor.

Ist der ProcessClient betroffen?

Ihr ProcessClient ist betroffen, wenn beides zutrifft:

  • Er läuft mit einer betroffenen Java-Version. Das gilt für alle aktuellen ProcessClient-Versionen. Die Service-Installation (Windows und Linux) bringt Java 21.0.12.1 mit, das Docker-Image ftapi/process-client verwendet Java 21.0.13. Betroffen sind Java 17.0.6 bis 17.0.21 und alle Java-21-Releases bis einschließlich 21.0.13.
  • Das System hat eine x86-64-CPU mit AVX-512 VBMI. Das sind Intel Xeon Ice Lake, Sapphire Rapids, Emerald Rapids und Granite Rapids sowie AMD EPYC/Ryzen ab Zen 4. ARM-Systeme sind nicht betroffen.

Ein einziger Java-Befehl zeigt die Java-Version und die CPU-Merkmale an. Führen Sie ihn mit der Java-Laufzeitumgebung aus, die der ProcessClient verwendet. Ersetzen Sie <PROCESSCLIENT> durch den Installationsordner und <CONTAINER> durch den Namen des Containers.

Linux-Service (Shell):

<PROCESSCLIENT>/jre/linux/bin/java -Xlog:os+cpu -version 2>&1 | grep -E 'version|CPU:'

Windows-Service (PowerShell):

& "<PROCESSCLIENT>\jre\windows\bin\java.exe" -Xlog:os+cpu -version 2>&1 | Select-String 'version|CPU:'

Docker (Shell auf dem Docker-Host):

docker exec <CONTAINER> java -Xlog:os+cpu -version 2>&1 | grep -E 'version|CPU:'

Sie sehen

Bedeutung

openjdk version "21.0.12.1" oder eine andere Version aus dem oben genannten Bereich

Die Java-Laufzeitumgebung ist betroffen.

avx512_vbmi in der Zeile mit CPU:

Der fehlerhafte Code wird auf diesem System verwendet: Wenden Sie die Sofortmaßnahme jetzt an.

Kein avx512_vbmi in der Zeile mit CPU:

Der fehlerhafte Code wird auf dieser Hardware derzeit nicht verwendet.

Linux-Service

  1. Öffnen Sie eine Override-Datei für den Service (Shell):
sudo systemctl edit FTAPIProcesses
  1. Fügen Sie im Editor diese Zeilen ein und speichern Sie:
[Service]
Environment="JDK_JAVA_OPTIONS=-XX:-UseBASE64Intrinsics"
  1. Starten Sie den Service neu (Shell):
sudo systemctl restart FTAPIProcesses

Die Einstellung wird in einer separaten Override-Datei unter /etc/systemd/system/FTAPIProcesses.service.d/ gespeichert. Die Service-Datei selbst bleibt unverändert, und die Einstellung bleibt auch bei Updates des ProcessClient erhalten.

Ohne Editor, zum Beispiel für ein automatisiertes Rollout (Shell):

sudo mkdir -p /etc/systemd/system/FTAPIProcesses.service.d
printf '[Service]\nEnvironment="JDK_JAVA_OPTIONS=-XX:-UseBASE64Intrinsics"\n' \
| sudo tee /etc/systemd/system/FTAPIProcesses.service.d/cve-2026-114938.conf
sudo systemctl daemon-reload
sudo systemctl restart FTAPIProcesses

Prüfung: Nach dem Neustart enthält das Service-Log eine Zeile, die bestätigt, dass Java die Einstellung übernommen hat (Shell):

sudo journalctl -u FTAPIProcesses --since "10 min ago" | grep "Picked up JDK_JAVA_OPTIONS"
# NOTE: Picked up JDK_JAVA_OPTIONS: -XX:-UseBASE64Intrinsics

Windows-Service

  1. Öffnen Sie <PROCESSCLIENT>\windows\ProcessClientWindowsService.xml in einem Texteditor, den Sie als Administrator gestartet haben.
  2. Fügen Sie diese Zeile direkt unter der Zeile <arguments>…</arguments> ein. Lassen Sie die Zeile <arguments> selbst unverändert (XML):
<env name="JDK_JAVA_OPTIONS" value="-XX:-UseBASE64Intrinsics"/>
  1. Starten Sie den Service neu, entweder in PowerShell als Administrator oder über die Dienste-Konsole (services.msc):
Restart-Service FTAPIProcesses

Prüfung: Nach dem Neustart enthält das Service-Log eine Zeile, die bestätigt, dass Java die Einstellung übernommen hat (PowerShell):

Select-String -Path "<PROCESSCLIENT>\log\*.log" -Pattern "Picked up JDK_JAVA_OPTIONS"
# ... NOTE: Picked up JDK_JAVA_OPTIONS: -XX:-UseBASE64Intrinsics

Hinweis zu Updates: Ein ProcessClient-Update ersetzt den gesamten Installationsordner, einschließlich dieser XML-Datei, und die Einstellung geht verloren. Bringt die neue Version noch eine betroffene Java-Laufzeitumgebung mit (Prüfung wie oben), fügen Sie die Zeile erneut ein.

Docker

Setzen Sie die Variable in der Container-Definition und erstellen Sie den Container anschließend neu. Ein Neustart des Containers reicht nicht aus, da Umgebungsvariablen beim Erstellen des Containers festgelegt werden.

docker compose: Fügen Sie die Variable beim ProcessClient-Service hinzu (YAML):

services:
processclient:
image: ftapi/process-client:latest
environment:
- JDK_JAVA_OPTIONS=-XX:-UseBASE64Intrinsics
# ... Ihre bestehenden Einstellungen

Erstellen Sie den Container danach im Ordner mit der Compose-Datei neu (Shell):

docker compose up -d

docker run: Ergänzen Sie Ihren Befehl um -e JDK_JAVA_OPTIONS=-XX:-UseBASE64Intrinsics. Entfernen Sie dann den alten Container und starten Sie einen neuen (Shell):

docker stop <CONTAINER> && docker rm <CONTAINER>
docker run -d --name <CONTAINER> -e JDK_JAVA_OPTIONS=-XX:-UseBASE64Intrinsics <Ihre weiteren Optionen> ftapi/process-client:latest

Kubernetes: Fügen Sie die Variable in der Container-Spezifikation hinzu (env: mit name: JDK_JAVA_OPTIONS, value: "-XX:-UseBASE64Intrinsics") und rollen Sie das Deployment neu aus.

Prüfung (Shell):

docker exec <CONTAINER> java -XX:+PrintFlagsFinal -version 2>/dev/null | grep UseBASE64Intrinsics
# bool UseBASE64Intrinsics = false {product} {command line}

= false bedeutet, dass die Sofortmaßnahme aktiv ist. Endet die Zeile auf = true ... {default}, ist die Variable im Container nicht gesetzt.

Falls JDK_JAVA_OPTIONS bereits gesetzt ist

Möglicherweise setzt Ihre Umgebung JDK_JAVA_OPTIONS bereits, etwa in einer bestehenden systemd-Override-Datei, in einer <env>-Zeile der Windows-XML oder in der Container-Definition. Legen Sie dann keinen zweiten Eintrag an. Ergänzen Sie die Option stattdessen im bestehenden Wert, durch ein Leerzeichen getrennt:

JDK_JAVA_OPTIONS=-Xmx2g -XX:-UseBASE64Intrinsics

Nach dem Update auf ein gepatchtes Release

Sobald ein ProcessClient-Release mit einer gepatchten Java-Laufzeitumgebung verfügbar ist, aktualisieren Sie wie in der Update-Anleitung beschrieben. Bei einer Service-Installation ersetzen Sie dabei den gesamten Installationsordner, einschließlich jre/. Bei Docker laden Sie das neue Image und erstellen den Container neu.

Danach wird die Sofortmaßnahme nicht mehr benötigt. Es schadet nicht, sie beizubehalten. So entfernen Sie sie:

  • Linux: Führen Sie sudo systemctl edit FTAPIProcesses aus und löschen Sie die beiden Zeilen, oder löschen Sie die Datei cve-2026-114938.conf und führen Sie sudo systemctl daemon-reload aus. Starten Sie den Service anschließend neu.
  • Windows: Löschen Sie die Zeile <env name="JDK_JAVA_OPTIONS" …/> und starten Sie den Service neu. Nach einem vollständigen Update ist sie mit der alten XML-Datei bereits entfernt.
  • Docker: Entfernen Sie die Variable aus der Container-Definition und erstellen Sie den Container neu.