Wolkenwald
wowa-edge

Protokolle und Zertifikate

wowa-edge spricht HTTP/1.1, HTTP/2 und HTTP/3 auf denselben Ports und beschafft seine Zertifikate selbst. Die Protokolle sind eigene Implementierungen: HTTP/2 mit HPACK, HTTP/3 mit QPACK und QUIC nach RFC 9000, 9001 und 9002. OpenSSL 3.5 liefert die Kryptografie und den TLS-Handshake.

HTTP-Fassungen

  • HTTP/1.1 und HTTP/1.0.
  • HTTP/2 über TLS, ausgehandelt per ALPN. Im Klartext als h2c, sowohl direkt als auch über den Upgrade aus HTTP/1.1.
  • HTTP/3 über QUIC auf UDP, auf demselben Port wie HTTPS. Browser erfahren davon über Alt-Svc.
Listen 443 ssl
Listen 443 quic
Protocols h3 h2 http/1.1

<VirtualHost *:443>
    ServerName alt.example.org
    Protocols  http/1.1
</VirtualHost>

Protocols gilt server-global und je VirtualHost. Ohne h3 wird HTTP/3 für den Host nicht beworben, ohne h2 handelt er kein HTTP/2 aus.

WebSocket über HTTP/2 und HTTP/3

WebSocket läuft auch über HTTP/2 (RFC 8441) und HTTP/3 (RFC 9220). Der Tunnel belegt dann einen einzelnen Strom, die übrigen Anfragen derselben Verbindung laufen weiter. Zum Backend übersetzt wowa-edge auf klassisches ws:// oder wss:// über HTTP/1.1. H2WebSockets und H3WebSockets sind eingeschaltet und lassen sich einzeln abschalten.

QUIC

Die QUIC-Implementierung bringt Verlusterkennung, Flusssteuerung, Wechsel der Verbindungskennungen, Pfadprüfung und Schlüsselwechsel mit. Gesendet wird gebündelt über GSO, empfangen über GRO, mit ECN. Als Staukontrolle dient New Reno; Pacing und BBR lassen sich für Vergleichsmessungen über Umgebungsvariablen zuschalten.

Voraussetzung auf dem Host: grössere UDP-Puffer. Die Kernel-Vorgabe kappt die angeforderten Puffer still, und parallele HTTP/3-Verbindungen bremsen sich dann gegenseitig aus. wowa-edge meldet die Kappung beim Start.

# /etc/sysctl.d/90-wowa-quic.conf
net.core.rmem_max = 16777216
net.core.wmem_max = 16777216

TLS

TLS 1.2 und 1.3 über OpenSSL 3.5. Jeder VirtualHost hat sein eigenes Zertifikat, gewählt über SNI. SSLProtocol setzt die Mindestfassung je VirtualHost, SSLCipherSuite die TLS-1.2-Liste je VirtualHost. Die TLS-1.3-Suiten gelten server-weit.

Für HTTP/3 braucht es zur Laufzeit OpenSSL 3.5.3 oder neuer. Die Pakete bringen dafür ein eigenes OpenSSL 3.5 LTS mit, das nur der Dienst lädt.

Zertifikate

Je VirtualHost gilt genau eine Quelle:

  • ACMEAutoCert on: Let’s Encrypt über HTTP-01. Ausstellung und Erneuerung laufen im Dienst, das neue Zertifikat wird ohne Neustart geladen. ACMEStaging on nimmt die Testumgebung.
  • SSLInternalSigned on: signiert von einer eigenen internen Root-CA. Die CA kann der Dienst selbst anlegen (SSLInternalCAAutoCreate), ihr Stammzertifikat lässt sich für die Verteilung an Clients exportieren (SSLInternalCAExport).
  • SSLSelfSigned on: selbstsigniert, mit den ServerAlias-Namen als SAN.
  • Dateien: SSLCertificateFile mit der Kette und SSLCertificateKeyFile.
ACMEContactEmail  admin@example.org
ACMEStorageDir    /etc/wowa-edge/certs

SSLInternalCAFile        /etc/wowa-edge/ca/ca.crt
SSLInternalCAKeyFile     /etc/wowa-edge/ca/ca.key
SSLInternalCAAutoCreate  on

<VirtualHost *:443>
    ServerName    www.example.org
    ACMEAutoCert  on
</VirtualHost>

<VirtualHost *:443>
    ServerName         intranet.example.org
    SSLInternalSigned  on
</VirtualHost>

Beim Neuladen und im Erneuerungslauf zählt die Gültigkeit eines Zertifikats, nicht nur seine Lesbarkeit: ein abgelaufenes Zertifikat wird neu beschafft.

Zertifikate zwischen Knoten abgleichen

Ein Knoten, dessen Namen öffentlich auf einen anderen Knoten zeigen, erreicht keine ACME-Prüfung. Für diesen Fall holt er die Zertifikate über einen eigenen, gegenseitig per mTLS geprüften Zugang von dem Knoten, der sie beschaffen kann. Übertragen wird nur, was beide Seiten ausdrücklich benennen, und nur ein Zertifikat, das später abläuft als das vorhandene. Die Einzelheiten stehen unter Betrieb.

OCSP-Stapling

SSLUseStapling on

Mehr braucht es nicht. wowa-edge holt die OCSP-Antwort beim Responder aus dem Zertifikat, prüft ihre Signatur gegen den Aussteller, den Status und das Gültigkeitsfenster und erneuert sie im Hintergrund. Gestapelt wird je Zertifikat: bei mehreren SNI-Zertifikaten bekommt jedes seine eigene Antwort. Schlägt der Abruf fehl, läuft der Handshake ohne Stapling weiter.

SSLCertificateFile muss dafür die Kette enthalten. Alternativ stapelt SSLStaplingFile eine vorab geholte Antwort. Die Fristen steuern SSLStaplingResponderTimeout, SSLStaplingStandardCacheTimeout und SSLStaplingErrorCacheTimeout.

Client-Zertifikate

SSLVerifyClient none|optional|require mit SSLCACertificateFile verlangt Client-Zertifikate, server-global oder je VirtualHost. Wie wowa-edge sich ausserdem selbst gegenüber Backends ausweist, steht unter Sicherheit.

Zurück zur Übersicht wowa-edge. Davor: Konfiguration, danach: Reverse-Proxy und Lastverteilung.

Kontakt

Fragen zu Protokolle und Zertifikate?

Wir zeigen es Ihnen gern oder beraten Sie zu Lizenz, Hosting und Betrieb.