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

  • Some IoT devices, such as payment terminals, likely do not require DNS changes, as they are typically pre-configured with custom DNS settings.

  • On some browsers, an error code mentioning the DNS (such as DNS_PROBE_FINISHED_NXDOMAIN) is displayed.

Fehler

A specific error code is displayed on the IoT system’s homepage if any issues occur during the generation or reception of the HTTPS certificate.

Tipp

When you access the IoT system’s homepage, it automatically checks for an HTTPS certificate and attempts to generate one if it is missing. If an error appears, refresh the page to see if the issue is resolved.

ERR_IOT_HTTPS_CHECK_NO_SERVER

The server configuration is missing, i.e., the Odoo instance is not connected to the IoT system.

ERR_IOT_HTTPS_CHECK_CERT_READ_EXCEPTION

An error occurred while attempting to read the existing HTTPS certificate. Verify that the HTTPS certificate file is readable.

ERR_IOT_HTTPS_LOAD_NO_CREDENTIAL

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

Verify that both values are correctly configured. To update them, access the IoT box’s or Windows virtual IoT’s homepage, click the (cogs) button, then click Credential.

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, wie:

  • Das IoT-System hat keinen Internetzugriff.

  • Network restrictions (e.g., firewalls or VPNs) are preventing communication with https://www.odoo.com.

Bemerkung

  • To access the full request exception details with information regarding the error, enable the developer mode, click the IoT system’s card in the IoT app, and click Download logs on the IoT system’s form. To define the log levels recorded in the IoT system’s log file, access the IoT box’s or Windows virtual IoT’s homepage, click the (cogs) button, then Log level at the bottom of the page.

  • To address network-related issues, contact your system or network administrator; these issues are beyond the scope of Odoo support services.

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. Open https://www.odoo.com in a web browser to check if the website is temporarily down for maintenance.

  2. Wenn https://www.odoo.com aufgrund von Wartungsarbeiten nicht erreichbar ist, müssen Sie warten, bis die Seite wieder funktioniert.
    If the website is operational, open a support ticket and make sure to include the 3-digit HTTPS status code in the ticket.

ERR_IOT_HTTPS_LOAD_REQUEST_NO_RESULT

The IoT system successfully connected to https://www.odoo.com, but the server refused to provide the HTTPS certificate.

Check that the IoT system and database meet the eligibility requirements for an HTTPS certificate.