/* * mCaptcha - A proof of work based DoS protection system * Copyright © 2021 Aravinth Manivannan * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License as * published by the Free Software Foundation, either version 3 of the * License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Affero General Public License for more details. * * You should have received a copy of the GNU Affero General Public License * along with this program. If not, see . */ //! Cache is used to save proofof work details and nonces to prevent replay attacks //! and rainbow/dictionary attacks use serde::{Deserialize, Serialize}; #[cfg(feature = "full")] pub mod hashcache; #[cfg(feature = "full")] pub mod redis; #[derive(Serialize, Deserialize)] pub struct AddChallenge { pub difficulty: u32, pub duration: u64, pub challenge: String, } /// Describes actor handler trait impls that are required by a cache implementation #[cfg(feature = "full")] pub trait Save: actix::Actor + actix::Handler + actix::Handler + actix::Handler + actix::Handler + actix::Handler + actix::Handler { } #[cfg(feature = "full")] pub mod messages { //! Messages that can be sent to cache data structures implementing [Save][super::Save] use actix::dev::*; use derive_builder::Builder; use serde::{Deserialize, Serialize}; use tokio::sync::oneshot::Receiver; use crate::errors::*; /// Message to cache PoW difficulty factor and string #[derive(Message, Serialize, Deserialize, Builder, Clone)] #[rtype(result = "Receiver>")] pub struct CachePoW { /// challenge string pub string: String, /// Difficulty factor of mCaptcha at the time of minting this config pub difficulty_factor: u32, /// mCaptcha TTL pub duration: u64, /// Key is mCaptcha name pub key: String, } /// Message to retrive the the difficulty factor for the specified /// string from the cache #[derive(Message)] #[rtype(result = "Receiver>>")] pub struct RetrivePoW(pub VerifyCaptchaResult); #[derive(Clone, PartialEq, Debug, Default, Deserialize, Serialize)] pub struct CachedPoWConfig { /// mCaptcha name pub key: String, pub difficulty_factor: u32, pub duration: u64, } /// Message to delete cached PoW difficulty factor and string /// when they expire #[derive(Message)] #[rtype(result = "CaptchaResult<()>")] pub struct DeletePoW(pub String); /// Message to cache captcha result and the captcha key for which /// it was generated #[derive(Message, Serialize, Deserialize, Builder)] #[rtype(result = "Receiver>")] pub struct CacheResult { pub token: String, /// key is mCaptcha identifier pub key: String, pub duration: u64, } impl From for CacheResult { fn from(c: CachedPoWConfig) -> Self { use crate::utils::get_random; CacheResultBuilder::default() .key(c.key) .duration(c.duration) .token(get_random(32)) .build() .unwrap() } } /// Message to verify captcha result against /// the stored captcha key #[derive(Message, Clone, Deserialize, Serialize)] #[rtype(result = "Receiver>")] pub struct VerifyCaptchaResult { pub token: String, pub key: String, } /// Message to delete cached capthca result when it expires #[derive(Message)] #[rtype(result = "CaptchaResult<()>")] pub struct DeleteCaptchaResult { pub token: String, } }