HOWTO · Python

Beheben Sie den Fehler SSL: CERTIFICATE_VERIFY_FAILED in Python

Dieser Artikel erklärt, wie Sie den Fehler `SSL: CERTIFICATE_VERIFY_FAILED` diagnostizieren und die Zertifikatsprüfung sicher wiederherstellen.

Auf dieser Seite

SSL: CERTIFICATE_VERIFY_FAILED bedeutet, dass Python nicht feststellen konnte, ob das bei einer TLS-Verbindung vorgelegte Zertifikat auf eine vertrauenswürdige Zertifizierungsstelle zurückgeht und zum angefragten Host passt. Dies ist ein clientseitiger Überprüfungsfehler. Er bedeutet nicht, dass eine Zertifizierungsstelle einen Fehler zurückgegeben hat, weil eine Domain nicht existiert.

TLS verschlüsselt den Datenverkehr und authentifiziert den Server anhand seines Zertifikats. Lassen Sie die Überprüfung aktiviert, während Sie herausfinden, welcher Teil der Vertrauensprüfung fehlgeschlagen ist.

Was SSL: CERTIFICATE_VERIFY_FAILED bedeutet

Der Server legt während des Verbindungsaufbaus ein TLS-Zertifikat vor. Der Client prüft dessen Gültigkeitszeitraum, Hostnamen und Ausstellerkette sowie, ob diese Kette zu einem vertrauenswürdigen Stammzertifikat im Truststore des Clients führt. Pythons Modul ssl führt diese Prüfungen aus, wenn ein SSL-Kontext mit aktivierter Zertifikatsprüfung verwendet wird. Auch Requests prüft Zertifikate standardmäßig.

Der Fehler kann auf jeder Seite der Verbindung entstehen. Beispielsweise liefert der Server möglicherweise ein Zwischenzertifikat nicht mit, während im lokalen Python-System ein veraltetes CA-Bundle liegt. Auch ein nicht übereinstimmender Hostname, eine falsch eingestellte Systemuhr, eine private Zertifizierungsstelle oder ein TLS-inspektierender Proxy können die Ursache sein. Der Fehler allein verrät nicht, welcher Fall vorliegt.

Ursache ermitteln

Prüfen Sie die folgenden Punkte mit demselben Hostnamen und derselben Python-Umgebung, die auch die betroffene Anwendung verwendet:

  1. Serverzertifikat und Zertifikatskette prüfen. Vergewissern Sie sich, dass das Zertifikat noch gültig ist, für den Hostnamen in der URL ausgestellt wurde und die erforderlichen Zwischenzertifikate enthält, die zur ausstellenden Stelle führen. Wenn ein Browser oder ein anderer Client funktioniert, vergleichen Sie dessen Vertrauenseinstellungen und Netzwerkpfad. Der Unterschied ist ein Hinweis, aber kein Beweis dafür, dass der Server korrekt konfiguriert ist.
  2. Uhrzeit prüfen. Stellen Sie sicher, dass Datum und Uhrzeit auf dem Rechner oder im Container stimmen. Eine stark abweichende Uhrzeit kann ein gültiges Zertifikat als abgelaufen oder noch nicht gültig erscheinen lassen.
  3. Python-Umgebung und HTTP-Client ermitteln. Prüfen Sie, welcher Interpreter die Anwendung ausführt und ob die fehlgeschlagene Anfrage die Standardbibliothek, Requests oder ein anderes Paket verwendet. System-Python, virtuelle Umgebung, Container und gebündelte Anwendung können jeweils einen anderen Truststore verwenden.
  4. Vertrauensquelle und Netzwerkpfad prüfen. Ermitteln Sie, ob der Server eine private CA nutzt und ob ein Unternehmensproxy TLS-Verbindungen abfängt. Fragen Sie die Netzwerk- oder Sicherheitsadministration nach dem freigegebenen CA-Zertifikat und den Anweisungen für diese Umgebung. Laden Sie kein Zertifikat aus einer ungeprüften Quelle herunter, nur um den Fehler verschwinden zu lassen.

Ist das Serverzertifikat abgelaufen, für den falschen Hostnamen ausgestellt oder fehlen erforderliche Zwischenzertifikate, bitten Sie den Serverbetreiber, die Bereitstellung zu korrigieren. Eine Änderung des clientseitigen CA-Bundles kann eine fehlerhafte Serverkette nicht reparieren.

Zertifikat oder Truststore korrigieren

Bei einem serverseitigen Problem besteht die dauerhafte Lösung darin, dass der Serverbetreiber das Zertifikat für den angefragten Hostnamen erneuert oder die Zertifikatskette korrekt konfiguriert. Ein erneuter Versuch in einem anderen Browser kann beim Vergleich des Verhaltens helfen, repariert aber weder das Zertifikat noch macht er eine nicht vertrauenswürdige Verbindung sicher.

Für einen privaten Dienst oder einen genehmigten TLS-inspektierenden Proxy beziehen Sie das Stammzertifikat der Organisation über deren vertrauenswürdigen Verteilungskanal. Installieren Sie es im Truststore des betreffenden Betriebssystems, Containers oder der Python-Umgebung, oder konfigurieren Sie die Anwendung so, dass sie dieses CA-Bundle verwendet. Folgen Sie dem dokumentierten Verfahren der Administration, damit Herkunft und vorgesehener Geltungsbereich des Zertifikats bekannt sind.

