starla-controller

Handles communication with the RIPE Atlas controller infrastructure.

Features

SSH Tunnel Management: Secure connection to RIPE Atlas controllers using russh
Registration Protocol: INIT/KEEP command handling for probe registration
Telnet Interface: Receives measurement commands from the controller
Reverse Port Forwarding: Allows controller to send commands back to the probe

Components

SSH Connection

Manages the SSH tunnel to RIPE Atlas registration and controller servers:

use starla_controller::{SshConnection, SshConfig, KnownHosts, generate_key};

// Generate or load SSH key
let key = generate_key()?;

// Load known host keys (TOFU verification)
let known_hosts = KnownHosts::load(Path::new("data/known_hosts"));

// Connect to registration servers
let ssh = SshConnection::connect_to_servers(
    &["reg03.atlas.ripe.net:443", "reg04.atlas.ripe.net:443"],
    &key,
    SshConfig::default(),
    known_hosts,
).await?;

Telnet Server

Receives and parses measurement commands:

use starla_controller::{TelnetServer, TelnetCommand};

let server = TelnetServer::new(2023, probe_id);
// Commands are parsed into TelnetCommand variants:
// - Ping, Traceroute, Dns, Http, Tls, Ntp
// - Stop, Status

Protocol

The crate implements the RIPE Atlas probe protocol: