#ssh #tunnel #async

ssh_jumper_model

Async SSH tunnel through a jump host (data types)

5 releases (3 breaking)

0.4.0 Sep 5, 2021
0.3.0 Sep 2, 2021
0.2.0 Jun 12, 2021
0.1.1 Mar 25, 2021
0.1.0 Mar 13, 2021

#50 in #tunnel

Download history 90/week @ 2024-03-11 40/week @ 2024-03-18 108/week @ 2024-03-25 84/week @ 2024-04-01 59/week @ 2024-04-08 33/week @ 2024-04-15 124/week @ 2024-04-22 26/week @ 2024-04-29 33/week @ 2024-05-06 25/week @ 2024-05-13 56/week @ 2024-05-20 44/week @ 2024-05-27 27/week @ 2024-06-03 67/week @ 2024-06-10 22/week @ 2024-06-17 18/week @ 2024-06-24

134 downloads per month
Used in 4 crates (via ssh_jumper)

MIT/Apache

14KB
246 lines

🌐💨 SSH Jumper

Crates.io docs.rs CI Coverage Status

Async SSH tunnel through a jump host.

use std::borrow::Cow;
use ssh_jumper::{
    model::{HostAddress, HostSocketParams, JumpHostAuthParams, SshTunnelParams},
    SshJumper
};

// Similar to running:
// ssh -i ~/.ssh/id_rsa -L 1234:target_host:8080 my_user@bastion.com
let (local_socket_addr, ssh_forwarder_end_rx) = {
    let jump_host = HostAddress::HostName(Cow::Borrowed("bastion.com"));
    let jump_host_auth_params = JumpHostAuthParams::new(
        Cow::Borrowed("my_user"),
        Cow::Borrowed(Path::new("~/.ssh/id_rsa")),
    );
    let target_socket = HostSocketParams {
        address: HostAddress::HostName(Cow::Borrowed("target_host")),
        port: 8080,
    };
    let ssh_params =
        SshTunnelParams::new(jump_host, jump_host_auth_params, target_socket)
            // Optional: OS will allocate a port if this is left out
            .with_local_port(1234);

    SshJumper::open_tunnel(&ssh_params).await?
};

// Now you can send traffic to `local_socket_addr`, and it will go to `target_host`.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~15–30MB
~446K SLoC