← Zurück zum Blog

Fehler mit selbstsignierten SSL-Zertifikaten im Codex-Desktop-Browser unter macOS beheben

Übersetzter Artikel. Original lesen

Ein praktischer Workaround, um lokale HTTPS-Dienste wie Unraid über den integrierten Browser von OpenAI Codex zu öffnen.

Das Problem

Lokale Entwicklungsumgebungen, Heimserver und selbst gehostete Anwendungen verwenden für HTTPS-Verbindungen häufig selbstsignierte SSL-Zertifikate.

Das ist unter anderem bei folgenden Anwendungen üblich:

  • Unraid
  • Proxmox
  • Home Assistant
  • Lokale Entwicklungsserver
  • Interne Dashboards und Administrationsoberflächen

Die meisten Browser, darunter Chrome, Safari und Brave, erlauben es, eine Zertifikatswarnung zu bestätigen und die Website trotzdem zu öffnen.

Der integrierte Browser der Codex-Desktop-Anwendung von OpenAI verhält sich jedoch anders.

Beim Zugriff auf einen lokalen Server mit selbstsigniertem Zertifikat, beispielsweise:

https://hs0.local/

verweigert der Browser möglicherweise die Verbindung und zeigt einen Fehler wie diesen:

NET::ERR_CERT_AUTHORITY_INVALID

Anders als herkömmliche Browser bietet Codex derzeit keine dokumentierte Möglichkeit, diese Warnung über die Browseroberfläche zu umgehen.

Diese Einschränkung ist auch in GitHub-Issue #23891 dokumentiert. Dort wird beschrieben, dass Codex Desktop keine Umgehung der Zertifikatswarnung anbietet.

Warum passiert das?

Selbstsignierte Zertifikate verschlüsseln die Verbindung, werden von Betriebssystemen und Browsern aber nicht automatisch als vertrauenswürdig eingestuft.

Die HTTPS-Zertifikatsprüfung umfasst normalerweise drei wichtige Kontrollen:

  1. Vertrauen: Das Zertifikat muss von einer vertrauenswürdigen Zertifizierungsstelle ausgestellt oder vom System ausdrücklich als vertrauenswürdig markiert sein.
  2. Hostname-Prüfung: Der Hostname muss mit einem der Subject Alternative Names (SANs) des Zertifikats übereinstimmen.
  3. Gültigkeit: Das Zertifikat muss innerhalb seines Gültigkeitszeitraums liegen und weitere Sicherheitsanforderungen erfüllen.

Bei einem selbstsignierten Zertifikat schlägt normalerweise die erste Prüfung fehl.

Klassische Browser erlauben es häufig, diesen Fehler zu übergehen. Dem eingebetteten Codex-Browser fehlt derzeit eine entsprechende sichtbare Option.

macOS bietet jedoch eine Möglichkeit, Zertifikaten ausdrücklich zu vertrauen.

Lösung: Zertifikat exportieren und zum macOS-Schlüsselbund hinzufügen

Für den Workaround wird das SSL-Zertifikat vom lokalen Server abgerufen, in macOS als vertrauenswürdig konfiguriert und der Server über einen vom Zertifikat abgedeckten Hostnamen geöffnet. In meinem Setup lautet dieser hs0.local. Ersetzen Sie ihn durch den Hostnamen aus Ihrem Zertifikat.

Schritt 1: HTTPS-Verbindung prüfen

Öffnen Sie zunächst das Terminal unter macOS und führen Sie folgenden Befehl aus:

curl -vk https://hs0.local/ -o /dev/null

Das Flag -k weist curl an, die Zertifikatsprüfung für diese Anfrage zu überspringen.

So lässt sich feststellen, ob der Server erreichbar ist und der SSL-Handshake funktioniert. Da -k die Prüfung überspringt, beweist eine erfolgreiche Antwort weder, dass dem Zertifikat vertraut wird, noch dass der Hostname übereinstimmt.

Wichtig: Dieser Befehl verändert keine Systemeinstellungen und deaktiviert die Zertifikatsprüfung nicht global.

Schritt 2: Selbstsigniertes Zertifikat exportieren

Als Nächstes wird das Zertifikat vom lokalen Server abgerufen.

Verwenden Sie für den Export den Hostnamen, der später im Browser geöffnet werden soll:

openssl s_client -connect hs0.local:443 -servername hs0.local </dev/null | openssl x509 -outform PEM > "$HOME/Desktop/hs0.crt"

Der Befehl besteht aus folgenden Teilen:

Komponente Zweck
openssl s_client Stellt eine TLS-Verbindung zum Server her
-connect hs0.local:443 Verbindet sich über HTTPS-Port 443 mit dem Server
-servername hs0.local Gibt den Hostnamen per TLS Server Name Indication (SNI) an
</dev/null Verhindert, dass OpenSSL auf interaktive Eingaben wartet
openssl x509 Extrahiert und verarbeitet das Serverzertifikat
-outform PEM Exportiert das Zertifikat im PEM-Format
> "$HOME/Desktop/hs0.crt" Speichert das Zertifikat auf dem macOS-Schreibtisch

Nach erfolgreicher Ausführung liegt das Zertifikat hier:

~/Desktop/hs0.crt

Die exportierte Datei enthält das öffentliche Zertifikat, nicht den privaten Schlüssel des Servers.

Hinweis: Der Befehl exportiert das erste vom Server präsentierte Zertifikat. Verwendet der Server ein von einer privaten CA ausgestelltes Zertifikat, sollte stattdessen in der Regel das zugehörige Root-CA-Zertifikat installiert werden.

