HTTPS-Zertifikat (IoT)

Hypertext Transfer Protocol Secure (HTTPS) ist die sichere und verschlüsselte Version des Hypertext Transfer Protocol (HTTP), dem primären Protokoll für die Datenkommunikation zwischen einem Webbrowser und einer Website. Es sichert die Kommunikation mithilfe eines Verschlüsselungsprotokolls namens Transport Layer Security (TLS), das zuvor als Secure Sockets Layer (SSL) bezeichnet wurde. Die Sicherheit von HTTPS basiert auf TLS /SSL-Zertifikaten, die den Anbieter authentifizieren und dessen Identität überprüfen.

Für die Kommunikation mit bestimmten Netzwerkgeräten, insbesondere Zahlungsterminals, muss HTTPS verwendet werden. Wenn das HTTPS-Zertifikat nicht gültig ist, können einige Geräte nicht mit dem IoT-System interagieren.

Bemerkung

In dieser Dokumentation und in Odoo bezieht sich der Begriff HTTPS-Zertifikat auf ein gültiges SSL-Zertifikat, das eine HTTPS-Verbindung ermöglicht.

Generierung des HTTPS-Zertifikats

Das HTTPS-Zertifikat wird automatisch generiert. Beim (Neu-)Start des IoT-Systems (z. B. nach der Verbindung mit der Odoo-Datenbank) wird eine Anfrage an https://www.odoo.com gesendet, die das HTTPS-Zertifikat zurückgibt, wenn das IoT-System und die Datenbank die Zulassungskriterien erfüllen:

  • Die Datenbank muss eine Produktionsinstanz sein. Bei der Datenbankinstanz sollte es sich nicht um eine Kopie, ein Duplikat, eine Staging- oder eine Entwicklungsumgebung handeln.

  • Das Odoo-Abonnement muss aktiv sein (Status In Bearbeitung) und eine Zeile IoT-Box-Abonnement enthalten.

Wenn das Zertifikat empfangen wurde:

  • Die Adresse der Startseite des IoT-Systems wird auf eine neue HTTPS-URL aktualisiert, die mit .odoo-iot.com endet. Klicken Sie auf die URL, um eine sichere HTTPS-Verbindung herzustellen.

    IoT-Box mit Domain .odoo-iot.com in der Odoo-IoT-App

  • Das Banner HTTPS-Zertifikat zeigt die Gültigkeitsdauer des Zertifikats an. Um diese Informationen anzuzeigen, klicken Sie auf die Schaltfläche (Zahnrad) auf der Startseite des IoT-Systems.

    Startseite der IoT-Box mit dem Gültigkeitsdatum des HTTPS-Zertifikats.

Fehler und Probleme bei Generierung des HTTPS-Zertifikats

Das HTTPS-Zertifikat wird nicht generiert

Es gibt folgende potenzielle Gründe:

  • Es ist kein IoT-Box-Abonnment mit Ihrem Konto verknüpft.

  • Das IoT-Box-Abonnement wurde nach dem Verbinden des IoT-Systems mit der Datenbank hinzugefügt. Aktualisieren Sie in diesem Fall die Startseite des IoT-Systems oder aktualisieren Sie das IoT-System oder starten Sie es neu, um das HTTPS-Zertifikat neu zu generieren.

  • Die Firewall verhindert die korrekte Generierung des HTTPS-Zertifikats. Deaktivieren Sie in diesem Fall die Firewall, bis das Zertifikat erfolgreich generiert wurde.

    Bemerkung

    Einige Geräte, wie beispielsweise Router mit integrierter Firewall, können die Erstellung des HTTPS-Zertifikats verhindern.

Über die IP-Adresse kann auf die Startseite des IoT-Systems zugegriffen werden, jedoch nicht über die URL xxx.odoo-iot.com.

Wenden Sie sich an Ihren System- oder Netzwerkadministrator, um das Problem zu beheben. Netzwerkbezogene Probleme liegen außerhalb des Supportbereichs von Odoo.

  • Wenn der Router die manuelle DNS-Konfiguration ermöglicht, aktualisieren Sie die Einstellungen zur Verwendung von Google DNS <https://developers.google.com/speed/public-dns>.

  • Wenn der Router dies nicht unterstützt, müssen Sie die DNS-Einstellungen direkt auf jedem Gerät, das mit dem IoT-System interagiert, aktualisieren, um Google DNS zu verwenden. Anweisungen zur Konfiguration des DNS auf einzelnen Geräten finden Sie auf der Website des jeweiligen Herstellers.

