ssh-rs ✨

English | 简体中文

Rust implementation of ssh2.0 client.

If you encounter any problems in use, welcome issues or PR .

Content

• ssh-rs ✨
  • Content
  • Connection method：
  • 1. Password:
  • 2. Public key:
    • 1. Use key file path：
    • 2. Use key string：
    • 3. Use them together
  • Enable global logging：
  • Set timeout：
  • How to use：
  • Algorithm support：
  • 1. Kex algorithms
  • 2. Server host key algorithms
  • 3. Encryption algorithms (client to server)
  • 4. Encryption algorithms (server to client)
  • 5. Mac algorithms (client to server)
  • 6. Mac algorithms (server to client)
  • 7. Compression algorithms (client to server)
  • 8. Compression algorithms (server to client)
  • ☃️ Additional algorithms will continue to be added.

Connection method：

1. Password:

```rust use ssh;

let mut session = ssh::create_session() .username("ubuntu") .password("password") .connect("127.0.0.1:22") .unwrap(); ```

2. Public key:

• Currently, only RSA, ED25519 keys/key files are supported.

1. Use key file path：

``rust // pem format key path -> /xxx/xxx/id_rsa // the content of the keyfile shall begin with // -----BEGIN RSA PRIVATE KEY----- / -----BEGIN OPENSSH PRIVATE KEY----- // and end with // -----END RSA PRIVATE KEY----- / -----END OPENSSH PRIVATE KEY----- // simply generated byssh-keygen -t rsa -m PEM -b 4096` use ssh;

let mut session = ssh::createsession() .username("ubuntu") .privatekeypath("./idrsa") .connect("127.0.0.1:22") .unwrap(); ```

2. Use key string：

```rust // pem format key string: // -----BEGIN RSA PRIVATE KEY----- / -----BEGIN OPENSSH PRIVATE KEY----- // and end with // -----END RSA PRIVATE KEY----- / -----END OPENSSH PRIVATE KEY----- use ssh;

let mut session = ssh::createsession() .username("ubuntu") .privatekey("rsa_string") .connect("127.0.0.1:22") .unwrap(); ```

3. Use them together

• According to the implementation of OpenSSH, it will try public key first and fallback to password. So both of them can be provided.

```Rust use ssh;

let mut session = ssh::createsession() .username("username") .password("password") .privatekey_path("/path/to/rsa") .connect("127.0.0.1:22") .unwrap(); ```

Enable global logging：

• This crate now uses the log compatible tracing for logging functionality

```rust use tracing::Level; use tracing_subscriber::FmtSubscriber;

// this will generate some basic event logs // a builder for FmtSubscriber. let subscriber = FmtSubscriber::builder() // all spans/events with a level higher than INFO (e.g, info, warn, etc.) // will be written to stdout. .withmaxlevel(Level::INFO) // completes the builder. .finish();

tracing::subscriber::setglobaldefault(subscriber).expect("setting default subscriber failed"); ```

Set timeout：

• Only global timeouts per r/w are currently supported.

```rust use ssh;

let _listener = TcpListener::bind("127.0.0.1:7777").unwrap();

match ssh::createsession() .username("ubuntu") .password("password") .privatekeypath("./idrsa") .timeout(Some(std::time::Duration::from_secs(5))) .connect("127.0.0.1:7777") { Err(e) => println!("Got error {}", e), _ => unreachable!(), } ```

How to use：

• Examples can be found under examples

1. Execute a command
2. Scp files
3. Run a shell
4. Run an interactive shell
5. Connect ssh server w/o a tcp stream
6. Cofigure your own algorithm list

Algorithm support：

1. Kex algorithms

• curve25519-sha256
• ecdh-sha2-nistp256
• diffie-hellman-group14-sha256
• diffie-hellman-group14-sha1
• diffie-hellman-group1-sha1 (behind feature "deprecated-dh-group1-sha1")

2. Server host key algorithms

• ssh-ed25519
• rsa-sha2-256
• rsa-sha2-512
• rsa-sha (behind feature "deprecated-rsa-sha1")

3. Encryption algorithms

• chacha20-poly1305@openssh.com
• aes128-ctr
• aes192-ctr
• aes256-ctr
• aes128-cbc (behind feature "deprecated-aes-cbc")
• aes192-cbc (behind feature "deprecated-aes-cbc")
• aes256-cbc (behind feature "deprecated-aes-cbc")
• 3des-cbc (behind feature "deprecated-des-cbc")

4. Mac algorithms

• hmac-sha2-256
• hmac-sha2-512
• hmac-sha1

5. Compression algorithms

• none
• zlib@openssh.com
• zlib (behind feature "zlib")

☃️ Additional algorithms will continue to be added.