[ADD] point_of_sale: self-signed certificate for epos printers

Add documentation to explain how to use a ePos printer in HTTPS

closes odoo/documentation#1223

Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
This commit is contained in:
lejeune quentin 2021-10-26 09:53:38 +00:00 committed by Jonathan Castillo (jcs)
parent 0fdfb740fb
commit f8f93ec288
5 changed files with 96 additions and 1 deletions

View File

@ -10,3 +10,4 @@ Overview
overview/getting_started
overview/register
overview/https
overview/epos_ssc

View File

@ -0,0 +1,91 @@
=========================================
Self-signed certificate for ePOS printers
=========================================
ePos printers are designed specifically to work with your Point of Sale system, which sends the
tickets directly to the printer.
Some models don't require an IoT box, but the connection between your web browser and the printer
may require a :doc:`secure connection with the HTTPS protocol <https>`. If so, a self-signed
certificate is necessary to use your printer.
.. note::
Please check the following list of compatible `Epson ePOS printers
<https://c4b.epson-biz.com/modules/community/index.php?content_id=91>`_. This list includes the
following models:
- TM-H6000IV-DT (Receipt printer only)
- TM-T70II-DT
- TM-T88V-DT
- TM-L90-i
- TM-T20II-i
- TM-T70-i
- TM-T82II-i
- TM-T83II-i
- TM-T88V-i
- TM-U220-i
- TM-m10
- TM-m30
- TM-P20 (Wi-Fi® model)
- TM-P60II (Receipt: Wi-Fi® model)
- TM-P60II (Peeler: Wi-Fi® model)
- TM-P80 (Wi-Fi® model)
Generate a Self-signed certificate
==================================
Access your ePOS printer's settings with your web browser by navigating to its IP address, for
example, `http://192.168.1.25`.
.. note::
- The printer automatically prints the IP address during startup.
- We recommend assigning a **fixed IP address** to the printer from the network router.
Go to :menuselection:`Authentication --> Certificate List` and create a new **Self-Signed
Certificate**.
- **Common Name**: the IP address of the ePos Printer, for example, `192.168.1.25`
- **Validity Period**: `10`
Create and reboot the printer, go to :menuselection:`Security --> SSL/TLS`, and check if
**Selfsigned Certificate** is selected.
Export the Self-signed certificate
==================================
To avoid having to accept the self-signed certificate several times, you can export it and then
import it to your web browser or mobile device.
To do so, access your ePOS printer's settings with your web browser by navigating to its IP address,
for example, `https://192.168.1.25`. Then, accept the self-signed certificate.
.. note::
Note that the protocol is now **HTTPS**.
Click on :menuselection:`Not secure --> Certificate is not valid`.
.. image:: epos_ssc/browser-warning.png
:align: center
:alt: The web browser indicates that the connection to the printer is not secure.
Go to the *Details* tab and click on **Export**.
.. image:: epos_ssc/certificate-details.png
:align: center
:alt: Details of the ePOS printer certificate
Import the Self-signed certificate to your browser (Chrome)
===========================================================
In your Chrome browser, go to :menuselection:`Settings --> Privacy and security --> Security -->
Manage certificates`, then open the *Authorities* tab, click on **Import**, and select all
functionalities of the certificate.
.. tip::
You can directly access these settings by navigating to `chrome://settings/certificates`.
Import the Self-signed certificate to your Android device
=========================================================
On your Android device, open the settings and search for *certificate*. Then, click on **Certificate
AC** (Install from device storage), and select the certificate.

Binary file not shown.

After

Width:  |  Height:  |  Size: 17 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

View File

@ -16,4 +16,7 @@ Technical --> Parameters --> System Parameters`, then create a new parameter, ad
values and click on *Save*.
- **Key**: `point_of_sale.enforce_https`
- **Value**: `True`
- **Value**: `True`
.. seealso::
- :doc:`epos_ssc`