Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (testpypi.python.org).
Help us improve Python packaging - Donate today!

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-2014 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
  • 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:

Release History

Release History

This version
History Node

1.0.0

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
asyncssh-1.0.0-py3.4.egg (253.9 kB) Copy SHA256 Checksum SHA256 3.4 Egg Apr 11, 2015
asyncssh-1.0.0.tar.gz (96.9 kB) Copy SHA256 Checksum SHA256 Source Apr 11, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting