Certificat HTTPS (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.

Note

Dans cette documentation et dans Odoo, le terme certificat HTTPS désigne un certificat SSL valide qui permet une connexion HTTPS.

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:

  • La base de données doit être une instance de production. Elle ne doit pas être une copie, un duplicata, un environnement de staging ou de développement.

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

Lorsque le certificat a été reçu :

  • 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.

    IoT Box sur l'application IoT Odoo avec le domaine .odoo-iot.com.

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

    Page d'accueil de l'IoT box avec la date de validité du certificat HTTPS.

Problèmes et erreurs de génération du certificat HTTPS

Le certificat HTTPS ne se génère pas

Les causes potentielles incluent les suivantes :

  • 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.

  • Le pare-feu empêche le certificat HTTPS de se générer correctement. Dans ce cas, désactiver le pare-feu jusqu’à ce que le certificat soit généré avec succès.

    Note

    Certains appareils, tels que les routeurs avec pare-feu intégré, peuvent empêcher le certificat HTTPS de se générer.

La page d’accueil du système IoT est accessible via son adresse IP mais pas via l’URL xxx.odoo-iot.com

Contacter votre administrateur système ou réseau pour résoudre le problème. Les problèmes liés au réseau sont hors du champ des services de support Odoo.

  • Si le routeur autorise la configuration manuelle de DNS, mettre à jour les paramètres pour utiliser Google DNS.

  • Si le routeur ne prend pas en charge cette fonctionnalité, il faut mettre à jour les paramètres DNS directement sur chaque appareil qui interagit avec le système IoT pour utiliser Google DNS. Les instructions pour configurer le DNS sur des appareils individuels sont disponibles sur le site web du fabricant concerné.

Note

  • Certains appareils IoT, tels que les terminaux de paiement, ne nécessitent probablement pas de modifications DNS, car ils sont généralement préconfigurés avec des paramètres DNS personnalisés.

  • Sur certains navigateurs, un code d’erreur mentionnant le DNS (tel que DNS_PROBE_FINISHED_NXDOMAIN) s’affiche.

Erreurs

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.

Astuce

Lorsque vous accédez à la page d’accueil du système IoT, celui-ci vérifie automatiquement la présence d’un certificat HTTPS et tente d’en générer un s’il est manquant. Si une erreur apparaît, actualiser la page pour voir si le problème est résolu.

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

Une erreur inattendue s’est produite lorsque le système IoT a tenté d’atteindre https://www.odoo.com. Cela est probablement dû à des problèmes liés au réseau, tels que :

  • Le système IoT n’a pas accès à Internet.

  • Des restrictions réseau (par exemple, pare-feu ou VPN) empêchent la communication avec https://www.odoo.com.

Note

  • Pour accéder aux détails complets de l’exception de requête avec des informations concernant l’erreur, activer le mode développeur, cliquer sur la carte du système IoT dans l’application IoT, puis cliquer sur Télécharger les logs dans le formulaire du système IoT. Pour définir les niveaux de log enregistrés dans le fichier journal du système IoT, accéder à la page d’accueil de l’IoT box ou de l’IoT virtuel Windows, cliquer sur le bouton (engrenages), puis sur Niveau de log en bas de la page.

  • Pour résoudre les problèmes liés au réseau, contacter votre administrateur système ou réseau ; ces problèmes ne relèvent pas des services de support Odoo.

ERR_IOT_HTTPS_LOAD_REQUEST_STATUS

Le système IoT a atteint https://www.odoo.com avec succès mais a reçu une réponse HTTP inattendue (codes d’état).

Ce code d’erreur inclut le statut HTTP. Par exemple, ERR_IOT_HTTPS_LOAD_REQUEST_STATUS 404 signifie que le serveur a renvoyé une réponse « Page introuvable ».

Pour résoudre ce problème :

  1. Ouvrir https://www.odoo.com dans un navigateur web pour vérifier si le site web est temporairement en maintenance.

  2. Si https://www.odoo.com est en maintenance, attendre qu’il soit de nouveau disponible.
    Si le site web est opérationnel, ouvrir un ticket de support en veillant à inclure le code d’état HTTPS à 3 chiffres dans le 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.

Vérifier que le système IoT et la base de données répondent aux critères d’éligibilité pour un certificat HTTPS.