gluon/docs/user/authentication.rst
Frieder Grießhammer 9615415308 using a three way split to divide seperate topics covered,
rephrasing passages, fixing syntax
2015-01-05 13:07:48 +01:00

41 lines
1.5 KiB
ReStructuredText

SSH Authentication
==================
The methods described here can also be configured via :doc:`/features/configmode`.
Telnet access is only possible when booting into safe-mode. How boot into safe-mode
is explained in the `openwrt wiki <http://wiki.openwrt.org/de/doc/howto/generic.failsafe>`_.
SSH login will be possible after the start of dropbear, which is regularly performed
when running in normal mode.
Adding a password
-----------------
Setting a password for any user on the Nodes - especially for root - is *not encouraged*.
It comes handy, though, especially when logging in from via a remote machine that
does not have your own SSH private key, e.g. directly from a gateway machine.
But passwords are always too short or too easy to guess/brutforce and therefore
mostly insecure. Always consider using SSH public keys.
If setting a password via :doc:`/features/configmode` was disabled for security reasons, please:
* boot into failsafe-mode
* telnet the node on ``192.168.1.1``
* when connected::
$ mount_root
$ passwd
For users other than root, please perform as you would do with any other Linux machine.
Adding SSH public keys
----------------------
If it is not possible to set a SSH public key via :doc:`/features/configmode`, you
may use a temporary password or use the safe-mode to append your key to ``/etc/dropbear/authorized_keys``
manually.
.. seealso:: For Information how to add SSH public keys to the images while compiling see :doc:`/features/authorized-keys`