HTTPS-certificaat (IoT)

Hypertext Transfer Protocol Secure (HTTPS) is the secure and encrypted version of Hypertext Transfer Protocol (HTTP), which is the primary protocol used for data communication between a web browser and a website. It secures communications by using an encryption protocol known as Transport Layer Security (TLS), previously called Secure Sockets Layer (SSL). The security of HTTPS relies on TLS /SSL certificates, which authenticate the provider and verify their identity.

The use of HTTPS is required to communicate with certain network devices, particularly payment terminals. If the HTTPS certificate is not valid, some devices cannot interact with the IoT system.

Notitie

In deze documentatie en overal in Odoo verwijst de term HTTPS-certificaat naar een geldig SSL-certificaat dat een HTTPS-verbinding mogelijk maakt.

HTTPS certificate generation

The HTTPS certificate is generated automatically. When the IoT system is (re-)started (e.g., after it is connected to the Odoo database), a request is sent to https://www.odoo.com, which returns the HTTPS certificate if the IoT system and database meet the eligibility criteria:

  • De database moet een productie-instantie zijn. De database-instantie mag geen kopie, duplicaat, staging- of ontwikkelomgeving zijn.

  • The Odoo subscription must be ongoing (In Progress status) and have an IoT box subscription line.

Wanneer het certificaat is ontvangen:

  • The IoT system’s homepage address is updated to a new HTTPS URL ending with .odoo-iot.com. Click the URL to establish a secure HTTPS connection.

    Odoo IoT app IoT box met .odoo-iot.com domein.

  • The HTTPS certificate banner displays the certificate’s validity period. To view this information, click the (cogs) button on the IoT system’s homepage.

    IoT Box-homepage met geldigheidsdatum van HTTPS-certificaat.

Problemen en fouten bij het genereren van HTTPS-certificaten

Het HTTPS-certificaat genereert geen

Mogelijke oorzaken zijn de volgende:

  • No IoT box subscription is linked to your account.

  • The IoT box subscription was added after connecting the IoT system to the database. In this case, refresh the IoT system’s homepage or reboot/restart the IoT system to regenerate the HTTPS certificate.

  • De firewall verhindert dat het HTTPS-certificaat correct wordt gegenereerd. Schakel in dit geval de firewall uit totdat het certificaat succesvol is gegenereerd.

    Notitie

    Sommige apparaten, zoals routers met een ingebouwde firewall, kunnen voorkomen dat het HTTPS-certificaat wordt gegenereerd.

De homepage van het IoT-systeem is toegankelijk via het IP-adres maar niet via de xxx.odoo-iot.com URL

Neem contact op met je systeem- of netwerkbeheerder om het probleem aan te pakken. Netwerkgerelateerde problemen vallen buiten de scope van Odoo-ondersteuningsdiensten.

  • Als de router handmatige DNS-configuratie toestaat, werk je de instellingen bij om Google DNS te gebruiken.

  • Als de router dit niet ondersteunt, moet je de DNS-instellingen rechtstreeks op elk apparaat dat met het IoT-systeem communiceert bijwerken om Google DNS te gebruiken. Instructies voor het configureren van DNS op individuele apparaten zijn te vinden op de website van de betreffende fabrikant.

Notitie

  • Sommige IoT-apparaten, zoals betaalterminals, hebben waarschijnlijk geen DNS-wijzigingen nodig, omdat ze doorgaans vooraf zijn geconfigureerd met aangepaste DNS-instellingen.

  • In sommige browsers wordt een foutcode weergegeven die de DNS vermeldt (zoals DNS_PROBE_FINISHED_NXDOMAIN).

Fouten

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.

Tip

Wanneer je de homepage van het IoT-systeem opent, controleert het automatisch op een HTTPS-certificaat en probeert het er een te genereren als het ontbreekt. Als er een fout verschijnt, ververs je de pagina om te zien of het probleem is opgelost.

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

The contract and/or database UUID is missing form the 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

Er is een onverwachte fout opgetreden terwijl het IoT-systeem probeerde https://www.odoo.com te bereiken. Dit komt waarschijnlijk door netwerkgerelateerde problemen, zoals:

  • Het IoT-systeem heeft geen internettoegang.

  • Netwerkbeperkingen (bv. firewalls of VPN’s) verhinderen communicatie met https://www.odoo.com.

Notitie

ERR_IOT_HTTPS_LOAD_REQUEST_STATUS

Het IoT-systeem heeft https://www.odoo.com succesvol bereikt, maar ontving een onverwachte HTTP-respons (statuscodes).

Deze foutcode bevat de HTTP-status. Bijvoorbeeld: ERR_IOT_HTTPS_LOAD_REQUEST_STATUS 404 betekent dat de server een “Pagina niet gevonden”-respons heeft geretourneerd.

Om dit probleem op te lossen:

  1. Open https://www.odoo.com in een webbrowser om te controleren of de website tijdelijk niet beschikbaar is vanwege onderhoud.

  2. Als https://www.odoo.com niet beschikbaar is vanwege onderhoud, wacht dan tot het weer beschikbaar is.
    Als de website operationeel is, open dan een supportticket en zorg ervoor dat je de 3-cijferige HTTPS-statuscode in het ticket opneemt.

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.

Controleer of het IoT-systeem en de database voldoen aan de geschiktheidsvereisten voor een HTTPS-certificaat.