Bemerkung

  • Einige IoT-Geräte, wie beispielsweise Zahlungsterminals, erfordern wahrscheinlich keine DNS-Änderungen, da sie in der Regel mit benutzerdefinierten DNS-Einstellungen vorkonfiguriert sind.

  • Bei einigen Browsern wird ein Fehlercode angezeigt, der sich auf das DNS bezieht (z. B. DNS_PROBE_FINISHED_NXDOMAIN).

Fehler

Wenn bei der Erstellung oder dem Empfang des HTTPS-Zertifikats Probleme auftreten, wird auf der Startseite des IoT-Systems ein spezifischer Fehlercode angezeigt.

Tipp

Wenn Sie die Startseite des IoT-Systems aufrufen, wird automatisch nach einem HTTPS-Zertifikat gesucht und bei Fehlen versucht, eines zu generieren. Sollte ein Fehler auftreten, aktualisieren Sie die Seite, um zu überprüfen, ob das Problem behoben wurde.

ERR_IOT_HTTPS_CHECK_NO_SERVER

Die Serverkonfiguration fehlt, d. h., die Odoo-Instanz ist nicht mit dem IoT-System verbunden.

ERR_IOT_HTTPS_CHECK_CERT_READ_EXCEPTION

Beim Versuch, das vorhandene HTTPS-Zertifikat zu lesen, ist ein Fehler aufgetreten. Überprüfen Sie, ob die HTTPS-Zertifikatsdatei lesbar ist.

ERR_IOT_HTTPS_LOAD_NO_CREDENTIAL

Die UUID des Vertrags und/oder der Datenbank fehlt in der IoT.

Überprüfen Sie, ob beide Werte korrekt konfiguriert sind. Um sie zu aktualisieren, rufen Sie die IoT-Box-Seite oder die Seite des virtuellen Windows-IoT auf, klicken Sie auf die Schaltfläche (Zahnräder) und anschließend auf Credential (Anmeldedaten).

ERR_IOT_HTTPS_LOAD_REQUEST_EXCEPTION

Ein unerwarteter Fehler ist aufgetreten, als das IoT-System versucht hat, https://www.odoo.com zu erreichen. Dies liegt wahrscheinlich an Problemen mit dem Netzwerk:

  • Das IoT-System hat keinen Internetzugriff.

  • Netzwerkbeschränkungen (z. B. Firewalls oder VPNs) verhindern die Kommunikation mit https://www.odoo.com.

Bemerkung

  • Um die vollständigen Details zur Ausnahmeanforderung mit Informationen zum Fehler anzuzeigen, aktivieren Sie den Entwicklermodus, klicken Sie in der IoT-App auf die Karte des IoT-Systems und klicken Sie im Formular des IoT-Systems auf Protokolle herunterladen. Um die Protokollebenen zu definieren, die in der Protokolldatei des IoT-Systems aufgezeichnet werden, rufen Sie die Startseite der IoT-Box oder des virtuellen Windows-IoT auf, klicken Sie auf die Schaltfläche (Zahnrad) und anschließend unten auf der Seite auf Log level (Protokollebene).

  • Bei Netzwerkproblemen wenden Sie sich an Ihren System- oder Netzwerkadministrator, da diese Probleme außerhalb des Supportumfangs von Odoo liegen.

ERR_IOT_HTTPS_LOAD_REQUEST_STATUS

Das IoT-System konnte https://www.odoo.com erreichen, erhielt aber eine unerwartete HTTP-Antwort (Statuscodes).

Dieser Fehlercode enthält den HTTP-Status. Wenn der Fehler zum Beispiel ERR_IOT_HTTPS_LOAD_REQUEST_STATUS 404 lautet, bedeutet dies, dass der Server eine „Seite nicht gefunden“-Antwort zurückgegeben hat.

Um das Problem zu lösen:

  1. Öffnen Sie https://www.odoo.com in einem Webbrowser, um zu überprüfen, ob die Website aufgrund von Wartungsarbeiten vorübergehend nicht erreichbar ist.

  2. Wenn https://www.odoo.com aufgrund von Wartungsarbeiten nicht erreichbar ist, müssen Sie warten, bis die Seite wieder funktioniert.
    Falls die Website funktionsfähig ist, erstellen Sie ein Supportticket und geben Sie den dreistelligen HTTPS-Statuscode im Ticket an.

ERR_IOT_HTTPS_LOAD_REQUEST_NO_RESULT

Das IoT-System hat sich erfolgreich mit https://www.odoo.com verbunden, jedoch hat der Server die Bereitstellung des HTTPS-Zertifikats abgelehnt.

Überprüfen Sie, ob das IoT-System und die Datenbank die Zulassungsvoraussetzungen für ein HTTPS-Zertifikat erfüllen.