Skip to main content

AsyncSSH: Asynchronous SSHv2 client and server library

Project description

AsyncSSH Overview

AsyncSSH is a Python package which provides an asynchronous client and server implementation of the SSHv2 protocol on top of the Python asyncio framework. It requires Python 3.4 or later and either the PyCA library or the PyCrypto library for some cryptographic functions.

This package is released under the following terms:

Copyright (c) 2013-2015 by Ron Frederick <ronf@timeheart.net>. All rights reserved.

This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution and is available at:

http://www.eclipse.org/legal/epl-v10.html

Contributors:

Ron Frederick - initial implementation, API, and documentation

Notable features include:

  • Written from the ground up to be based on Python 3

  • Support for a number of key exchange methods
    • Diffie Hellman group1 and group14 with SHA1

    • Diffie Hellman group exchange with SHA1 and SHA256

    • Elliptic Curve Diffie Hellman (nistp256, nistp384, and nistp521)

    • Curve25519, if libnacl or curve25519-donna is installed

  • Support for multiple authentication methods
    • Password, public key, and keyboard-interactive

  • Support for a variety of public key types and formats
    • DSA, RSA, and ECDSA

    • Ed25519, if libnacl is installed

    • PKCS#1/PKCS#8 DER and PEM, OpenSSH, and RFC4716 formats

    • PEM and PKCS#8 password-based private key encryption

    • OpenSSH private key encryption, if bcrypt is installed

  • Support for OpenSSH host and user certificates
    • Version 00 certificates for DSA and RSA keys

    • Version 01 certificates for DSA, RSA, ECDSA, and Ed25519 keys

    • Support for force-command and source-address critical options

    • Support for permit-pty and permit-port-forwarding extensions

  • Support for a variety of ciphers
    • AES, ARC4, Blowfish, CAST, and Triple DES via PyCA or PyCrypto

    • AES GCM as defined by OpenSSH

    • Chacha20-Poly1305 as defined by OpenSSH, if libnacl is installed

  • Support for a variety of MAC algorithms
    • HMAC with MD5, SHA1, SHA256, and SHA512

  • Support for gzip compression
    • Including OpenSSH variant to delay compression until after auth

  • Support for OpenSSH known_hosts files
    • Positive and negative wildcard and CIDR host patterns

    • Support for HMAC-SHA1 hashed entries

    • Support for @cert-authority and @revoked markers

  • Support for OpenSSH authorized_keys files
    • Support for cert-authority option to validate user certificates

    • Enforcement of from and principals options to restrict key matching

    • Enforcement of no-pty, no-port-forwarding, and permitopen options

    • Support for command and environment options

  • SFTP client and server support
    • SFTP protocol version 3 with OpenSSH extensions

    • Support for recursive transfers and glob matching

    • File I/O API to allow accessing remote files without downloading them

  • Support for passing environment variables, terminal type, and window size

  • Support for multiple simultaneous sessions on a single SSH connection

  • Support for handling multiple SSH connections in a single event loop

  • Support for direct and forwarded TCP/IP channels

  • Support for both byte and string based I/O with settable encoding

  • Compatibility with OpenSSH “Encrypt then MAC” option for better security

  • Time and byte-count based session key renegotiation

  • Designed to be easy to extend to support new forms of key exchange, authentication methods, ciphers, and compression algorithms

Prerequisites

To use asyncssh, you need the following:

  • Python 3.4 or later

  • PyCrypto 2.6 or later and/or PyCA 0.6.1 or later

Installation

  1. Install Python 3.4 or later from http://www.python.org or your favorite packaging system.

  2. Install PyCrypto 2.6 or later from http://www.pycrypto.org and/or PyCA 0.6.1 or later from https://cryptography.io to provide basic crypto support.

  3. Optionally install libsodium from https://github.com/jedisct1/libsodium and libnacl from https://github.com/saltstack/libnacl if you want support for Curve25519 Diffie-Hellman key exchange, Ed25519 keys, and the ChaCha20-Poly1305 cipher.

  4. Optionally install bcrypt from https://code.google.com/p/py-bcrypt if you want support for OpenSSH private key encryption.

  5. Install AsyncSSH by running:

    % pip install asyncssh
  6. Check out the examples to get started!

Mailing Lists

Three mailing lists are available for AsyncSSH:

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

asyncssh-1.1.1.tar.gz (119.6 kB view hashes)

Uploaded Source

Built Distribution

asyncssh-1.1.1-py3.4.egg (313.3 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page