Page tree
Skip to end of metadata
Go to start of metadata

When connecting to a device over SSH, Unimus supports the following SSH protocol-level authentication methods:

none, public-key, keyboard-interactive, password

Please note that depending on the actual type of credentials, only some of these authentication methods will be used (see below).

For most users, adjusting the default behavior is NOT required, but you can adjust how Unimus auths on the SSH level if needed.

Default SSH protocol-level authentication behavior

When connecting to a device using an SSH key-based credential, Unimus will try the following auth methods in the following order:

none, public-key

When using a username/password based credential, Unimus will try the following auth methods in the following order:

none, keyboard-interactive, password

Disabling auth none or changing password auth methods

If you would like to disable the "none" authentication method, you can set the following parameter:

-Dunimus.core.ssh.enable-auth-none=false

If you would like to change the order of password auth methods, you can set:

-Dunimus.core.ssh.preferred-password-authentication-methods=password,keyboard-interactive

Or you can remove one of the password auth methods to force usage of a specific one with:

-Dunimus.core.ssh.preferred-password-authentication-methods=keyboard-interactive

How to configure auth options

You can set configuration options in the service config files to achieve this.

On Linux these are located in:

  • "/etc/default/unimus" for Unimus Server
  • "/etc/default/unimus-core" for Unimus Core

On Windows:

  • "C:\Program Files\Unimus\Unimus.l4j.ini" for Unimus Server
  • "C:\Program Files\Unimus Core\Unimus Core.l4j.ini" for Unimus Core
  • No labels