Skip to content

Commit

Permalink
[IMP] POS: add info for iOS devices
Browse files Browse the repository at this point in the history
task-3388561

closes #5761

Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
  • Loading branch information
LoredanaLrpz authored and xpl-odoo committed Sep 29, 2023
1 parent 8253b6f commit 895d30c
Show file tree
Hide file tree
Showing 2 changed files with 97 additions and 2 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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.
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 895d30c

Please sign in to comment.