HTTPS certificate (IoT)¶
What is HTTPS?¶
Hypertext Transfer Protocol Secure (HTTPS) is the secure version of Hypertext Transfer Protocol (HTTP), which is the primary protocol used to send data back and forth between a web browser and a website. HTTPS is encrypted in order to increase the security of data transfer.
HTTPS uses an encryption protocol to encrypt communications. The protocol is called Transport Layer Security (TLS), although formerly it was known as Secure Sockets Layer (SSL).
HTTPS occurs based upon the transmission of TLS/SSL certificates, which verify that a particular provider is who they say they are.
In this documentation and throughout CoquiAPPs the term “HTTPS certificate” will be used to define the fact that the SSL certificate is valid and allows a HTTPS connection.
Why is it needed?¶
In order to communicate with certain network devices (in particular for payment terminals), the usage of HTTPS is mandatory. If the HTTPS certificate isn’t valid, some devices won’t be able to interact with the IoT Box.
How to obtain a Hypertext Transfer Protocol Secure (HTTPS) certificate¶
The generation of the HTTPS certificate is automatic.
The IoT Box will send a specific request to https://coqui.cloud which will send back the HTTPS certificate if the IoT box and database are eligible.
Internet of Things (IoT) eligibility¶
The database should be a production instance. The database instance should not be a copy, a duplicate, a staging, or a development environment.
The CoquiAPPs subscription must:
Have an IoT Box Subscription line.
Status must be In Progress.
If the subscription is linked to a https://coqui.cloud portal user check the information on the portal subscription page.
If the subscription is in question, contact the database’s Account Manager or Partner regarding the matter.
Troubleshooting Hypertext Transfer Protocol Secure (HTTPS) certificate errors¶
If anything goes wrong during the process of the “HTTPS certificate” generation or reception, a specific error will code be given on the IoT box home page.
Accessing the IoT box homepage will check for the presence of the “HTTPS certificate” and will attempt its generation if it is missing. As such, if there is an error on the IoT box home page, refresh the IoT home page to see if the error disappears.
The configuration regarding the server is missing. In other words, the CoquiAPPs instance is not connected with the IoT box.
Ensure that the server is configured.
An unhandled error happened when trying to read the existing HTTPS certificate.
Ensure that the HTTPS certificate file is readable.
The contract and/or database UUID is missing.
Ensure that both values are configured as intended. To modify them, go to the IoT box home page, and navigate to Credential.
An unexpected error happened when the IoT box tried to reach https://coqui.cloud. The causes are likely due to the network infrastructure/configuration:
The IoT box does not have access to internet.
The network does not allow the IoT box to communicate with https://coqui.cloud. This may be due to network devices preventing the communication (firewalls, etc.) or the network configuration (VPN, etc.).
More information regarding the error that occurred can be found in the full request exception details, which are in the IoT box logs.
Consult with your system or network administrator should this issue arise. This error code depends on the network infrastructure and goes beyond CoquiAPPs support’s service scope.
This error code will also give the HTTP response status codes. For example, if the error reads
ERR_IOT_HTTPS_LOAD_REQUEST_STATUS 404it means that the page returned a 404 error, which is the “Page Not Found” code.
Check if https://coqui.cloud is down using a web browser, as it’s possible that it is down due to maintenance.
If https://coqui.cloud is down due to maintenance, unfortunately there is nothing that can be done but instead wait for it to recover.
How to ensure that the HTTPS certificate is correct¶
If the certificate has been applied successfully, a new HTTPS URL for the IoT box ending
.CoquiAPPs-iot.com will appear on the CoquiAPPs database, inside of the
application on that specific device’s form.
When navigating to the URL in a browser a secured HTTPS connection will be established.
The IoT-box homepage will now display an
OK status next to
HTTPS certificate. The
drop-down menu icon, when clicked, will reveal information regarding the certificate.
Domain Name System (DNS) issue¶
If the IoT box can be accessed from its IP
address but not the CoquiAPPs assigned domain:
.CoquiAPPs-iot.com; then the IoT
box is likely running into a DNS issue. On some browsers, it will give
an error code mentioning DNS (like
These DNS issues may appear as the following in different browsers:
Domain Name System (DNS) issue solution¶
Should the router allow the DNS to be manually changed, change the DNS to use Google DNS.
If your router doesn’t allow for this, then a change will need to be made on the DNS settings of each of the devices using Google DNS. This will need to occur on every device that plans to interact with the IoT box (e.g. computer, tablet or phone). The individual device configuration processes can be found on the website of the device’s manufacturer.
Other IoT devices such as payment terminals likely won’t need their DNS settings changed as they are already configured with custom DNS.
Consult with your system or network administrator should this issue arise. This error code depends on the network infrastructure, and it goes beyond CoquiAPPs support’s service scope.