[IMP] POS: add info for iOS devices

task-3388561

closes odoo/documentation#5944

X-original-commit: 895d30cceb
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
This commit is contained in:
Loredana Perazzo 2023-09-06 11:06:57 +02:00 committed by Xavier (XPL)
parent 3a10fb4ea3
commit d8706cdd89
2 changed files with 97 additions and 2 deletions

View File

@ -176,13 +176,83 @@ it into your browser.
.. tab:: Mac OS
To secure the connection on a Mac:
On Mac OS, you can secure the connection for all browsers by following these steps:
#. open Safari and navigate to your printer's IP address. Doing so leads to a warning page;
#. on the warning page, go to :menuselection:`Show Details --> visit this website --> Visit
Website`, validate;
#. reboot the printer so you can use it with any other browser.
To generate and export an SSL certificate and send it to IOS devices, open **Google Chrome**
or **Mozilla Firefox**. Then,
.. tabs::
.. tab:: Generate a self-signed certificate
Navigate to the ePOS' IP address (e.g., `https://192.168.1.25`) and force the
connection by clicking :guilabel:`Advanced` and :guilabel:`Proceed to [IP address]
(unsafe)`.
.. figure:: epos_ssc/browser-https-insecure.png
:scale: 75%
:alt: Warning page about the connection privacy on Google Chrome
Warning page on Google Chrome, Windows 10
Then, sign in using your printer credentials to access the ePOS printer settings. To
sign in, enter `epson` in the :guilabel:`ID` field and your printer serial number in the
:guilabel:`Password` field.
Click :guilabel:`Certificate List` in the :guilabel:`Authentication` section, and click
:guilabel:`create` to generate a new **Self-Signed Certificate**. The :guilabel:`Common
Name` should be automatically filled out. If not, fill it in with the printer IP address
number. Select the years the certificate will be valid in the :guilabel:`Validity
Period` field, click :guilabel:`Create`, and :guilabel:`Reset` or manually restart the
printer.
The self-signed certificate is generated. Reload the page and click :guilabel:`SSL/TLS`
in the :guilabel:`Security` section to ensure **Selfsigned Certificate** is correctly
selected in the :guilabel:`Server Certificate` section.
.. tab:: Export a self-signed certificate
The export process is heavily dependent on the :abbr:`OS (Operating System)` and the
browser. Start by accessing your ePOS printer settings on your web browser by navigating
to its IP address (e.g., `https://192.168.1.25`). Then, force the connection as
explained in the **Generate a self-signed certificate tab**.
If you are using **Google Chrome**,
#. click :guilabel:`Not secure` next to the search bar, and :guilabel:`Certificate is
not valid`;
.. image:: epos_ssc/browser-warning.png
:alt: Connection to the printer not secure button in Google Chrome
#. go to the :guilabel:`Details` tab and click :guilabel:`Export`;
#. add `.crt` at the end of the file name to ensure it has the correct extension;
#. select :guilabel:`Base64-encoded ASCII, single certificate`, at the bottom of the
pop-up window;
#. save, and the certificate is exported.
.. warning::
Make sure that the certificate ends with the extension `.crt`. Otherwise, some
browsers might not find the file during the import process.
If you are using **Mozilla Firefox**,
#. click the **lock-shaped** icon on the left of the address bar;
#. go to :menuselection:`Connection not secure --> More information --> Security tab
--> View certificate`;
.. image:: epos_ssc/mozilla-not-secure.png
:alt: Connection is not secure button in Mozilla Firefox
#. scroll down to the :guilabel:`Miscellaneous` section;
#. click :guilabel:`PEM (cert)` in the :guilabel:`Download` section;
#. save, and the certificate is exported.
.. tab:: Android OS
To import an SSL certificate into an Android device, first create and export it from a
@ -197,8 +267,33 @@ it into your browser.
The specific steps for installing a certificate may vary depending on the version of
Android and the device manufacturer.
.. important::
.. tab:: iOS
To import an SSL certificate into an iOS device, first create and export it from a computer.
Then, transfer the `.crt` file to the device using email, Bluetooth, or any file-sharing
service.
Downloading this file triggers a warning pop-up window. Click :guilabel:`Allow` to download
the configuration profile, and close the second pop-up window. Then,
#. go to the **Settings App** on the iOS device;
#. click :guilabel:`Profile Downloaded` under the user's details box;
#. locate the downloaded `.crt` file and select it;
#. click :guilabel:`Install` on the top right of the screen;
#. if a passcode is set on the device, enter the passcode;
#. click :guilabel:`Install` on the top right of the certificate warning screen and the pop-up
window;
#. click :guilabel:`Done`.
.. image:: epos_ssc/ssl-ios-verified.png
The certificate is installed, but it still needs to be authenticated. To do so,
#. go to :menuselection:`Settings --> General --> About > Certificate Trust Settings`;
#. enable the installed certificate using the **slide button**;
#. click :guilabel:`Continue` on the pop-up window.
.. important::
- If you need to export SSL certificates from an operating system or web browser that has not
been mentioned, search for `export SSL certificate` + `the name of your browser or operating
system` in your preferred search engine.

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB