Behebung von SSL-Fehlern beim Hochladen von Agisoft Metashape zu Sketchfab

Sie versuchen, Ihr 3D-Modell von Agisoft Metashape auf Sketchfab hochzuladen, aber es tritt ein „SSL-Fehler“ auf? Da sind Sie nicht allein. Viele Benutzer haben Probleme, wenn sie direkt auf Sketchfab veröffentlichen, weil die SSL-Zertifikate oder die Systemkonfigurationen veraltet sind. In diesem Artikel erfahren Sie, warum SSL-Fehler auftreten, wie Sie sie beheben können und welche alternativen Methoden Sie verwenden können, um Ihr Modell auf Sketchfab zu veröffentlichen.

Was ist der SSL-Fehler in Metashape?

SSL-Fehler (Secure Sockets Layer) treten normalerweise auf, wenn Metashape keine sichere Verbindung zum Sketchfab-Server herstellen kann. Die vollständige Fehlermeldung sieht oft wie folgt aus:

Error uploading to Sketchfab: SSL: CERTIFICATE_VERIFY_FAILED

Dies bedeutet, dass das von Sketchfab vorgelegte SSL-Zertifikat von Ihrem System oder Ihrer Python-Umgebung nicht erkannt oder als vertrauenswürdig eingestuft wurde.

Warum dies geschieht

• Ihr lokaler Zertifikatspeicher ist veraltet (insbesondere unter macOS oder Linux)
• Sie verwenden eine ältere Version von Metashape mit veralteten Python SSL-Bibliotheken
• Ihre Netzwerk-Firewall oder Ihr Antivirenprogramm blockiert den SSL-Handshake
• Ihr System vertraut der von Sketchfab verwendeten Let’s Encrypt CA-Root nicht

In den meisten Fällen handelt es sich um ein Problem mit der Vertrauenswürdigkeit von Zertifikaten und nicht um einen Fehler in Metashape selbst.

Schnellreparaturen für SSL-Upload-Fehler

1. Aktualisieren Sie auf die neueste Version von Metashape

Stellen Sie sicher, dass Sie die neueste Version von Metashape Professional oder Standard verwenden. Ältere Versionen basieren auf veralteten Python-SSL-Bibliotheken, die neueren CA-Zertifikaten möglicherweise nicht vertrauen.

• Gehen Sie zu agisoft.com/downloads
• Installieren Sie die neueste Version für Ihr Betriebssystem
• Versuchen Sie erneut, Ihr Modell hochzuladen

2. Installieren oder aktualisieren Sie SSL-Zertifikate auf Ihrem Betriebssystem

Jedes Betriebssystem hat seinen eigenen Zertifizierungsstellen-Speicher. Wenn dieser veraltet oder beschädigt ist, schlägt die SSL-Überprüfung fehl.

Unter macOS:

• Zugang zum Schlüsselbund öffnen
• Zu den Systemwurzeln gehen
• Suchen Sie nach „ISRG Root X1“ (verwendet von Let’s Encrypt)
• Falls nicht vorhanden, laden Sie es von letsencrypt.org herunter und installieren Sie es .

Unter Windows:

• Gehen Sie zu Einstellungen → Updates & Sicherheit → Windows Update
• Installieren Sie alle anstehenden Sicherheitsupdates
• Stellen Sie sicher, dass der Internet Explorer oder Edge auf das Internet zugreifen kann (wird von der SSL-Schicht des Systems verwendet)

3. Ein Python-Skript mit benutzerdefiniertem SSL-Kontext verwenden (Fortgeschrittene)

Wenn Sie mit Skripten vertraut sind, können Sie mit Python manuell zu Sketchfab hochladen und bestimmte SSL-Fehler umgehen, indem Sie den SSL-Kontext anpassen.

import ssl
import urllib.request

ctx = ssl.create_default_context()
ctx.check_hostname = False
ctx.verify_mode = ssl.CERT_NONE

url = "https://api.sketchfab.com/v3/models"
req = urllib.request.Request(url)
response = urllib.request.urlopen(req, context=ctx)
print(response.read())

Warnung: Die Deaktivierung der SSL-Überprüfung sollte nur zu Testzwecken erfolgen. Sie wird nicht für die Produktion oder professionelle Arbeitsabläufe empfohlen.

Alternative Methode: Manuell zu Sketchfab hochladen

Wenn der direkte Metashape-Upload weiterhin fehlschlägt, können Sie das Modell jederzeit exportieren und manuell auf Sketchfab hochladen.

1. Gehen Sie zu Datei → Modell exportieren
2. Wählen Sie das OBJ-, FBX- oder glTF-Format
3. Texturen einfügen, falls vorhanden
4. Bei Sketchfab.com anmelden
5. Klicken Sie auf Hochladen → Datei wählen und laden Sie Ihr Modell hoch.

Diese Methode funktioniert immer, unabhängig vom SSL-Status, und gibt Ihnen mehr Kontrolle über Titel, Tags und Datenschutzeinstellungen.

Wie Sie SSL-Fehler in Zukunft vermeiden können

• Halten Sie Metashape auf dem neuesten Stand
• Halten Sie die Zertifikate Ihres Betriebssystems auf dem neuesten Stand
• Vermeiden Sie die Verwendung veralteter Versionen von Python oder TLS-Bibliotheken
• Stellen Sie sicher, dass Ihre Antiviren-Software den HTTPS-Datenverkehr nicht blockiert.

Bonus-Tipp: Verwenden Sie das Sketchfab API Token richtig

Vergewissern Sie sich, dass Sie das richtige API-Token von Ihrem Sketchfab-Konto in Metashape eingegeben haben:

1. Gehen Sie zu Sketchfab Einstellungen → Passwörter
2. Generieren oder kopieren Sie Ihr API-Token
3. Gehen Sie in Metashape zu Extras → Einstellungen → Sketchfab
4. Fügen Sie den Token ein und speichern Sie

Fazit

SSL-Fehler beim Hochladen von Agisoft Metashape zu Sketchfab sind frustrierend – aber oft leicht zu beheben. Aktualisieren Sie zunächst die Version von Metashape und die Zertifikate Ihres Betriebssystems. Wenn das Problem weiterhin besteht, exportieren Sie Ihr Modell manuell und laden es über die Sketchfab-Website hoch. Und für technisch versierte Benutzer bietet das erweiterte Skripting mehr Kontrolle über das Upload-Verhalten. In jedem Fall können Sie Ihre 3D-Modelle auf sichere und professionelle Weise online stellen.

Benötigen Sie mehr Hilfe? Besuchen Sie das Agisoft Support Portal oder das Sketchfab Help Center, um weitere Hilfe zu erhalten.