#server #oob-interactions #interactsh

interactsh-rs

A Rust client library for working with Interact.sh servers

7 releases

new 0.3.1 Apr 22, 2025
0.3.0 Jan 28, 2023
0.2.1 Nov 23, 2022
0.1.0 Nov 9, 2022
0.1.0-RC2 Oct 29, 2022

#736 in Cryptography

Download history 4/week @ 2025-02-25 3/week @ 2025-03-04

366 downloads per month

MIT/Apache

73KB
1.5K SLoC

Interactsh-rs

Maintenance Documentation Crates.io License Downloads CI Tests

A Rust client library for getting interaction logs from Interactsh servers. See a basic example below; check out the examples or the client module in the API docs for more detailed use.

!! 2025 MAINTENANCE STATUS UPDATE !!

Unfortunately, I no longer have the time nor motivation to upkeep this crate. If anyone would like to take up maintenance of this crate, please let me know and I will transfer ownership to you. Feel free to fork this crate as well. I do not recommend using this crate as is; the dependancies need to be updated and the crate itself honestly needs a rewrite (at the very least to be more generic over crypto implementations).

Basic Use Example

use std::time::Duration;
use std::thread;
use interactsh_rs::prelude::*;

async fn run_client() {
    // Builds an unregistered client
    let client = ClientBuilder::default()
        .with_server("oast.pro".into())
        .parse_logs(true)
        .build()
        .unwrap();

    // Registers the client with the server and
    // returns a registered client
    let client = client.register().await.unwrap();
    let interaction_fqdn = client.get_interaction_fqdn();
    println!("INTERACTION URL: https://{}", interaction_fqdn);

    // Start a poll loop
    loop {
        thread::sleep(Duration::from_secs(5));

        let logs = match client.poll().await.unwrap() {
            Some(logs) => logs,
            None => continue,
        };

        // ...Do something with the returned logs...
    }

    // Once done, deregister the client
    client.deregister().await.unwrap();
}

Dependencies

~8–23MB
~364K SLoC