Skip to content

Latest commit

 

History

History
100 lines (78 loc) · 7.54 KB

RELEASE_NOTES.md

File metadata and controls

100 lines (78 loc) · 7.54 KB
Raw

Features

  • Staring with 1.3.0 release, RadSSH has dropped support for all versions of Python2. Users who still require Python2 runtime should install version 1.1.2. Version 1.3.0 requires Python 3.5 or greater, and Paramiko 2.7.0 or greater, as its new minimum system requirements.

  • Added support for ed25519 keys for user authentication (1.3.0)

  • Windows platform is now supported as of 1.1.2

  • Plugins can now supply custom console formatters. Set config option to "." to enable it within radssh.shell. See formatter.py for examples. (Thanks to Mark Kelly for inspiration) [ Added in 1.1.2 ]

  • New plugin: *cd to mimic a persistent change of current working directory [ Added in 1.1.2 ]

  • New module for host key handling and validation, closer to the functionality of OpenSSH. Significantly improved performance when operating with very large known_hosts files.

  • Now relies on standard OpenSSH config file settings for options related to connection, host key validation, and user authentiction. Many, but not all options are supported.

    Connection Options Supported

    Hostname, Port, LogLevel, ConnectTimeout, Ciphers, KexAlgorithms, Macs, ProxyCommand, LocalCommand, PermitLocalCommand

    Hostkey Validation Options Supported

    GlobalKnownHostsFile, UserKnownHostsFile, StrictHostKeyChecking, HostKeyAlias, HostKeyAlgorithms, HashKnownHosts, CheckHostIP

    User Authentication Options Supported

    User, PreferredAuthentications, KbdInteractiveAuthentiction, PasswordAuthentication, PubkeyAuthentication, NumberOfPasswordPrompts, IdentityFile, IdentitiesOnly, BatchMode

  • Added support for ECDSA key files for user authentication.

  • Now supports for Paramiko version 2.0, and cryptography.io. Installations using Paramiko 1.X can continue to be used along with the unmaintained PyCrypto module.

  • Improved support for specifying explicit port and username with URI style formatting (user@host:port).

Issues Fixed

  • #49 Runtime information no longer calls platform.linux_distribution() which was removed from the standard library. Now it will use distro.linux_distribution(), if available, or just platform.platform() if distro module is not available.
  • #48 -
  • #45 Ctrl-C in the time window between input parsing and command invocation is handled gracefully (1.3.0)
  • #47 Fix TypeError under Python3 in regular expression filtering (1.3.0) [Eduardo Orochena]
  • A missing plugins directory is no longer a fatal runtime error.
  • StreamBuffer closing is no longer vulnerable to Queue.Full exception.
  • Fix thread contention issue when prompting user for passwords and accepting new host keys concurrently.
  • Ordered output mode fixed under Python3. [ Fixed in 1.1.1 ]
  • Improve behavior when connection is dropped by server during authentication. [ Fixed in 1.1.1 ]
  • Fix CPU usage when using *tty (#25 Thanks to Mark Kelly for report & fix) [ Fixed in 1.1.2 ]
  • Fix crash during saving of session command history (#32 Thanks to Russell Wagner for report)

Enhancements

  • New configuration option auto_tty to enable launching directly into *tty mode when the connected cluster consists of a single host. [Mark Kelly] (1.3.0)

  • New configuration option ordered_placeholder to control whether or not "[No Output]" is printed for ordered output when the command for that host contained no output. [Mark Kelly] (1.3.0)

  • Dropped support for RSA-1 entries in known_hosts file. This format has not been supported by OpenSSH for quite some time.

  • Reworded user prompt when encountering a restricted command.

  • Command result summary explicitly lists return codes and hosts when any host returns a non-zero status.

  • Formerly deprecated configuration options are now categorized as "obsolete", since attempts to use them are ignored.

  • New "obsolete" configuration options, and their corresponding SSH Config option names:

    Obsolete RadSSH Option Current SSH Option
    hostkey.verify StrictHostKeyChecking
    hostkey.known_hosts UserKnownHostsFile
    ssh_identity IdentityFile
    ssh_agent IdentitiesOnly

  • Added new config option ssh_config to allow overriding the default location of the user SSH Config file (~/.ssh/config).

  • ~/.ssh directory will be created at startup, if it does not exist. [ Fixed in 1.1.2 ]

  • Added new config option show_altered_commands (default: off)

Plugin Enhancements

  • Plugin loading will now update plugin settings from the user configuration file prior to calling the plugin's init() function. (1.3.0)
  • *cd allows conifgutation settings for initial curr_dir (default: ~) and new option paths allowing dynamic appending to the remote side $PATH environment variable prior to command execution. [Mark Kelly] (1.3.0)
  • *tty allows configuration setting for the time delay value, via plugin.star_tty.prompt_delay. Default value updated to 5 seconds [Inspired by Mark Kelly] (1.3.0)
  • *tty allows configuration setting for plugin.star_tty.rc_file, specifying a filename with commands to invoke at the start of a *tty session, similar to having commands in a .bashrc file. [ Mark Kelly] (1.3.0)
  • Console formatter will safely revert back to one of the built-in formatters, if the specified plugin fails to load. (1.3.0)
  • Sample formatter ansi256_rj fixed call for Python3
  • *enable now includes explicit count of hosts when all hosts enabled.
  • *drop with no arguments will now drop hosts that are not connected/authenticated.
  • *add now handles URI style (user@host:port) format; lists summary of connections added to cluster.
  • Now supports shell alias definitions with escaped single quotes are supported.
  • *result can include > and >> to save/append to local file [ Added in 1.1.1 ]
  • *history added to alias plugin, with support for !nnn replay of command by history number [ Added in 1.1.1 ]
  • *tty should no longer be prone to "Resource temporarily unavailable" exceptions. [ Fixed in 1.1.1 ]
  • *sftp now silently ignores chown errors

API Changes

  • hostkey module will be removed in 2.0 release in favor of the new known_hosts module.
  • AuthManager will no longer support parameters include_agent or include_userkeys. Settings are now controlled by the OpenSSH configuration options.

Known Issues

  • Paramiko ProxyCommand may not function correctly under Python3 (paramiko/paramiko#673)
  • Ability to mix & match hostnames and IP addresses leads to many sorting issues under Python3 (#21) [ Fixed in 1.1.1 ]

Additional Notes

  • PyCrypto identified as an unmaintained module. Paramiko 2.0 has transitioned to using cryptography. RadSSH usage will prefer to use cryptography, but will continue to work with PyCrypto and Paramiko 1.X. Installations are strongly recommended to upgrade to using cryptography (and Paramiko 2.0) from PyCrypto. When RadSSH is unable to load the preferred cryptography module and reverts to using PyCrypto, a warning will be issued encouraging users to install cryptography.
  • Paramiko library does not include support for OpenSSH configuration Match blocks, so currently these are not supported for RadSSH configuration options as well.
  • Python 2.6 and Python 3.2 will continue to be supported by RadSSH 1.1.0, even though these Python versions are no longer being actively maintained. Future releases of RadSSH may not continue focus or effort on compatibility with these python versions.