Difference between revisions of "Manual:IP/SSH"

From MikroTik Wiki
Jump to: navigation, search
(Settings)
(Settings)
Line 7: Line 7:
  
 
==Settings==
 
==Settings==
{| cellpadding="2"
 
!width="300px" style="background:#cccccc; border-bottom:1px solid gray;"| Property
 
!width="450px" style="background:#cccccc; border-bottom:1px solid gray;"| Desciption
 
|-
 
|style="border-bottom:1px solid gray;" valign="top"|'''forwarding-enabled''' ''(no|yes default:no)''
 
|style="border-bottom:1px solid gray;" valign="top"|controls ssh port forwarding
 
|-
 
|style="border-bottom:1px solid gray;" valign="top"|'''always-allow-password-login''' ''(no|yes default:no)''
 
|style="border-bottom:1px solid gray;" valign="top"|controls ssh authentication methods, if set to yes, does not remove form allowed methods password_login
 
|-
 
|style="border-bottom:1px solid gray;" valign="top"|'''export-host-key'''
 
|style="border-bottom:1px solid gray;" valign="top"|exports router private RSA and DSA key
 
|-
 
|style="border-bottom:1px solid gray;" valign="top"|'''import-host-key'''
 
|style="border-bottom:1px solid gray;" valign="top"|replace DSA or RSA with key provided for import. Be aware that previously imported ssh keys might stop working after key change.
 
|-
 
|style="border-bottom:1px solid gray;" valign="top"|'''regenerate-host-key'''
 
|style="border-bottom:1px solid gray;" valign="top"|generated new set of private keys (DSA and RSA) on the router and replaces current ones in use. Be aware that previously imported ssh keys might stop working after key change.
 
|-
 
|style="border-bottom:1px solid gray;" valign="top"|'''strong-crypto''' ''(no|yes default:no)''
 
|style="border-bottom:1px solid gray;" valign="top"| Introduces following changes in ssh configuration:
 
* prefer 256 and 192 bit encryption instead of 128 bits
 
* disable null encryption
 
* prefer sha256 for hashing instead of sha1
 
* disable md5
 
* use 2048bit prime for Diffie Hellman exchange instead of 1024bit
 
  
|}
+
 
 +
{{Mr-arg-table-h
 +
|prop=Property
 +
|desc=Description
 +
}}
 +
 
 +
{{Mr-arg-table
 +
|arg=allow-none-crypto
 +
|type=yes{{!}}no
 +
|default=yes
 +
|desc=Whether to allow connection if cryptographic algorithms are set to none.
 +
}}
 +
 
 +
{{Mr-arg-table
 +
|arg=always-allow-password-login
 +
|type=yes {{!}} no
 +
|default=no
 +
|desc=Whether to allow password login at the same time when public key authorization is configured.
 +
}}
 +
 
 +
{{Mr-arg-table
 +
|arg=forwarding-enabled
 +
|type=both {{!}} local {{!}} no {{!}} remote
 +
|default=remote
 +
|desc=Allows to control which SSH forwarding method to allow:
 +
* <var>no</var> - SSH forwarding is disabled;
 +
* <var>local</var> - Allow SSH clients to originate connections from the server;
 +
* <var>remote</var> - Allow SSH clients to listen on the server and forward incoming connections;
 +
* <var>both</var> - Allow both local and remote forwarding methods.
 +
}}
 +
 
 +
 
 +
{{Mr-arg-table
 +
|arg=host-key-size
 +
|type=yes {{!}} no
 +
|default=no
 +
|desc=What RSA key size to use when host key is being regenerate regenerated.
 +
}}
 +
 
 +
{{Mr-arg-table-end
 +
|arg=strong-crypto
 +
|type=yes {{!}} no
 +
|default=no
 +
|desc=Use stronger encryption, HMAC algorithms, use bigger DH primes and disallow weaker ones:
 +
* prefer 256 and 192 bit encryption instead of 128 bits;
 +
* disable null encryption;
 +
* prefer sha256 for hashing instead of sha1;
 +
* disable md5;
 +
* use 2048bit prime for Diffie Hellman exchange instead of 1024bit.
 +
}}
 +
 
 +
