Cybersicherheit

TLS-Hostnamenprüfung in PHP - Verschlüsselung ist keine Endpunktidentität

TLS-Hostnamenprüfung in PHP - Verschlüsselung ist keine Endpunktidentität

Eine HTTPS-Anfrage kann verschlüsselt sein und trotzdem den falschen Endpunkt erreichen, wenn der Client nicht prüft, wer sich am anderen Ende der Verbindung befindet. Das klingt nur deshalb widersprüchlich, weil die Aussage „TLS ist aktiviert“ mehrere unterschiedliche Prüfungen in einem Satz zusammenfasst. Für eine PHP-Anwendung, die eine API aufruft, einen Feed herunterlädt oder einen Webhook sendet, lautet die entscheidende Frage nicht nur, ob die Verbindung verschlüsselt ist. Sie lautet: Welchen Server hat der Client authentifiziert?

Dieser Unterschied wird wichtig, wenn ein Zertifikatsfehler auftritt und es verlockend erscheint, die Überprüfung abzuschalten. Die Anfrage funktioniert dann vielleicht, doch der Fehler wurde nicht behoben; der Client hat lediglich aufgehört, eine wichtige Frage zu stellen. Dieser Artikel trennt die beteiligten Prüfungen, ordnet ihnen die Optionen von PHP cURL und Streams zu und zieht bewusst eine enge Schlussfolgerung. Eine gültige TLS-Verbindung authentifiziert eine Dienstidentität innerhalb eines konfigurierten Vertrauensmodells. Sie beweist nicht, dass der Dienst vertrauenswürdig, seine Anwendung sicher oder seine Antwort gefahrlos verwendbar ist.

Verschlüsselung, Zertifikatsvertrauen und Dienstidentität sind verschiedene Prüfungen

Korrekt konfiguriertes TLS kann Vertraulichkeit, Integrität und Serverauthentifizierung bereitstellen, wie das OWASP Transport Layer Security Cheat Sheet zusammenfasst. Diese Eigenschaften hängen von mehr ab als vom Aufbau eines verschlüsselten Kanals. Bei gewöhnlichem zertifikatsbasiertem HTTPS benötigt ein Client mindestens zwei zusammenhängende, aber unterschiedliche Antworten:

  1. Lässt sich dieses Zertifikat bis zu einem vom Client akzeptierten Vertrauensanker validieren? Das ist die Zertifizierungspfad- oder Peer-Überprüfung. Sie prüft die Signaturkette, Gültigkeitsbedingungen und das konfigurierte CA-Vertrauen des Clients.
  2. Identifiziert das Zertifikat den Dienst, den der Client erreichen wollte? Das ist die Überprüfung der Dienstidentität beziehungsweise des Hostnamens. Dabei wird eine erwartete Kennung mit einer im Serverzertifikat präsentierten Kennung verglichen.

Eine vertrauenswürdige Kette ohne passenden Namen genügt nicht. Ein Zertifikat für files.example.net sollte billing.example.com nicht allein deshalb authentifizieren, weil beide Ketten bei einer vertrauenswürdigen CA enden. Auch der umgekehrte Fall ist unvollständig: Ein passender Name im Zertifikat hilft nicht, wenn der Client keinen vertrauenswürdigen Zertifizierungspfad für dieses Zertifikat herstellen kann.

Der aktuelle RFC 9525 nennt die vom Client erwartete Identität reference identifier und eine vom Zertifikat übermittelte Identität presented identifier. Bei einer üblichen Anfrage an https://api.example.com/ liefert die URL normalerweise den erwarteten DNS-Namen api.example.com. Anschließend sucht der Client im Zertifikat nach einer zulässigen passenden Kennung.

Der Name in der URL ist Teil der Sicherheitsentscheidung

Für DNS-Namen legt RFC 9525 Kennungen in der Zertifikatserweiterung subjectAltName fest und schließt das frei formatierbare Feld Common Name zur Identifizierung eines Dienstes aus. Bei gewöhnlichen ASCII-DNS-Labels erfolgt der Vergleich ohne Beachtung der Groß- und Kleinschreibung. Ein Wildcard-Zeichen ist, sofern unterstützt, auf das vollständige äußerste linke Label beschränkt und entspricht nur einem Label. Daher kann *.example.com zu api.example.com passen, nicht jedoch zu v1.api.example.com.

