Certificat HTTPS (IoT)

Hypertext Transfer Protocol Secure (HTTPS) est la version sécurisée et chiffrée du Hypertext Transfer Protocol (HTTP), qui est le protocole principal utilisé pour la communication de données entre un navigateur web et un site web. Il sécurise les communications en utilisant un protocole de chiffrement connu sous le nom de Transport Layer Security (TLS), précédemment appelé Secure Sockets Layer (SSL). La sécurité du HTTPS repose sur les certificats TLS /SSL, qui authentifient le fournisseur et vérifient son identité.

L’utilisation du HTTPS est requise pour communiquer avec certains appareils réseau, en particulier les terminaux de paiement. Si le certificat HTTPS n’est pas valide, certains appareils ne peuvent pas interagir avec le système IdO.

Note

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

Génération du certificat HTTPS

Le certificat HTTPS est généré automatiquement. Lorsque le système IdO est (re)démarré (par exemple, après sa connexion à la base de données Odoo), une requête est envoyée à https://www.odoo.com, qui retourne le certificat HTTPS si le système IdO et la base de données répondent aux critères d’éligibilité :

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

  • L’abonnement Odoo doit être en cours (statut En cours) et comporter une ligne d”abonnement boîte IdO.

Lorsque le certificat a été reçu :

  • L’adresse de la page d’accueil du système IdO est mise à jour vers une nouvelle URL HTTPS se terminant par .odoo-iot.com. Cliquer sur l’URL pour établir une connexion HTTPS sécurisée.

    IoT Box sur l'application IoT Odoo avec le domaine .odoo-iot.com.
  • La bannière Certificat HTTPS affiche la période de validité du certificat. Pour voir cette information, cliquer sur le bouton (roues dentées) sur la page d’accueil du système IdO.

    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 :

  • Aucun abonnement boîte IdO n’est lié à votre compte.

  • L”abonnement boîte IdO a été ajouté après la connexion du système IdO à la base de données. Dans ce cas, actualiser la page d’accueil du système IdO ou redémarrer/redémarrer le système IdO pour régénérer le certificat HTTPS.

  • 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

Un code d’erreur spécifique s’affiche sur la page d’accueil du système IdO si des problèmes surviennent lors de la génération ou de la réception du certificat HTTPS.

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

La configuration du serveur est manquante, c’est-à-dire que l’instance Odoo n’est pas connectée au système IdO.

ERR_IOT_HTTPS_CHECK_CERT_READ_EXCEPTION

Une erreur s’est produite lors de la tentative de lecture du certificat HTTPS existant. Vérifier que le fichier du certificat HTTPS est lisible.

ERR_IOT_HTTPS_LOAD_NO_CREDENTIAL

Le contrat et/ou l”UUID de la base de données est manquant dans l’IdO.

Vérifier que les deux valeurs sont correctement configurées. Pour les mettre à jour, accéder à la page d’accueil de la boîte IdO ou à la page d’accueil de l’IdO virtuel Windows, cliquer sur le bouton (roues dentées), puis cliquer sur 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

Le système IdO s’est connecté avec succès à https://www.odoo.com, mais le serveur a refusé de fournir le certificat HTTPS.

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