'''Commands'''
 +
 
 +
{{Mr-arg-table-h
 +
|prop=Property
 +
|desc=Description
 +
}}
 +
 
 +
{{Mr-arg-ro-table
 +
|arg=export-host-key
 +
|type=key-file-prefix
 +
|desc=Export public and private RSA/DSA keys to files. Command takes one parameter:
 +
* '''key-file-prefix''' - used prefix for generated files, for example, prefix 'my' will generate files 'my_rsa', 'my_rsa.pub' etc.
 +
}}
 +
 
 +
{{Mr-arg-ro-table
 +
|arg=import-host-key
 +
|type=private-key-file
 +
|desc=Import and replace private DSA/RSA key from specified file. Command takes one parameter:
 +
* '''private-key-file''' - name of the private RSA/DSA key file
 +
}}
 +
 
 +
{{Mr-arg-ro-table-end
 +
|arg=regenerate-host-key
 +
|type=
 +
|desc=Generated new and replace current set of private keys (DSA, RSA) on the router. Be aware that previously imported keys might stop working.
 +
}}
  
  

Revision as of 10:30, 9 April 2019

Version.png

Applies to RouterOS: v5

Summary

This menu controls if ssh server behaviour regarding port forward and authentication methods.

Settings

Property Description
allow-none-crypto (yes|no; Default: yes) Whether to allow connection if cryptographic algorithms are set to none.
always-allow-password-login (yes | no; Default: no) Whether to allow password login at the same time when public key authorization is configured.
forwarding-enabled (both | local | no | remote; Default: remote) Allows to control which SSH forwarding method to allow:
  • no - SSH forwarding is disabled;
  • local - Allow SSH clients to originate connections from the server;
  • remote - Allow SSH clients to listen on the server and forward incoming connections;
  • both - Allow both local and remote forwarding methods.
host-key-size (yes | no; Default: no) What RSA key size to use when host key is being regenerate regenerated.
strong-crypto (yes | no; Default: no) Use stronger encryption, HMAC algorithms, use bigger DH primes and disallow weaker ones:
  • prefer 256 and 192 bit encryption instead of 128 bits;
  • disable null encryption;
  • prefer sha256 for hashing instead of sha1;
  • disable md5;
  • use 2048bit prime for Diffie Hellman exchange instead of 1024bit.

Commands

Property Description
export-host-key (key-file-prefix) Export public and private RSA/DSA keys to files. Command takes one parameter:
  • key-file-prefix - used prefix for generated files, for example, prefix 'my' will generate files 'my_rsa', 'my_rsa.pub' etc.
import-host-key (private-key-file) Import and replace private DSA/RSA key from specified file. Command takes one parameter:
  • private-key-file - name of the private RSA/DSA key file
regenerate-host-key () Generated new and replace current set of private keys (DSA, RSA) on the router. Be aware that previously imported keys might stop working.


Icon-note.png

Note: When connecting from RouterOS built in client to router with strong crypto disabled, temporary strong crypto must be disabled on connecting router too. Reason is that strong crypto forces algorithms which are not supported when this feature is disabled.


Example

To use forwarding-enabled feature from Linux host using OpenSSH client this command can be used:

 ssh reamoteuser@remotehost -L port:remotehost:remoteport

where:

  • remoteuser - user of router
  • remotehost - router address (if host name is used in -L settings, router should be able to resolve this name)
  • port - local port that your host will listen on
  • remoteport - port on the router

If user requires telnet to router, but you do not want to allow it to be plain text, Following can be done:

ssh admin@192.168.88.1 -L 3000:192.168.88.1:23

now when user uses telnet localhost 3000" it will log in the router using telnet over encrypted tcp connection.

Icon-note.png

Note: we fully support SFTP v3 as described in draft-ietf-secsh-filexfer-02.txt other versions can cause problems