From 61bd4d04522cddf0166dd270f47dd18c0ef12cb2 Mon Sep 17 00:00:00 2001 From: erkin Date: Sun, 20 Jun 2021 20:16:57 +0300 Subject: Deprecate `loadkey` --- docs/configuration/service/ssh.rst | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) (limited to 'docs/configuration/service') diff --git a/docs/configuration/service/ssh.rst b/docs/configuration/service/ssh.rst index 6b09d40d..dc382b67 100644 --- a/docs/configuration/service/ssh.rst +++ b/docs/configuration/service/ssh.rst @@ -156,3 +156,32 @@ 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 path + + Generate the configuration mode commands to add a public key for + :ref:`ssh_key_based_authentication`. + `` 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 -- cgit v1.2.3 From 6f5dad1978811601f5219f6856f11b994dde301d Mon Sep 17 00:00:00 2001 From: erkin Date: Sun, 20 Jun 2021 20:23:53 +0300 Subject: ssh: Fix formatting --- docs/configuration/service/ssh.rst | 3 ++- docs/configuration/system/login.rst | 2 +- 2 files changed, 3 insertions(+), 2 deletions(-) (limited to 'docs/configuration/service') diff --git a/docs/configuration/service/ssh.rst b/docs/configuration/service/ssh.rst index dc382b67..40ec62f5 100644 --- a/docs/configuration/service/ssh.rst +++ b/docs/configuration/service/ssh.rst @@ -161,7 +161,8 @@ Operation Generate the configuration mode commands to add a public key for :ref:`ssh_key_based_authentication`. - `` can be a local path or a URL pointing at a remote file. + ```` 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: diff --git a/docs/configuration/system/login.rst b/docs/configuration/system/login.rst index 784e4f3e..09b6e68b 100644 --- a/docs/configuration/system/login.rst +++ b/docs/configuration/system/login.rst @@ -78,7 +78,7 @@ The third part is simply an identifier, and is for your own reference. **Deprecation notice:** ``loadkey`` has been deprecated in favour of :opcmd:`generate public-key-commands` and will be removed in a future - version. See :ref:`ssh:operation`. + version. See :ref:`ssh`. SSH keys can not only be specified on the command-line but also loaded for a given user with `` from a file pointed to by `.` Keys -- cgit v1.2.3