Ein IP-Literal ist ein anderer Kennungstyp. Fordert der Code https://192.0.2.10/ an, ist diese IP-Adresse die erwartete Identität. RFC 9525 verlangt eine exakte Übereinstimmung mit einem iPAddress-Eintrag in subjectAltName. Ein Zertifikat, das nur den DNS-Namen api.example.com enthält, wird nicht allein deshalb passend, weil DNS diesen Namen momentan auf 192.0.2.10 abbildet.

Das ist ein Grund, warum das Ersetzen eines Hostnamens durch eine IP-Adresse als „DNS-Umgehung“ häufig einen Zertifikatsfehler erzeugt. Der Fehler kann korrekt sein: Der Client wollte eine IP-Adresse authentifizieren, die das Zertifikat nie beansprucht hat. Eine sinnvolle Lösung besteht darin, den beabsichtigten Hostnamen wiederherzustellen oder ein Zertifikat mit der notwendigen IP-Kennung auszustellen, wenn eine IP-basierte Identität tatsächlich erforderlich ist. Das Abschalten der Namensprüfung verändert die Vertrauensentscheidung, statt sie zu reparieren.

Was die beiden cURL-Optionen tatsächlich steuern

Die cURL-Erweiterung von PHP stellt die beiden wichtigsten Überprüfungsmechanismen von libcurl bereit. Wegen ihrer ähnlichen Namen werden sie leicht als ein einziger Schalter betrachtet, doch die libcurl-Dokumentation zur Peer-Überprüfung und die Dokumentation zur Host-Überprüfung beschreiben getrennte Aufgaben:

  • CURLOPT_SSL_VERIFYPEER prüft, ob das Peer-Zertifikat über das konfigurierte CA-Vertrauen authentifiziert werden kann. In libcurl ist diese Option standardmäßig aktiviert.
  • CURLOPT_SSL_VERIFYHOST prüft, ob die Identität des Zertifikats zum Hostnamen oder zur Adresse in der URL passt. Der strikte Wert und Standardwert von libcurl ist 2.

Moderner Code sollte beide Prüfungen aktiviert lassen. Die Richtlinie kann dort ausdrücklich festgehalten werden, wo ein gemeinsames Options-Array, ein Framework oder eine spätere Überarbeitung sie sonst verdecken könnte:

<?php
$url = 'https://api.example.com/v1/status';
$handle = curl_init($url);

if ($handle === false) {
    throw new RuntimeException('Unable to initialize cURL');
}

$optionsSet = curl_setopt_array($handle, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 5,
    CURLOPT_TIMEOUT => 15,
    CURLOPT_SSL_VERIFYPEER => true,
    CURLOPT_SSL_VERIFYHOST => 2,
]);

if (!$optionsSet) {
    throw new RuntimeException('Unable to configure cURL');
}

$body = curl_exec($handle);
if ($body === false) {
    throw new RuntimeException('HTTPS request failed: ' . curl_error($handle));
}

$status = curl_getinfo($handle, CURLINFO_RESPONSE_CODE);

Das Beispiel ist als API-Client bewusst unvollständig: Es entscheidet nicht, welche Statuscodes akzeptabel sind, validiert keinen Content-Type, begrenzt die Antwortgröße nicht und prüft kein Schema. Das sind separate Anwendungskontrollen. Die TLS-Einstellungen beantworten lediglich, ob cURL unter der aktuellen Vertrauenskonfiguration eine authentifizierte Verbindung herstellen kann.

Explizite Einstellungen sind nicht automatisch sicherer als Standardwerte. Ein Wrapper kann sie später überschreiben, und die tatsächlich verwendete CA-Quelle hängt davon ab, wie curl und sein TLS-Backend gebaut wurden. Der curl-Leitfaden zur Zertifikatsüberprüfung beschreibt plattformabhängiges Verhalten des CA-Speichers. Deshalb sollten die endgültigen Optionen und die Deployment-Umgebung geprüft werden, statt aus zwei Konstanten in einer Datei auf die Runtime-Richtlinie zu schließen.

PHP-Streams verwenden dasselbe zweiteilige Modell

