diff --git a/content/applications/sales/point_of_sale/configuration/epos_ssc.rst b/content/applications/sales/point_of_sale/configuration/epos_ssc.rst index b2df96b9e..fec926c78 100644 --- a/content/applications/sales/point_of_sale/configuration/epos_ssc.rst +++ b/content/applications/sales/point_of_sale/configuration/epos_ssc.rst @@ -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. diff --git a/content/applications/sales/point_of_sale/configuration/epos_ssc/ssl-ios-verified.png b/content/applications/sales/point_of_sale/configuration/epos_ssc/ssl-ios-verified.png new file mode 100644 index 000000000..15710fa1e Binary files /dev/null and b/content/applications/sales/point_of_sale/configuration/epos_ssc/ssl-ios-verified.png differ