HTTPS-certificaat (IoT)

Hypertext Transfer Protocol Secure (HTTPS) is de veilige en versleutelde versie van Hypertext Transfer Protocol (HTTP), het primaire protocol voor gegevenscommunicatie tussen een webbrowser en een website. Het beveiligt communicatie door gebruik te maken van een versleutelingsprotocol genaamd Transport Layer Security (TLS), voorheen Secure Sockets Layer (SSL) genoemd. De beveiliging van HTTPS is gebaseerd op TLS/SSL-certificaten, die de provider authenticeren en hun identiteit verifiëren.

Het gebruik van HTTPS is vereist om te communiceren met bepaalde netwerkapparaten, met name betaalterminals. Als het HTTPS-certificaat niet geldig is, kunnen sommige apparaten niet communiceren met het IoT-systeem.

Notitie

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

Genereren van HTTPS-certificaat

Het HTTPS-certificaat wordt automatisch gegenereerd. Wanneer het IoT-systeem (opnieuw) wordt gestart (bv. nadat het is verbonden met de Odoo-database), wordt een verzoek verzonden naar https://www.odoo.com, dat het HTTPS-certificaat retourneert als het IoT-systeem en de database voldoen aan de geschiktheidscriteria:

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

  • Het Odoo-abonnement moet actief zijn (status Actief) en een IoT Box-abonnement-regel bevatten.

Wanneer het certificaat is ontvangen:

  • Het adres van de homepage van het IoT-systeem is bijgewerkt naar een nieuwe HTTPS-URL die eindigt op .odoo-iot.com. Klik op de URL om een beveiligde HTTPS-verbinding tot stand te brengen.

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

  • De banner HTTPS-certificaat toont de geldigheidsperiode van het certificaat. Klik op de knop (tandwielen) op de homepage van het IoT-systeem om deze informatie te bekijken.

    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:

  • Geen IoT Box-abonnement is gekoppeld aan je rekening.

  • Het IoT Box-abonnement is toegevoegd nadat het IoT-systeem aan de database is verbonden. Vernieuw in dit geval de homepage van het IoT-systeem of start het IoT-systeem opnieuw op/herstart het om het HTTPS-certificaat opnieuw te genereren.

  • 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

Een specifieke foutcode wordt weergegeven op de homepage van het IoT-systeem als er problemen optreden tijdens het genereren of ontvangen van het HTTPS-certificaat.

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

De serverconfiguratie ontbreekt, d.w.z. de Odoo-instantie is niet verbonden met het IoT-systeem.

ERR_IOT_HTTPS_CHECK_CERT_READ_EXCEPTION

Er is een fout opgetreden bij het lezen van het bestaande HTTPS-certificaat. Controleer of het HTTPS-certificaatbestand leesbaar is.

ERR_IOT_HTTPS_LOAD_NO_CREDENTIAL

Het contract en/of de database UUID ontbreken in de IoT.

Controleer of beide waarden correct zijn geconfigureerd. Om ze bij te werken, open je de homepage van de IoT Box of de homepage van de virtuele Windows IoT, klik je op de knop (tandwielen) en vervolgens op 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

Het IoT-systeem is succesvol verbonden met https://www.odoo.com, maar de server weigerde het HTTPS-certificaat te verstrekken.

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