2021-11-04 13:10:41 +00:00
|
|
|
//! # peach-web
|
|
|
|
//!
|
|
|
|
//! `peach-web` provides a web interface for monitoring and interacting with the
|
|
|
|
//! PeachCloud device. This allows administration of the single-board computer
|
|
|
|
//! (ie. Raspberry Pi) running PeachCloud, as well as the ssb-server and related
|
|
|
|
//! plugins.
|
|
|
|
//!
|
|
|
|
//! ## Design
|
|
|
|
//!
|
|
|
|
//! `peach-web` is written primarily in Rust and presents a web interface for
|
|
|
|
//! interacting with the device. The stack currently consists of Rocket (Rust
|
|
|
|
//! web framework), Tera (Rust template engine inspired by Jinja2 and the Django
|
|
|
|
//! template language), HTML, CSS and JavaScript. Additional functionality is
|
|
|
|
//! provided by JSON-RPC clients for the `peach-network` and `peach-stats`
|
|
|
|
//! microservices.
|
|
|
|
//!
|
|
|
|
//! HTML is rendered server-side. Request handlers call JSON-RPC microservices
|
|
|
|
//! and serve HTML and assets. A JSON API is exposed for remote calls and
|
|
|
|
//! dynamic client-side content updates via vanilla JavaScript following
|
2021-11-04 21:30:29 +00:00
|
|
|
//! unobstructive design principles. Each Tera template is passed a context
|
2021-11-04 13:10:41 +00:00
|
|
|
//! object. In the case of Rust, this object is a `struct` and must implement
|
|
|
|
//! `Serialize`. The fields of the context object are available in the context
|
|
|
|
//! of the template to be rendered.
|
2021-08-06 17:58:40 +00:00
|
|
|
|
2021-11-04 13:10:41 +00:00
|
|
|
#![feature(proc_macro_hygiene, decl_macro)]
|
2021-08-06 17:58:40 +00:00
|
|
|
|
2021-11-04 13:10:41 +00:00
|
|
|
pub mod error;
|
|
|
|
pub mod routes;
|
|
|
|
#[cfg(test)]
|
|
|
|
mod tests;
|
|
|
|
pub mod utils;
|
2021-08-06 17:58:40 +00:00
|
|
|
|
2021-11-04 21:39:40 +00:00
|
|
|
use log::{info, error};
|
|
|
|
use std::process;
|
2021-11-04 13:10:41 +00:00
|
|
|
|
|
|
|
use rocket::{catchers, routes, Rocket, Build, fs::FileServer};
|
|
|
|
use rocket_dyn_templates::Template;
|
|
|
|
|
|
|
|
use crate::routes::authentication::*;
|
|
|
|
use crate::routes::device::*;
|
2021-11-08 14:00:27 +00:00
|
|
|
use crate::routes::catchers::*;
|
2021-11-04 13:10:41 +00:00
|
|
|
use crate::routes::index::*;
|
|
|
|
use crate::routes::ping::*;
|
|
|
|
use crate::routes::scuttlebutt::*;
|
|
|
|
|
|
|
|
use crate::routes::settings::admin::*;
|
|
|
|
use crate::routes::settings::dns::*;
|
|
|
|
use crate::routes::settings::network::*;
|
2021-11-04 21:39:40 +00:00
|
|
|
|
2021-11-04 13:10:41 +00:00
|
|
|
|
|
|
|
pub type BoxError = Box<dyn std::error::Error>;
|
|
|
|
|
|
|
|
/// Create rocket instance & mount all routes.
|
|
|
|
fn init_rocket() -> Rocket<Build> {
|
|
|
|
rocket::build()
|
|
|
|
.mount(
|
|
|
|
"/",
|
|
|
|
routes![
|
|
|
|
add_credentials, // WEB ROUTE
|
|
|
|
connect_wifi, // WEB ROUTE
|
|
|
|
disconnect_wifi, // WEB ROUTE
|
|
|
|
deploy_ap, // WEB ROUTE
|
|
|
|
deploy_client, // WEB ROUTE
|
|
|
|
device_stats, // WEB ROUTE
|
|
|
|
forget_wifi, // WEB ROUTE
|
|
|
|
help, // WEB ROUTE
|
|
|
|
index, // WEB ROUTE
|
|
|
|
login, // WEB ROUTE
|
2021-11-08 14:00:27 +00:00
|
|
|
login_post, // WEB ROUTE
|
2021-11-04 13:10:41 +00:00
|
|
|
logout, // WEB ROUTE
|
|
|
|
messages, // WEB ROUTE
|
|
|
|
network_home, // WEB ROUTE
|
|
|
|
network_add_ssid, // WEB ROUTE
|
|
|
|
network_add_wifi, // WEB ROUTE
|
|
|
|
network_detail, // WEB ROUTE
|
|
|
|
peers, // WEB ROUTE
|
|
|
|
profile, // WEB ROUTE
|
|
|
|
reboot_cmd, // WEB ROUTE
|
|
|
|
shutdown_cmd, // WEB ROUTE
|
|
|
|
shutdown_menu, // WEB ROUTE
|
|
|
|
wifi_list, // WEB ROUTE
|
|
|
|
wifi_password, // WEB ROUTE
|
|
|
|
wifi_set_password, // WEB ROUTE
|
|
|
|
wifi_usage, // WEB ROUTE
|
|
|
|
wifi_usage_alerts, // WEB ROUTE
|
|
|
|
wifi_usage_reset, // WEB ROUTE
|
|
|
|
configure_dns, // WEB ROUTE
|
|
|
|
configure_dns_post, // WEB ROUTE
|
|
|
|
change_password, // WEB ROUTE
|
|
|
|
reset_password, // WEB ROUTE
|
|
|
|
reset_password_post, // WEB ROUTE
|
|
|
|
send_password_reset_page, // WEB ROUTE
|
|
|
|
send_password_reset_post, // WEB ROUTE
|
|
|
|
configure_admin, // WEB ROUTE
|
|
|
|
add_admin, // WEB ROUTE
|
|
|
|
add_admin_post, // WEB ROUTE
|
|
|
|
delete_admin_post, // WEB ROUTE
|
|
|
|
activate_ap, // JSON API
|
|
|
|
activate_client, // JSON API
|
|
|
|
add_wifi, // JSON API
|
|
|
|
connect_ap, // JSON API
|
|
|
|
disconnect_ap, // JSON API
|
|
|
|
forget_ap, // JSON API
|
|
|
|
modify_password, // JSON API
|
|
|
|
ping_pong, // JSON API
|
|
|
|
ping_network, // JSON API
|
|
|
|
ping_oled, // JSON API
|
|
|
|
ping_stats, // JSON API
|
|
|
|
reset_data_total, // JSON API
|
|
|
|
return_ip, // JSON API
|
|
|
|
return_rssi, // JSON API
|
|
|
|
return_ssid, // JSON API
|
|
|
|
return_state, // JSON API
|
|
|
|
return_status, // JSON API
|
|
|
|
reboot_device, // JSON API
|
|
|
|
scan_networks, // JSON API
|
|
|
|
shutdown_device, // JSON API
|
|
|
|
update_wifi_alerts, // JSON API
|
|
|
|
save_dns_configuration_endpoint, // JSON API
|
|
|
|
save_password_form_endpoint, // JSON API
|
|
|
|
reset_password_form_endpoint, // JSON API
|
|
|
|
],
|
|
|
|
)
|
|
|
|
.mount("/", FileServer::from("static"))
|
2021-11-08 14:00:27 +00:00
|
|
|
.register("/", catchers![not_found, internal_error, forbidden])
|
2021-11-04 13:10:41 +00:00
|
|
|
.attach(Template::fairing())
|
|
|
|
}
|
|
|
|
|
|
|
|
/// Launch the peach-web rocket server.
|
|
|
|
#[rocket::main]
|
|
|
|
async fn main() {
|
|
|
|
|
|
|
|
// initialize logger
|
2021-08-06 17:58:40 +00:00
|
|
|
env_logger::init();
|
|
|
|
|
2021-11-04 21:30:29 +00:00
|
|
|
// initialize rocket
|
2021-11-04 13:10:41 +00:00
|
|
|
info!("Initializing Rocket");
|
|
|
|
let rocket = init_rocket();
|
|
|
|
|
2021-11-04 21:30:29 +00:00
|
|
|
// launch rocket
|
2021-11-04 13:10:41 +00:00
|
|
|
info!("Launching Rocket");
|
2021-11-04 21:39:40 +00:00
|
|
|
if let Err(e) = rocket.launch().await {
|
|
|
|
error!("Error in Rocket application: {}", e);
|
|
|
|
process::exit(1);
|
|
|
|
}
|
2021-08-06 17:58:40 +00:00
|
|
|
}
|