2023-04-04 14:27:23 +00:00
|
|
|
|
Import ssh keys for public key authentication
|
|
|
|
|
|
=============================================
|
|
|
|
|
|
|
|
|
|
|
|
[⬅️ Go back to main README](../../README.md)
|
|
|
|
|
|
|
|
|
|
|
|
> ℹ️️ **Info**: This module can not be used on its own but requires the base
|
|
|
|
|
|
> installation. See [main README](../../README.md) for details.
|
|
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
|
|
RouterOS supports ssh login with public key authentication. The functions
|
|
|
|
|
|
in this module help importing the keys.
|
|
|
|
|
|
|
|
|
|
|
|
Requirements and installation
|
|
|
|
|
|
-----------------------------
|
|
|
|
|
|
|
|
|
|
|
|
Just install the module:
|
|
|
|
|
|
|
|
|
|
|
|
$ScriptInstallUpdate mod/ssh-keys-import;
|
|
|
|
|
|
|
|
|
|
|
|
Usage and invocation
|
|
|
|
|
|
--------------------
|
|
|
|
|
|
|
|
|
|
|
|
### Import single key from terminal
|
|
|
|
|
|
|
|
|
|
|
|
Call the function `$SSHKeysImport` with key and user as parameter to
|
|
|
|
|
|
import that key:
|
|
|
|
|
|
|
2023-08-18 07:05:45 +00:00
|
|
|
|
$SSHKeysImport "ssh-rsa AAAAB3Nza...QYZk8= user" admin;
|
2023-04-04 14:27:23 +00:00
|
|
|
|
|
2023-08-18 07:00:54 +00:00
|
|
|
|
Starting with RouterOS *7.12beta1* support for keys of type `ed25519` has
|
|
|
|
|
|
been added:
|
|
|
|
|
|
|
|
|
|
|
|
$SSHKeysImport "ssh-ed25519 AAAAC3Nza...ZVugJT user" admin;
|
|
|
|
|
|
|
2023-04-04 14:27:23 +00:00
|
|
|
|
The third part of the key (`user` in this example) is inherited as
|
2023-11-02 08:46:25 +00:00
|
|
|
|
`key-owner` in RouterOS. Also the `MD5` fingerprint is recorded, this helps
|
|
|
|
|
|
to audit and verify the available keys.
|
|
|
|
|
|
|
|
|
|
|
|
> ℹ️️ **Info**: Use `ssh-keygen` to show a fingerprint of an existing public
|
|
|
|
|
|
> key file: `ssh-keygen -l -E md5 -f ~/.ssh/id_ed25519.pub`
|
2023-04-04 14:27:23 +00:00
|
|
|
|
|
|
|
|
|
|
### Import several keys from file
|
|
|
|
|
|
|
|
|
|
|
|
The functions `$SSHKeysImportFile` can read an `authorized_keys`-style file
|
|
|
|
|
|
and import all the keys. The user given to the function can be overwritting
|
|
|
|
|
|
from comments in the file. Create a file `keys.pub` with this content:
|
|
|
|
|
|
|
|
|
|
|
|
```
|
2023-08-18 07:00:54 +00:00
|
|
|
|
ssh-ed25519 AAAAC3Nza...3OcN8A user@client
|
2023-04-04 14:27:23 +00:00
|
|
|
|
ssh-rsa AAAAB3Nza...ozyts= worker@station
|
|
|
|
|
|
# user=example
|
|
|
|
|
|
ssh-rsa AAAAB3Nza...GXQVk= person@host
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Then import it with:
|
|
|
|
|
|
|
|
|
|
|
|
$SSHKeysImportFile keys.pub admin;
|
|
|
|
|
|
|
|
|
|
|
|
This will import the first two keys for user `admin` (as given to function)
|
|
|
|
|
|
and the third one for user `example` (as defined in comment).
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
[⬅️ Go back to main README](../../README.md)
|
|
|
|
|
|
[⬆️ Go back to top](#top)
|
