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

Catatan

Dalam dokumentasi ini dan di seluruh Odoo, istilah sertifikat HTTPS merujuk pada sertifikat SSL yang valid yang memungkinkan koneksi 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:

  • Database harus merupakan instance produksi. Instance database tidak boleh berupa salinan, duplikat, staging, atau lingkungan pengembangan.

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

Ketika sertifikat telah diterima:

  • 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 with .odoo-iot.com domain.
  • The HTTPS certificate banner displays the certificate's validity period. To view this information, click the (cogs) button on the IoT system's homepage.

    Halaman utama IoT box dengan tanggal validitas sertifikat HTTPS.

Masalah dan error pembuatan sertifikat HTTPS

Sertifikat HTTPS tidak dibuat

Penyebab potensial meliputi hal-hal berikut:

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

  • Firewall mencegah sertifikat HTTPS dibuat dengan benar. Dalam hal ini, nonaktifkan firewall hingga sertifikat berhasil dibuat.

    Catatan

    Beberapa perangkat, seperti router dengan firewall bawaan, dapat mencegah sertifikat HTTPS dibuat.

Halaman utama sistem IoT dapat diakses menggunakan alamat IP tetapi tidak menggunakan URL xxx.odoo-iot.com

Hubungi administrator sistem atau jaringan Anda untuk mengatasi masalah ini. Masalah terkait jaringan berada di luar cakupan layanan dukungan Odoo.

  • Jika router memungkinkan konfigurasi DNS manual, perbarui pengaturan untuk menggunakan Google DNS.

  • Jika router tidak mendukung ini, Anda perlu memperbarui pengaturan DNS secara langsung pada setiap perangkat yang berinteraksi dengan sistem IoT untuk menggunakan Google DNS. Instruksi untuk mengonfigurasi DNS pada perangkat individual dapat ditemukan di situs web produsen masing-masing.

Catatan

  • Beberapa perangkat IoT, seperti terminal pembayaran, kemungkinan tidak memerlukan perubahan DNS, karena biasanya sudah dikonfigurasi sebelumnya dengan pengaturan DNS khusus.

  • Pada beberapa browser, kode error yang menyebutkan DNS (seperti DNS_PROBE_FINISHED_NXDOMAIN) ditampilkan.

Error

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

Saat Anda mengakses halaman beranda sistem IoT, secara otomatis dilakukan pemeriksaan sertifikat HTTPS dan upaya untuk menghasilkannya jika tidak ada. Jika muncul error, muat ulang halaman untuk melihat apakah masalah tersebut teratasi.

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

Terjadi error yang tidak terduga saat sistem IoT mencoba menjangkau https://www.odoo.com. Hal ini kemungkinan disebabkan oleh masalah terkait jaringan, seperti:

  • Sistem IoT tidak memiliki akses Internet.

  • Pembatasan jaringan (mis., firewall atau VPN) mencegah komunikasi dengan https://www.odoo.com.

Catatan

  • Untuk mengakses detail exception permintaan lengkap dengan informasi terkait error, aktifkan mode pengembang, klik kartu sistem IoT di aplikasi IoT, dan klik Download logs pada formulir sistem IoT. Untuk menentukan level log yang dicatat dalam file log sistem IoT, akses halaman beranda IoT box atau Windows virtual IoT, klik tombol (cogs), kemudian Log level di bagian bawah halaman.

  • Untuk mengatasi masalah terkait jaringan, hubungi administrator sistem atau jaringan Anda; masalah ini berada di luar cakupan layanan dukungan Odoo.

ERR_IOT_HTTPS_LOAD_REQUEST_STATUS

Sistem IoT berhasil menjangkau https://www.odoo.com tetapi menerima respons HTTP (kode status) yang tidak terduga.

Kode error ini mencakup status HTTP. Misalnya, ERR_IOT_HTTPS_LOAD_REQUEST_STATUS 404 berarti server mengembalikan respons "Halaman Tidak Ditemukan".

Untuk mengatasi masalah ini:

  1. Buka https://www.odoo.com di browser web untuk memeriksa apakah situs web sedang down sementara untuk pemeliharaan.

  2. Jika https://www.odoo.com sedang down untuk pemeliharaan, tunggu hingga kembali aktif.
    Jika situs web beroperasi, buka tiket dukungan dan pastikan untuk menyertakan kode status HTTPS 3 digit dalam tiket.

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.

Periksa bahwa sistem IoT dan database memenuhi persyaratan kelayakan untuk sertifikat HTTPS.