Schritt 3: Zertifikat prüfen

Prüfen Sie das Zertifikat vor der Installation:

openssl x509 -in "$HOME/Desktop/hs0.crt" -noout -subject -issuer -dates -fingerprint -sha256

Der Befehl zeigt unter anderem Aussteller, Gültigkeitszeitraum und SHA-256-Fingerabdruck an.

Vergleichen Sie den Fingerabdruck über einen vertrauenswürdigen Administrationskanal mit dem auf dem Server konfigurierten Zertifikat.

Auch die Subject Alternative Names des Zertifikats lassen sich anzeigen:

openssl x509 -in "$HOME/Desktop/hs0.crt" -noout -ext subjectAltName

Verwenden Sie den im Zertifikat aufgeführten Hostnamen. In diesem Beispiel enthält das Zertifikat DNS:hs0.local; öffnen Sie daher https://hs0.local/. https://hs0/ führt selbst nach dem Vertrauensimport zu ERR_CERT_COMMON_NAME_INVALID. Ein als vertrauenswürdig markiertes Zertifikat behebt keine Hostnamenabweichung.

Schritt 4: Zertifikat in den macOS-Schlüsselbund importieren

Nach der Prüfung kann das Zertifikat zu macOS hinzugefügt werden.

  1. Über Spotlight die Schlüsselbundverwaltung öffnen.
  2. Den Schlüsselbund Anmeldung auswählen.
  3. Das Zertifikat hs0.crt importieren.
  4. Das importierte Zertifikat doppelt anklicken.
  5. Den Bereich Vertrauen aufklappen.
  6. Bei Verwendung dieses Zertifikats auf Immer vertrauen setzen.
  7. Den Dialog schließen und bei Bedarf authentifizieren.

macOS unterstützt das explizite Überschreiben der Vertrauensrichtlinien über die Schlüsselbundverwaltung. Apple dokumentiert dies im offiziellen Leitfaden zur Schlüsselbundverwaltung.

Aktivieren Sie diese Einstellung nur für Zertifikate, deren Identität und Herkunft Sie geprüft haben.

Schritt 5: Codex Desktop neu starten und passenden Hostnamen öffnen

Beenden Sie Codex Desktop nach dem Import vollständig.

Unter macOS:

Cmd + Q

Starten Sie die Anwendung neu und öffnen Sie:

https://hs0.local/

In meinem Setup ließ sich diese Adresse öffnen, nachdem das Zertifikat im Schlüsselbund Anmeldung als vertrauenswürdig markiert worden war.

Die Zertifikatsbehandlung kann je nach Anwendungsversion variieren. Falls der Zugriff weiterhin scheitert, prüfen Sie Hostname, Gültigkeit und Vertrauenseinstellungen des Zertifikats.

Alternative: Öffentlich vertrauenswürdiges Zertifikat verwenden

Für den langfristigen Einsatz ist ein öffentlich vertrauenswürdiges SSL-Zertifikat häufig die sauberere Lösung.

Unraid unterstützt beispielsweise Zertifikate über seine myunraid.net-Infrastruktur.

Diese Zertifikate können hier eingerichtet werden:

Settings → Management Access

Anders als selbstsignierte Zertifikate werden myunraid.net-Zertifikate von herkömmlichen Browsern ohne manuelle Installation auf jedem Client als vertrauenswürdig erkannt.

Die genaue Zugriffs-URL unterscheidet sich vom lokalen Hostnamen und wird von Unraid bereitgestellt. Unraid-Dokumentation

Dieser Ansatz vermeidet die manuelle Zertifikatsverteilung und eignet sich besonders, wenn mehrere Geräte auf denselben Server zugreifen.

Sicherheitsaspekte

Es gibt einen wichtigen Unterschied zwischen dem Vertrauen in ein einzelnes selbstsigniertes Zertifikat und dem vollständigen Deaktivieren der Zertifikatsprüfung.

Einem bestimmten Zertifikat zu vertrauen stellt eine explizite Vertrauensbeziehung zu genau diesem Zertifikat her.

Die Zertifikatsprüfung global zu deaktivieren erlaubt Verbindungen zu Servern, deren Identität nicht geprüft werden kann, und erzeugt ein deutlich größeres Sicherheitsrisiko.

Bei Administrationsoberflächen wie Unraid, die Zugriff auf virtuelle Maschinen, Docker-Container, Speicher und privilegierte Systemoperationen gewähren, sollten globale Umgehungen der Zertifikatsprüfung vermieden werden.

Eine korrekt konfigurierte Vertrauensbeziehung ist vorzuziehen.

Fazit

Der Umgang des Codex-Desktop-Browsers mit selbstsignierten SSL-Zertifikaten ist eine praktische Einschränkung für Entwickler und Systemadministratoren lokaler Infrastruktur.

Anders als Chrome oder Safari bietet Codex derzeit keine sichtbare Möglichkeit, eine Zertifikatswarnung zu akzeptieren und fortzufahren.

In meinem Setup waren zwei Schritte nötig: dem selbstsignierten Zertifikat in der macOS-Schlüsselbundverwaltung ausdrücklich vertrauen und den darin aufgeführten Hostnamen verwenden.

Das Zertifikat deckte hs0.local ab, daher funktionierte folgende URL:

https://hs0.local/

Damit war der Zugriff möglich, ohne die TLS-Prüfung global zu deaktivieren.

Weiterführende Ressourcen: