diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-19 17:39:49 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-19 17:39:49 +0000 |
commit | a0aa2307322cd47bbf416810ac0292925e03be87 (patch) | |
tree | 37076262a026c4b48c8a0e84f44ff9187556ca35 /rust/src/ntp/ntp.rs | |
parent | Initial commit. (diff) | |
download | suricata-a0aa2307322cd47bbf416810ac0292925e03be87.tar.xz suricata-a0aa2307322cd47bbf416810ac0292925e03be87.zip |
Adding upstream version 1:7.0.3.upstream/1%7.0.3
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'rust/src/ntp/ntp.rs')
-rw-r--r-- | rust/src/ntp/ntp.rs | 338 |
1 files changed, 338 insertions, 0 deletions
diff --git a/rust/src/ntp/ntp.rs b/rust/src/ntp/ntp.rs new file mode 100644 index 0000000..c7b3b3d --- /dev/null +++ b/rust/src/ntp/ntp.rs @@ -0,0 +1,338 @@ +/* Copyright (C) 2017-2021 Open Information Security Foundation + * + * You can copy, redistribute or modify this Program under the terms of + * the GNU General Public License version 2 as published by the Free + * Software Foundation. + * + * 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 General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * version 2 along with this program; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA + * 02110-1301, USA. + */ + +// written by Pierre Chifflier <chifflier@wzdftpd.net> + +extern crate ntp_parser; +use self::ntp_parser::*; +use crate::core; +use crate::core::{AppProto,Flow,ALPROTO_UNKNOWN,ALPROTO_FAILED,Direction}; +use crate::applayer::{self, *}; +use std; +use std::ffi::CString; + +use nom7::Err; + +#[derive(AppLayerEvent)] +pub enum NTPEvent { + UnsolicitedResponse , + MalformedData, + NotRequest, + NotResponse, +} + +#[derive(Default)] +pub struct NTPState { + state_data: AppLayerStateData, + + /// List of transactions for this session + transactions: Vec<NTPTransaction>, + + /// Events counter + events: u16, + + /// tx counter for assigning incrementing id's to tx's + tx_id: u64, +} + +#[derive(Debug, Default)] +pub struct NTPTransaction { + /// The NTP reference ID + pub xid: u32, + + /// The internal transaction id + id: u64, + + tx_data: applayer::AppLayerTxData, +} + +impl Transaction for NTPTransaction { + fn id(&self) -> u64 { + self.id + } +} + +impl NTPState { + pub fn new() -> Self { + Default::default() + } +} + +impl State<NTPTransaction> for NTPState { + fn get_transaction_count(&self) -> usize { + self.transactions.len() + } + + fn get_transaction_by_index(&self, index: usize) -> Option<&NTPTransaction> { + self.transactions.get(index) + } +} + +impl NTPState { + /// Parse an NTP request message + /// + /// Returns 0 if successful, or -1 on error + fn parse(&mut self, i: &[u8], direction: Direction) -> i32 { + match parse_ntp(i) { + Ok((_,ref msg)) => { + // SCLogDebug!("parse_ntp: {:?}",msg); + let (mode, ref_id) = match msg { + NtpPacket::V3(pkt) => (pkt.mode, pkt.ref_id), + NtpPacket::V4(pkt) => (pkt.mode, pkt.ref_id), + }; + if mode == NtpMode::SymmetricActive || mode == NtpMode::Client { + let mut tx = self.new_tx(direction); + // use the reference id as identifier + tx.xid = ref_id; + self.transactions.push(tx); + } + 0 + }, + Err(Err::Incomplete(_)) => { + SCLogDebug!("Insufficient data while parsing NTP data"); + self.set_event(NTPEvent::MalformedData); + -1 + }, + Err(_) => { + SCLogDebug!("Error while parsing NTP data"); + self.set_event(NTPEvent::MalformedData); + -1 + }, + } + } + + fn free(&mut self) { + // All transactions are freed when the `transactions` object is freed. + // But let's be explicit + self.transactions.clear(); + } + + fn new_tx(&mut self, direction: Direction) -> NTPTransaction { + self.tx_id += 1; + NTPTransaction::new(direction, self.tx_id) + } + + pub fn get_tx_by_id(&mut self, tx_id: u64) -> Option<&NTPTransaction> { + self.transactions.iter().find(|&tx| tx.id == tx_id + 1) + } + + fn free_tx(&mut self, tx_id: u64) { + let tx = self.transactions.iter().position(|tx| tx.id == tx_id + 1); + debug_assert!(tx.is_some()); + if let Some(idx) = tx { + let _ = self.transactions.remove(idx); + } + } + + /// Set an event. The event is set on the most recent transaction. + pub fn set_event(&mut self, event: NTPEvent) { + if let Some(tx) = self.transactions.last_mut() { + tx.tx_data.set_event(event as u8); + self.events += 1; + } + } +} + +impl NTPTransaction { + pub fn new(direction: Direction, id: u64) -> NTPTransaction { + NTPTransaction { + xid: 0, + id, + tx_data: applayer::AppLayerTxData::for_direction(direction), + } + } +} + +/// Returns *mut NTPState +#[no_mangle] +pub extern "C" fn rs_ntp_state_new(_orig_state: *mut std::os::raw::c_void, _orig_proto: AppProto) -> *mut std::os::raw::c_void { + let state = NTPState::new(); + let boxed = Box::new(state); + return Box::into_raw(boxed) as *mut _; +} + +/// Params: +/// - state: *mut NTPState as void pointer +#[no_mangle] +pub extern "C" fn rs_ntp_state_free(state: *mut std::os::raw::c_void) { + let mut ntp_state = unsafe{ Box::from_raw(state as *mut NTPState) }; + ntp_state.free(); +} + +#[no_mangle] +pub unsafe extern "C" fn rs_ntp_parse_request(_flow: *const core::Flow, + state: *mut std::os::raw::c_void, + _pstate: *mut std::os::raw::c_void, + stream_slice: StreamSlice, + _data: *const std::os::raw::c_void, + ) -> AppLayerResult { + let state = cast_pointer!(state,NTPState); + if state.parse(stream_slice.as_slice(), Direction::ToServer) < 0 { + return AppLayerResult::err(); + } + AppLayerResult::ok() +} + +#[no_mangle] +pub unsafe extern "C" fn rs_ntp_parse_response(_flow: *const core::Flow, + state: *mut std::os::raw::c_void, + _pstate: *mut std::os::raw::c_void, + stream_slice: StreamSlice, + _data: *const std::os::raw::c_void, + ) -> AppLayerResult { + let state = cast_pointer!(state,NTPState); + if state.parse(stream_slice.as_slice(), Direction::ToClient) < 0 { + return AppLayerResult::err(); + } + AppLayerResult::ok() +} + +#[no_mangle] +pub unsafe extern "C" fn rs_ntp_state_get_tx(state: *mut std::os::raw::c_void, + tx_id: u64) + -> *mut std::os::raw::c_void +{ + let state = cast_pointer!(state,NTPState); + match state.get_tx_by_id(tx_id) { + Some(tx) => tx as *const _ as *mut _, + None => std::ptr::null_mut(), + } +} + +#[no_mangle] +pub unsafe extern "C" fn rs_ntp_state_get_tx_count(state: *mut std::os::raw::c_void) + -> u64 +{ + let state = cast_pointer!(state,NTPState); + state.tx_id +} + +#[no_mangle] +pub unsafe extern "C" fn rs_ntp_state_tx_free(state: *mut std::os::raw::c_void, + tx_id: u64) +{ + let state = cast_pointer!(state,NTPState); + state.free_tx(tx_id); +} + +#[no_mangle] +pub extern "C" fn rs_ntp_tx_get_alstate_progress(_tx: *mut std::os::raw::c_void, + _direction: u8) + -> std::os::raw::c_int +{ + 1 +} + +static mut ALPROTO_NTP : AppProto = ALPROTO_UNKNOWN; + +#[no_mangle] +pub extern "C" fn ntp_probing_parser(_flow: *const Flow, + _direction: u8, + input:*const u8, input_len: u32, + _rdir: *mut u8) -> AppProto +{ + let slice: &[u8] = unsafe { std::slice::from_raw_parts(input as *mut u8, input_len as usize) }; + let alproto = unsafe{ ALPROTO_NTP }; + match parse_ntp(slice) { + Ok((_, _)) => { + // parse_ntp already checks for supported version (3 or 4) + return alproto; + }, + Err(Err::Incomplete(_)) => { + return ALPROTO_UNKNOWN; + }, + Err(_) => { + return unsafe{ALPROTO_FAILED}; + }, + } +} + +export_tx_data_get!(rs_ntp_get_tx_data, NTPTransaction); +export_state_data_get!(rs_ntp_get_state_data, NTPState); + +const PARSER_NAME : &[u8] = b"ntp\0"; + +#[no_mangle] +pub unsafe extern "C" fn rs_register_ntp_parser() { + let default_port = CString::new("123").unwrap(); + let parser = RustParser { + name : PARSER_NAME.as_ptr() as *const std::os::raw::c_char, + default_port : default_port.as_ptr(), + ipproto : core::IPPROTO_UDP, + probe_ts : Some(ntp_probing_parser), + probe_tc : Some(ntp_probing_parser), + min_depth : 0, + max_depth : 16, + state_new : rs_ntp_state_new, + state_free : rs_ntp_state_free, + tx_free : rs_ntp_state_tx_free, + parse_ts : rs_ntp_parse_request, + parse_tc : rs_ntp_parse_response, + get_tx_count : rs_ntp_state_get_tx_count, + get_tx : rs_ntp_state_get_tx, + tx_comp_st_ts : 1, + tx_comp_st_tc : 1, + tx_get_progress : rs_ntp_tx_get_alstate_progress, + get_eventinfo : Some(NTPEvent::get_event_info), + get_eventinfo_byid : Some(NTPEvent::get_event_info_by_id), + localstorage_new : None, + localstorage_free : None, + get_tx_files : None, + get_tx_iterator : Some(applayer::state_get_tx_iterator::<NTPState, NTPTransaction>), + get_tx_data : rs_ntp_get_tx_data, + get_state_data : rs_ntp_get_state_data, + apply_tx_config : None, + flags : 0, + truncate : None, + get_frame_id_by_name: None, + get_frame_name_by_id: None, + }; + + let ip_proto_str = CString::new("udp").unwrap(); + if AppLayerProtoDetectConfProtoDetectionEnabled(ip_proto_str.as_ptr(), parser.name) != 0 { + let alproto = AppLayerRegisterProtocolDetection(&parser, 1); + // store the allocated ID for the probe function + ALPROTO_NTP = alproto; + if AppLayerParserConfParserEnabled(ip_proto_str.as_ptr(), parser.name) != 0 { + let _ = AppLayerRegisterParser(&parser, alproto); + } + } else { + SCLogDebug!("Protocol detector and parser disabled for NTP."); + } +} + + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn test_ntp_parse_request_valid() { + // A UDP NTP v4 request, in client mode + const REQ : &[u8] = &[ + 0x23, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x18, 0x57, 0xab, 0xc3, 0x4a, 0x5f, 0x2c, 0xfe + ]; + + let mut state = NTPState::new(); + assert_eq!(0, state.parse(REQ, Direction::ToServer)); + } +} |