Die Stream-Schicht von PHP verwendet andere Namen für dieselbe konzeptionelle Trennung. Laut der PHP-Dokumentation zu SSL-Kontextoptionen haben verify_peer und verify_peer_name beide den Standardwert true. Wenn peer_name nicht angegeben ist, leitet PHP den Namen aus dem Hostnamen ab, mit dem der Stream geöffnet wurde.

<?php
$context = stream_context_create([
    'http' => [
        'timeout' => 15,
        'ignore_errors' => true,
    ],
    'ssl' => [
        'verify_peer' => true,
        'verify_peer_name' => true,
    ],
]);

$body = file_get_contents(
    'https://api.example.com/v1/status',
    false,
    $context
);

if ($body === false) {
    throw new RuntimeException('HTTPS stream request failed');
}

Auch dieses Beispiel zeigt eine Verbindungsrichtlinie und keine vollständige HTTP-Abstraktion. Die Fehlerbehandlung bei Streams kann das Auswerten von Warnungen oder eine Bibliothek erfordern, die Fehler deutlicher bereitstellt. Entscheidend für die Prüfung ist, dass verify_peer_name beim Wechsel zwischen Entwicklungs- und Produktionsumgebung nicht unbemerkt auf false gesetzt wird.

Eine private CA ist eine Frage der Vertrauenskonfiguration und kein Grund, Prüfungen zu überspringen

Interne Dienste verwenden häufig Zertifikate, die öffentliche CA-Speicher nicht kennen. Das macht eine strikte Überprüfung nicht unmöglich. Der Client benötigt vielmehr einen geeigneten privaten Vertrauensanker. curl kann ein CA-Bundle über CURLOPT_CAINFO erhalten oder ein geeignetes CA-Verzeichnis über CURLOPT_CAPATH; PHP-Streams bieten cafile und capath.

curl_setopt_array($handle, [
    CURLOPT_SSL_VERIFYPEER => true,
    CURLOPT_SSL_VERIFYHOST => 2,
    CURLOPT_CAINFO => '/etc/ssl/local-ca.pem',
]);

Die Datei in diesem Beispiel ist eine Vertrauenseingabe. Daher sind ihre Herkunft, ihr Inhalt, ihre Eigentums- und Zugriffsrechte sowie der Aktualisierungsprozess relevant. Einfach das Zertifikat herunterzuladen, das ein Server gerade präsentiert, und ihm sofort zu vertrauen, würde den Unterschied zwischen Beobachtung und Vertrauen aufheben. Eine private CA sollte über einen kontrollierten Kanal verteilt werden, und das Leaf-Zertifikat benötigt weiterhin eine Kennung, die zum Dienstnamen passt.

Einem selbstsignierten Leaf-Zertifikat kann in einem streng kontrollierten System ausdrücklich vertraut werden. Das ist jedoch ein anderes Vertrauensmodell mit eigenen Kosten für Bereitstellung und Rotation. Die Bezeichnung „selbstsigniert“ macht ein Zertifikat weder automatisch akzeptabel, noch erklärt sie, wie Clients eine vertrauenswürdige Kopie erhalten haben. Für viele interne Dienste ist eine kleine private CA einfacher zu verwalten als das separate Pinning jedes Leaf-Zertifikats; die passende Entscheidung hängt jedoch vom jeweiligen System ab.

Weiterleitungen und alternative Verbindungsadressen erfordern eine sorgfältige Einordnung

Folgt ein Client einer Weiterleitung von einem Host zu einem anderen, muss die neue HTTPS-Verbindung den Host der neuen URL authentifizieren. Das Zertifikat des ursprünglichen Servers verbürgt sich nicht für ein unabhängiges Weiterleitungsziel. Eine Redirect-Richtlinie betrifft außerdem Fragen außerhalb von TLS, etwa ob Zugangsdaten weitergegeben werden und ob das Ziel zulässig ist. Hostnamenüberprüfung ist notwendig, aber keine Allowlist.

