7f711c6ef2
Restructure and update the iot documentation
closes odoo/documentation#11934
X-original-commit: a6dbcd0a9f
Signed-off-by: Audrey Vandromme (auva) <auva@odoo.com>
36 lines
1.4 KiB
ReStructuredText
36 lines
1.4 KiB
ReStructuredText
======================
|
|
IoT box SSH connection
|
|
======================
|
|
|
|
.. note::
|
|
SSH connections are only available for :doc:`IoT boxes <../iot_box>`, not the :doc:`Windows
|
|
virtual IoT <../windows_iot>`.
|
|
|
|
.. warning::
|
|
- This feature should **only** be used with trusted parties, as it provides administrative
|
|
access to the IoT box, which can create security issues.
|
|
- Managing an SSH connection is **not** covered under the standard Odoo support scope. Visit
|
|
the `Odoo Support <https://www.odoo.com/help>`_ page for additional information about what is
|
|
covered.
|
|
|
|
To provide an :abbr:`SSH (secure shell protocol)` connection to an IoT box, you must generate a
|
|
password:
|
|
|
|
#. Access the IoT box's homepage by opening the IoT app and clicking the IP address displayed
|
|
on the IoT box's card.
|
|
#. Click the :icon:`fa-cogs` (:guilabel:`cogs`) button at the top-right, then :guilabel:`Remote
|
|
Debug`.
|
|
#. In the :guilabel:`Remote Debugging` popup that opens, click :guilabel:`Generate` and save the
|
|
password securely. Once you close the popup, the password will no longer be available.
|
|
|
|
.. image:: ssh_connect/ssh-generate-password.png
|
|
:alt: The Remote Debugging password generation window.
|
|
|
|
#. Enter the :guilabel:`Authentication Token` provided by the user attempting to connect to the IoT
|
|
box.
|
|
#. Click :guilabel:`Enable Remote Debugging`.
|
|
|
|
.. seealso::
|
|
- :doc:`../iot_box`
|
|
- :doc:`../connect`
|