Ein veraltetes CA-Bundle kann ebenfalls Fehler verursachen, wenn ein Server eine neuere, ansonsten gültige öffentliche CA verwendet. Aktualisieren Sie den Truststore oder das CA-Bundle-Paket, das die Anwendung nutzt. Ein Update von pip kann pip selbst in manchen Python-Installationen dabei helfen, die Zertifikate für Paketdownloads aufzulösen. Ein Update von certifi kann das Bundle aktualisieren, das Requests verwendet, sofern Requests dafür konfiguriert ist. Diese Updates beheben weder ein abgelaufenes Serverzertifikat noch einen falschen Hostnamen, ein fehlendes Server-Zwischenzertifikat oder eine Organisations-CA, der noch nicht vertraut wird.

Python und Requests so konfigurieren, dass Zertifikate geprüft werden

Pythons SSL-Modul aus der Standardbibliothek und Requests können unterschiedliche Vertrauensquellen verwenden. ssl.create_default_context() lädt die für diese Python-/OpenSSL-Umgebung verfügbaren Standardzertifikate. Welche das sind, kann von Build und Plattformkonfiguration abhängen. Requests prüft Zertifikate normalerweise mit dem von certifi bereitgestellten CA-Bundle. session.verify = True bedeutet „das in Requests konfigurierte Standard-Bundle verwenden“, nicht „Pythons ssl-Standards verwenden“ und auch nicht zwingend den Truststore des Betriebssystems. Requests kann außerdem einen Bundle-Pfad aus REQUESTS_CA_BUNDLE (oder CURL_CA_BUNDLE) übernehmen, sofern Sie die Sitzung nicht ausdrücklich konfigurieren.

Das folgende kurze Beispiel zeigt, dass Pythons Standardkontext die Zertifikatsprüfung verlangt; es ist der eigenständige Erfolgsfall:

Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.

import ssl

context = ssl.create_default_context()
print(context.verify_mode == ssl.CERT_REQUIRED)
True

Bei einer privaten CA übergeben Sie Python das vertrauenswürdige CA-Bundle als cafile und geben diesen prüfenden Kontext anschließend an die HTTPS-Anfrage der Standardbibliothek weiter. Ersetzen Sie beide Werte durch die vom Administrator bereitgestellte Dienst-URL und den Bundle-Pfad. Dieses dienstgebundene Beispiel wurde hier nicht ausgeführt. Es fängt Verbindungsfehler ab, sodass Sie es nach dem Eintragen Ihrer Werte selbst ausführen können.

import ssl
import urllib.error
import urllib.request

SERVICE_URL = "https://service.example"
CA_BUNDLE = "/path/to/organization-ca-bundle.pem"

try:
    context = ssl.create_default_context(cafile=CA_BUNDLE)
    with urllib.request.urlopen(SERVICE_URL, context=context, timeout=10) as response:
        print(response.status)
except (OSError, urllib.error.URLError) as error:
    print(f"Connection not completed: {type(error).__name__}: {error}")

Die Einstellung verify von Requests akzeptiert den Pfad zu einem CA-Bundle. Weisen Sie der Sitzung das von Ihrer Organisation bereitgestellte Bundle zu und verwenden Sie dieselbe Sitzung für die Anfrage; die Zertifikatsprüfung bleibt dabei aktiviert. Ersetzen Sie URL und Pfad durch die Werte Ihres Dienstes. Auch dieses dienstgebundene Beispiel wurde hier nicht ausgeführt.

import requests

SERVICE_URL = "https://service.example"
CA_BUNDLE = "/path/to/organization-ca-bundle.pem"

session = requests.Session()
session.verify = CA_BUNDLE

try:
    response = session.get(SERVICE_URL, timeout=10)
    print(response.status_code)
except (OSError, requests.RequestException) as error:
    print(f"Connection not completed: {type(error).__name__}: {error}")

Verwenden Sie ein CA-Bundle, dessen Aussteller Sie über den vertrauenswürdigen Kanal Ihrer Organisation überprüft haben. Ein benutzerdefiniertes Bundle muss die CA-Zertifikate enthalten, die zum Prüfen der Dienst-Zertifikatskette erforderlich sind. Das Konfigurieren einer CA behebt kein abgelaufenes Zertifikat, keinen falschen Hostnamen und kein fehlendes Zwischenzertifikat auf dem Server. Soll Requests sein übliches Bundle verwenden, lassen Sie session.verify auf dem Standardwert, statt True zuzuweisen; für eine Organisations-CA geben Sie einen ausdrücklichen Pfad an. Ein Update von certifi kann die mit Requests gebündelten öffentlichen Stammzertifikate aktualisieren, wenn genau diese Vertrauensquelle veraltet ist. Ein Update von pip kann bei Paketdownloads von pip selbst helfen. Keines der Updates ändert in jeder Umgebung Pythons ssl-Vertrauenseinstellungen oder behebt ein fehlerhaftes Serverzertifikat.

Warum Sie die Zertifikatsprüfung nicht deaktivieren sollten

Wenn Sie die Zertifikatsprüfung deaktivieren, kann ein Angreifer oder ein nicht vertrauenswürdiger Proxy ein Zertifikat für eine falsche Identität vorlegen, das der Client trotzdem akzeptiert. Verschlüsselung allein beweist nicht, dass die Gegenstelle der gewünschte Server ist. Zugangsdaten, Tokens und Antwortdaten könnten offengelegt oder verändert werden.

Verwenden Sie verify=False, einen ungeprüften SSL-Kontext oder eine globale Ersetzung von Pythons Standard-HTTPS-Kontext nicht als Reparatur. Solche Optionen verbergen den Diagnosehinweis und schwächen alle davon betroffenen Verbindungen. Stellen Sie die Überprüfung wieder her, indem Sie die Serverkette, die Uhrzeit oder den Truststore des Clients oder das ausdrücklich konfigurierte vertrauenswürdige CA-Bundle korrigieren.