Einige Clients können sich mit einer Netzwerkadresse verbinden und dabei einen anderen URL-Hostnamen beibehalten. Das kann für Tests, Service Discovery oder eine von DNS unabhängige Weiterleitung nützlich sein. Die sicherheitsrelevante Referenzidentität sollte dabei weiterhin der beabsichtigte Dienstname bleiben. Server Name Indication (SNI) kann einem mandantenfähigen Server helfen, das richtige Zertifikat auszuwählen; SNI überprüft dieses Zertifikat jedoch nicht selbst. Das genaue Verhalten unterscheidet sich je nach Client und TLS-Backend. Deshalb sollten dokumentierte Funktionen zum Überschreiben der Verbindung verwendet werden, statt die URL beiläufig umzuschreiben.

Ein Fehler ist Information und kein Hindernis, das unterdrückt werden sollte

RFC 9525 sagt, dass eine automatisierte Anwendung den Versuch mit einem Bad-Certificate-Fehler beenden und den Fehler protokollieren sollte, wenn keine präsentierte Kennung zu ihren Referenzkennungen passt. Die Formulierung lässt Raum für ausdrückliche Konfiguration, doch diese Sicherheitskontrolle darf nicht standardmäßig deaktiviert sein. Daraus ergibt sich ein nützliches Betriebsprinzip: Ein Fehler ist ein Hinweis, der untersucht werden sollte.

Eine praktische Untersuchung kann folgende Fragen stellen:

  • Welcher genaue Hostname oder welche IP-Adresse steht in der endgültigen URL?
  • Welche DNS-ID oder IP-ID präsentiert das Leaf-Zertifikat?
  • Welchen CA-Speicher verwendet genau dieser PHP/curl-Build?
  • Sendet der Server die erforderlichen Zwischenzertifikate?
  • Hat ein Proxy, Redirect, Container-Image oder eine umgebungsspezifische Option den Pfad verändert?
  • Überschreibt Anwendungscode die Überprüfung, nachdem gemeinsame Standardwerte gesetzt wurden?

Die Protokollierung sollte die Fehlerkategorie und das Ziel festhalten, ohne Zugangsdaten, Request-Bodys oder sensible Query-Strings offenzulegen. „Certificate verification failed“ ist weniger bequem als eine erfolgreiche Anfrage, aber ehrlicher als die unbemerkte Umstellung von authentifiziertem TLS auf Verschlüsselung ohne verlässliche Endpunktidentität.

Was eine erfolgreiche Überprüfung dennoch nicht beweist

Eine erfolgreiche Pfad- und Namensprüfung stützt nur eine begrenzte Aussage: Der Endpunkt hat die Kontrolle über einen privaten Schlüssel nachgewiesen, der zu einem Zertifikat für die erwartete Dienstidentität passt, und zwar nach den vom Client akzeptierten Vertrauensankern und Prüfregeln. Sie beweist nicht, wer die Anwendung geschrieben hat, ob ein Konto berechtigt ist, ob der Server kompromittiert wurde oder ob zurückgegebenes JSON inhaltlich wahr ist.

Diese Einschränkung ist keine Schwäche der Hostnamenüberprüfung, sondern ihre korrekte Grenze. Anwendungsauthentifizierung, Autorisierung, Antwortvalidierung, SSRF-Kontrollen, Redirect-Richtlinien, Timeouts und Geschäftsregeln behalten ihre eigenen Aufgaben. Sicherheit lässt sich leichter nachvollziehen, wenn jede Kontrolle nur die Aussage trifft, die sie tatsächlich stützen kann.

Fazit

„HTTPS verwenden“ ist ein Ausgangspunkt und keine vollständige Client-Richtlinie. Ein PHP-Client benötigt einen vertrauenswürdigen Zertifizierungspfad und eine passende Dienstidentität. cURL bildet diese Prüfungen mit CURLOPT_SSL_VERIFYPEER und CURLOPT_SSL_VERIFYHOST ab; PHP-Streams verwenden verify_peer und verify_peer_name. Ihre sicheren Standardwerte sollten erhalten bleiben. Private Infrastruktur sollte den richtigen Vertrauensanker ergänzen, statt die Prüfungen zu entfernen.

Wenn der nächste Zertifikatsfehler eine ausgehende Anfrage blockiert, könnte die hilfreichste Frage lauten: Welche Aussage ist fehlgeschlagen — die Vertrauenskette, der erwartete Name oder die Konfiguration, die beide verbindet? Diese Frage zu beantworten dauert länger, als eine Option auf false zu setzen. Dafür repariert es das Vertrauensmodell, anstatt die Warnung zu verbergen.

References