summaryrefslogtreecommitdiff
path: root/docs/configuration/service
diff options
context:
space:
mode:
authorRobert Göhler <github@ghlr.de>2021-06-23 20:54:36 +0200
committerGitHub <noreply@github.com>2021-06-23 20:54:36 +0200
commit719a6de07cf509871b607e35fa1e3f83bec54f34 (patch)
tree30808ec990a5272bb07463748b53170e027128ae /docs/configuration/service
parent48c9f47f2ad498c725db466ebaac31dc6a2e71a9 (diff)
parent248ef1c6635ddb1af4834811b40f0c56744e8e09 (diff)
downloadvyos-documentation-719a6de07cf509871b607e35fa1e3f83bec54f34.tar.gz
vyos-documentation-719a6de07cf509871b607e35fa1e3f83bec54f34.zip
Merge branch 'master' into automation-doc-scripts
Diffstat (limited to 'docs/configuration/service')
-rw-r--r--docs/configuration/service/ssh.rst30
1 files changed, 30 insertions, 0 deletions
diff --git a/docs/configuration/service/ssh.rst b/docs/configuration/service/ssh.rst
index 6b09d40d..40ec62f5 100644
--- a/docs/configuration/service/ssh.rst
+++ b/docs/configuration/service/ssh.rst
@@ -156,3 +156,33 @@ Operation
Two new files ``/config/auth/id_rsa_rpki`` and
``/config/auth/id_rsa_rpki.pub``
will be created.
+
+.. opcmd:: generate public-key-commands name <username> path <location>
+
+ Generate the configuration mode commands to add a public key for
+ :ref:`ssh_key_based_authentication`.
+ ``<location>`` can be a local path or a URL pointing at a remote file.
+
+ Supported remote protocols are FTP, HTTP, HTTPS, SCP/SFTP and TFTP.
+
+ Example:
+
+ .. code-block:: none
+
+ alyssa@vyos:~$ generate public-key-commands name alyssa path sftp://example.net/home/alyssa/.ssh/id_rsa.pub
+ # To add this key as an embedded key, run the following commands:
+ configure
+ set system login user alyssa authentication public-keys alyssa@example.net key AAA...
+ set system login user alyssa authentication public-keys alyssa@example.net type ssh-rsa
+ commit
+ save
+ exit
+
+ ben@vyos:~$ generate public-key-command user ben path ~/.ssh/id_rsa.pub
+ # To add this key as an embedded key, run the following commands:
+ configure
+ set system login user ben authentication public-keys ben@vyos key AAA...
+ set system login user ben authentication public-keys ben@vyos type ssh-dss
+ commit
+ save
+ exit