• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

OISF / suricata / 22553492142

01 Mar 2026 09:48PM UTC coverage: 70.74% (-2.9%) from 73.687%
22553492142

Pull #14920

github

web-flow
Merge e15a765bc into 90823fa90
Pull Request #14920: draft: rust based configuration file parser and loader - v4

38209 of 77306 branches covered (49.43%)

Branch coverage included in aggregate %.

533 of 779 new or added lines in 5 files covered. (68.42%)

11924 existing lines in 491 files now uncovered.

252429 of 333548 relevant lines covered (75.68%)

2403268.06 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

90.73
/rust/src/ssh/ssh.rs
1
/* Copyright (C) 2020-2025 Open Information Security Foundation
2
 *
3
 * You can copy, redistribute or modify this Program under the terms of
4
 * the GNU General Public License version 2 as published by the Free
5
 * Software Foundation.
6
 *
7
 * This program is distributed in the hope that it will be useful,
8
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
9
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
10
 * GNU General Public License for more details.
11
 *
12
 * You should have received a copy of the GNU General Public License
13
 * version 2 along with this program; if not, write to the Free Software
14
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
15
 * 02110-1301, USA.
16
 */
17

18
use super::parser;
19
use crate::applayer::*;
20
use crate::core::*;
21
use crate::direction::Direction;
22
use crate::encryption::EncryptionHandling;
23
use crate::flow::Flow;
24
use crate::frames::Frame;
25
use nom8::Err;
26
use std::ffi::CString;
27
use std::sync::atomic::{AtomicBool, Ordering};
28
use suricata_sys::sys::{
29
    AppLayerParserState, AppProto, SCAppLayerParserConfParserEnabled,
30
    SCAppLayerParserRegisterLogger, SCAppLayerParserStateSetFlag,
31
    SCAppLayerProtoDetectConfProtoDetectionEnabled,
32
};
33

34
pub(super) static mut ALPROTO_SSH: AppProto = ALPROTO_UNKNOWN;
35
static HASSH_ENABLED: AtomicBool = AtomicBool::new(false);
36
static HASSH_DISABLED: AtomicBool = AtomicBool::new(false);
37

38
static mut ENCRYPTION_BYPASS_ENABLED: EncryptionHandling =
39
    EncryptionHandling::ENCRYPTION_HANDLING_TRACK_ONLY;
40

41
fn hassh_is_enabled() -> bool {
139✔
42
    HASSH_ENABLED.load(Ordering::Relaxed)
139✔
43
}
139✔
44

45
fn encryption_bypass_mode() -> EncryptionHandling {
21✔
46
    unsafe { ENCRYPTION_BYPASS_ENABLED }
21✔
47
}
21✔
48

49
#[derive(AppLayerFrameType)]
50
pub enum SshFrameType {
51
    RecordHdr,
52
    RecordData,
53
    RecordPdu,
54
}
55

56
#[derive(AppLayerEvent)]
33✔
57
pub enum SSHEvent {
58
    InvalidBanner,
59
    LongBanner,
60
    InvalidRecord,
61
    LongKexRecord,
62
}
63

64
#[repr(u8)]
65
#[derive(AppLayerState, Copy, Clone, PartialOrd, PartialEq, Eq)]
66
#[suricata(alstate_strip_prefix = "SshState")]
67
pub enum SSHConnectionState {
68
    SshStateInProgress = 0,
69
    SshStateBannerWaitEol = 1,
70
    SshStateBannerDone = 2,
71
    SshStateFinished = 3,
72
}
73

74
pub const SSH_MAX_BANNER_LEN: usize = 256;
75
const SSH_RECORD_HEADER_LEN: usize = 6;
76
const SSH_MAX_REASSEMBLED_RECORD_LEN: usize = 65535;
77

78
pub struct SshHeader {
79
    record_left: u32,
80
    record_left_msg: parser::MessageCode,
81

82
    flags: SSHConnectionState,
83
    pub protover: Vec<u8>,
84
    pub swver: Vec<u8>,
85

86
    pub hassh: Vec<u8>,
87
    pub hassh_string: Vec<u8>,
88
}
89

90
impl Default for SshHeader {
91
    fn default() -> Self {
120✔
92
        Self::new()
120✔
93
    }
120✔
94
}
95

96
impl SshHeader {
97
    pub fn new() -> SshHeader {
120✔
98
        Self {
120✔
99
            record_left: 0,
120✔
100
            record_left_msg: parser::MessageCode::Undefined(0),
120✔
101

120✔
102
            flags: SSHConnectionState::SshStateInProgress,
120✔
103
            protover: Vec::new(),
120✔
104
            swver: Vec::new(),
120✔
105

120✔
106
            hassh: Vec::new(),
120✔
107
            hassh_string: Vec::new(),
120✔
108
        }
120✔
109
    }
120✔
110
}
111

112
#[derive(Default)]
113
pub struct SSHTransaction {
114
    pub srv_hdr: SshHeader,
115
    pub cli_hdr: SshHeader,
116

117
    tx_data: AppLayerTxData,
118
}
119

120
#[derive(Default)]
121
pub struct SSHState {
122
    state_data: AppLayerStateData,
123
    transaction: SSHTransaction,
124
}
125

126
impl SSHState {
127
    pub fn new() -> Self {
60✔
128
        Default::default()
60✔
129
    }
60✔
130

131
    fn set_event(&mut self, event: SSHEvent) {
5✔
132
        self.transaction.tx_data.set_event(event as u8);
5✔
133
    }
5✔
134

135
    fn parse_record(
254✔
136
        &mut self, mut input: &[u8], resp: bool, pstate: *mut AppLayerParserState,
254✔
137
        flow: *mut Flow, stream_slice: &StreamSlice,
254✔
138
    ) -> AppLayerResult {
254✔
139
        let (hdr, ohdr) = if !resp {
254✔
140
            (&mut self.transaction.cli_hdr, &self.transaction.srv_hdr)
142✔
141
        } else {
142
            (&mut self.transaction.srv_hdr, &self.transaction.cli_hdr)
112✔
143
        };
144
        let il = input.len();
254✔
145
        //first skip record left bytes
254✔
146
        if hdr.record_left > 0 {
254✔
147
            //should we check for overflow ?
148
            let ilen = input.len() as u32;
11✔
149
            if hdr.record_left > ilen {
11✔
150
                hdr.record_left -= ilen;
5✔
151
                return AppLayerResult::ok();
5✔
152
            } else {
153
                let start = hdr.record_left as usize;
6✔
154
                match hdr.record_left_msg {
2✔
155
                    // parse reassembled tcp segments
156
                    parser::MessageCode::Kexinit if hassh_is_enabled() => {
2✔
157
                        if let Ok((_rem, key_exchange)) =
2✔
158
                            parser::ssh_parse_key_exchange(&input[..start])
2✔
159
                        {
2✔
160
                            key_exchange.generate_hassh(
2✔
161
                                &mut hdr.hassh_string,
2✔
162
                                &mut hdr.hassh,
2✔
163
                                &resp,
2✔
164
                            );
2✔
165
                        }
2✔
166
                        hdr.record_left_msg = parser::MessageCode::Undefined(0);
2✔
167
                    }
168
                    _ => {}
4✔
169
                }
170
                input = &input[start..];
6✔
171
                hdr.record_left = 0;
6✔
172
            }
173
        }
243✔
174
        //parse records out of input
175
        while !input.is_empty() {
422✔
176
            match parser::ssh_parse_record(input) {
205✔
177
                Ok((rem, head)) => {
173✔
178
                    let _pdu = Frame::new(
173✔
179
                        flow,
173✔
180
                        stream_slice,
173✔
181
                        input,
173✔
182
                        SSH_RECORD_HEADER_LEN as i64,
173✔
183
                        SshFrameType::RecordHdr as u8,
173✔
184
                        Some(0),
173✔
185
                    );
173✔
186
                    let _pdu = Frame::new(
173✔
187
                        flow,
173✔
188
                        stream_slice,
173✔
189
                        &input[SSH_RECORD_HEADER_LEN..],
173✔
190
                        (head.pkt_len - 2) as i64,
173✔
191
                        SshFrameType::RecordData as u8,
173✔
192
                        Some(0),
173✔
193
                    );
173✔
194
                    let _pdu = Frame::new(
173✔
195
                        flow,
173✔
196
                        stream_slice,
173✔
197
                        input,
173✔
198
                        (head.pkt_len + 4) as i64,
173✔
199
                        SshFrameType::RecordPdu as u8,
173✔
200
                        Some(0),
173✔
201
                    );
173✔
202
                    SCLogDebug!("SSH valid record {}", head);
203
                    match head.msg_code {
43✔
204
                        parser::MessageCode::Kexinit if hassh_is_enabled() => {
8✔
205
                            //let endkex = SSH_RECORD_HEADER_LEN + head.pkt_len - 2;
8✔
206
                            let endkex = input.len() - rem.len();
8✔
207
                            if let Ok((_, key_exchange)) = parser::ssh_parse_key_exchange(
8✔
208
                                &input[SSH_RECORD_HEADER_LEN..endkex],
8✔
209
                            ) {
8✔
210
                                key_exchange.generate_hassh(
7✔
211
                                    &mut hdr.hassh_string,
7✔
212
                                    &mut hdr.hassh,
7✔
213
                                    &resp,
7✔
214
                                );
7✔
215
                            }
8✔
216
                        }
217
                        parser::MessageCode::NewKeys => {
218
                            hdr.flags = SSHConnectionState::SshStateFinished;
51✔
219
                            if ohdr.flags >= SSHConnectionState::SshStateFinished {
51✔
220
                                let mut flags = 0;
21✔
221

21✔
222
                                match encryption_bypass_mode() {
21✔
223
                                    EncryptionHandling::ENCRYPTION_HANDLING_BYPASS => {
2✔
224
                                        flags |= APP_LAYER_PARSER_NO_INSPECTION
2✔
225
                                            | APP_LAYER_PARSER_NO_REASSEMBLY
2✔
226
                                            | APP_LAYER_PARSER_BYPASS_READY;
2✔
227
                                    }
2✔
228
                                    EncryptionHandling::ENCRYPTION_HANDLING_TRACK_ONLY => {
19✔
229
                                        flags |= APP_LAYER_PARSER_NO_INSPECTION;
19✔
230
                                    }
19✔
231
                                    _ => {}
×
232
                                }
233

234
                                if flags != 0 {
21✔
235
                                    unsafe {
21✔
236
                                        SCAppLayerParserStateSetFlag(pstate, flags);
21✔
237
                                    }
21✔
238
                                }
×
239
                            }
30✔
240
                        }
241
                        _ => {}
114✔
242
                    }
243

244
                    input = rem;
173✔
245
                    //header and complete data (not returned)
246
                }
247
                Err(Err::Incomplete(_)) => {
248
                    match parser::ssh_parse_record_header(input) {
32✔
249
                        Ok((rem, head)) => {
30✔
250
                            let _pdu = Frame::new(
30✔
251
                                flow,
30✔
252
                                stream_slice,
30✔
253
                                input,
30✔
254
                                SSH_RECORD_HEADER_LEN as i64,
30✔
255
                                SshFrameType::RecordHdr as u8,
30✔
256
                                Some(0),
30✔
257
                            );
30✔
258
                            let _pdu = Frame::new(
30✔
259
                                flow,
30✔
260
                                stream_slice,
30✔
261
                                &input[SSH_RECORD_HEADER_LEN..],
30✔
262
                                (head.pkt_len - 2) as i64,
30✔
263
                                SshFrameType::RecordData as u8,
30✔
264
                                Some(0),
30✔
265
                            );
30✔
266
                            let _pdu = Frame::new(
30✔
267
                                flow,
30✔
268
                                stream_slice,
30✔
269
                                input,
30✔
270
                                // cast first to avoid unsigned integer overflow
30✔
271
                                (head.pkt_len as u64 + 4) as i64,
30✔
272
                                SshFrameType::RecordPdu as u8,
30✔
273
                                Some(0),
30✔
274
                            );
30✔
275
                            SCLogDebug!("SSH valid record header {}", head);
30✔
276
                            let remlen = rem.len() as u32;
30✔
277
                            hdr.record_left = head.pkt_len - 2 - remlen;
30✔
278
                            //header with rem as incomplete data
279
                            match head.msg_code {
3✔
280
                                parser::MessageCode::NewKeys => {
5✔
281
                                    hdr.flags = SSHConnectionState::SshStateFinished;
5✔
282
                                }
5✔
283
                                parser::MessageCode::Kexinit if hassh_is_enabled() => {
2✔
284
                                    // check if buffer is bigger than maximum reassembled packet size
2✔
285
                                    hdr.record_left = head.pkt_len - 2;
2✔
286
                                    if hdr.record_left < SSH_MAX_REASSEMBLED_RECORD_LEN as u32 {
2✔
287
                                        // saving type of incomplete kex message
288
                                        hdr.record_left_msg = parser::MessageCode::Kexinit;
2✔
289
                                        return AppLayerResult::incomplete(
2✔
290
                                            (il - rem.len()) as u32,
2✔
291
                                            head.pkt_len - 2,
2✔
292
                                        );
2✔
UNCOV
293
                                    } else {
×
UNCOV
294
                                        SCLogDebug!("SSH buffer is bigger than maximum reassembled packet size");
×
UNCOV
295
                                        self.set_event(SSHEvent::LongKexRecord);
×
UNCOV
296
                                    }
×
297
                                }
298
                                _ => {}
23✔
299
                            }
300
                            return AppLayerResult::ok();
28✔
301
                        }
302
                        Err(Err::Incomplete(_)) => {
303
                            //we may have consumed data from previous records
304
                            debug_validate_bug_on!(input.len() >= SSH_RECORD_HEADER_LEN);
305
                            //do not trust nom incomplete value
306
                            return AppLayerResult::incomplete(
2✔
307
                                (il - input.len()) as u32,
2✔
308
                                SSH_RECORD_HEADER_LEN as u32,
2✔
309
                            );
2✔
310
                        }
311
                        Err(_e) => {
×
312
                            SCLogDebug!("SSH invalid record header {}", _e);
×
313
                            self.set_event(SSHEvent::InvalidRecord);
×
314
                            return AppLayerResult::err();
×
315
                        }
316
                    }
317
                }
318
                Err(_e) => {
×
319
                    SCLogDebug!("SSH invalid record {}", _e);
×
320
                    self.set_event(SSHEvent::InvalidRecord);
×
321
                    return AppLayerResult::err();
×
322
                }
323
            }
324
        }
325
        return AppLayerResult::ok();
217✔
326
    }
254✔
327

328
    fn parse_banner(
115✔
329
        &mut self, input: &[u8], resp: bool, pstate: *mut AppLayerParserState, flow: *mut Flow,
115✔
330
        stream_slice: &StreamSlice,
115✔
331
    ) -> AppLayerResult {
115✔
332
        let hdr = if !resp {
115✔
333
            &mut self.transaction.cli_hdr
52✔
334
        } else {
335
            &mut self.transaction.srv_hdr
63✔
336
        };
337
        if hdr.flags == SSHConnectionState::SshStateBannerWaitEol {
115✔
338
            match parser::ssh_parse_line(input) {
1✔
339
                Ok((rem, _)) => {
1✔
340
                    let mut r = self.parse_record(rem, resp, pstate, flow, stream_slice);
1✔
341
                    if r.is_incomplete() {
1✔
342
                        //adds bytes consumed by banner to incomplete result
×
343
                        r.consumed += (input.len() - rem.len()) as u32;
×
344
                    } else if r.is_ok() {
1✔
345
                        let mut dir = Direction::ToServer as i32;
1✔
346
                        if resp {
1✔
347
                            dir = Direction::ToClient as i32;
1✔
348
                        }
1✔
349
                        sc_app_layer_parser_trigger_raw_stream_inspection(flow, dir);
1✔
350
                    }
×
351
                    return r;
1✔
352
                }
353
                Err(Err::Incomplete(_)) => {
354
                    // we do not need to retain these bytes
355
                    // we parsed them, we skip them
356
                    return AppLayerResult::ok();
×
357
                }
358
                Err(_e) => {
×
359
                    SCLogDebug!("SSH invalid banner {}", _e);
×
360
                    self.set_event(SSHEvent::InvalidBanner);
×
361
                    return AppLayerResult::err();
×
362
                }
363
            }
364
        }
114✔
365
        match parser::ssh_parse_line(input) {
114✔
366
            Ok((rem, line)) => {
93✔
367
                if let Ok((_, banner)) = parser::ssh_parse_banner(line) {
93✔
368
                    hdr.protover.extend(banner.protover);
89✔
369
                    if !banner.swver.is_empty() {
89✔
370
                        hdr.swver.extend(banner.swver);
88✔
371
                    }
88✔
372
                    hdr.flags = SSHConnectionState::SshStateBannerDone;
89✔
373
                } else {
374
                    SCLogDebug!("SSH invalid banner");
375
                    self.set_event(SSHEvent::InvalidBanner);
4✔
376
                    return AppLayerResult::err();
4✔
377
                }
378
                if line.len() >= SSH_MAX_BANNER_LEN {
89✔
UNCOV
379
                    SCLogDebug!(
×
UNCOV
380
                        "SSH banner too long {} vs {}",
×
UNCOV
381
                        line.len(),
×
UNCOV
382
                        SSH_MAX_BANNER_LEN
×
UNCOV
383
                    );
×
UNCOV
384
                    self.set_event(SSHEvent::LongBanner);
×
385
                }
89✔
386
                let mut r = self.parse_record(rem, resp, pstate, flow, stream_slice);
89✔
387
                if r.is_incomplete() {
89✔
388
                    //adds bytes consumed by banner to incomplete result
1✔
389
                    r.consumed += (input.len() - rem.len()) as u32;
1✔
390
                } else if r.is_ok() {
88✔
391
                    let mut dir = Direction::ToServer as i32;
88✔
392
                    if resp {
88✔
393
                        dir = Direction::ToClient as i32;
45✔
394
                    }
46✔
395
                    sc_app_layer_parser_trigger_raw_stream_inspection(flow, dir);
88✔
396
                }
×
397
                return r;
89✔
398
            }
399
            Err(Err::Incomplete(_)) => {
400
                // see https://github.com/rust-lang/rust-clippy/issues/15158
401
                #[allow(clippy::collapsible_else_if)]
402
                if input.len() < SSH_MAX_BANNER_LEN {
21✔
403
                    //0 consumed, needs at least one more byte
404
                    return AppLayerResult::incomplete(0_u32, (input.len() + 1) as u32);
20✔
405
                } else {
406
                    SCLogDebug!(
407
                        "SSH banner too long {} vs {} and waiting for eol",
408
                        input.len(),
409
                        SSH_MAX_BANNER_LEN
410
                    );
411
                    if let Ok((_, banner)) = parser::ssh_parse_banner(input) {
1✔
412
                        hdr.protover.extend(banner.protover);
1✔
413
                        if !banner.swver.is_empty() {
1✔
414
                            hdr.swver.extend(banner.swver);
1✔
415
                        }
1✔
416
                        hdr.flags = SSHConnectionState::SshStateBannerWaitEol;
1✔
417
                        self.set_event(SSHEvent::LongBanner);
1✔
418
                        return AppLayerResult::ok();
1✔
419
                    } else {
UNCOV
420
                        self.set_event(SSHEvent::InvalidBanner);
×
UNCOV
421
                        return AppLayerResult::err();
×
422
                    }
423
                }
424
            }
425
            Err(_e) => {
×
426
                SCLogDebug!("SSH invalid banner {}", _e);
×
427
                self.set_event(SSHEvent::InvalidBanner);
×
428
                return AppLayerResult::err();
×
429
            }
430
        }
431
    }
115✔
432
}
433

434
// C exports.
435

436
export_tx_data_get!(ssh_get_tx_data, SSHTransaction);
437
export_state_data_get!(ssh_get_state_data, SSHState);
438

439
extern "C" fn ssh_state_new(
60✔
440
    _orig_state: *mut std::os::raw::c_void, _orig_proto: AppProto,
60✔
441
) -> *mut std::os::raw::c_void {
60✔
442
    let state = SSHState::new();
60✔
443
    let boxed = Box::new(state);
60✔
444
    return Box::into_raw(boxed) as *mut _;
60✔
445
}
60✔
446

447
unsafe extern "C" fn ssh_state_free(state: *mut std::os::raw::c_void) {
60✔
448
    std::mem::drop(Box::from_raw(state as *mut SSHState));
60✔
449
}
60✔
450

451
extern "C" fn ssh_state_tx_free(_state: *mut std::os::raw::c_void, _tx_id: u64) {
10✔
452
    //do nothing
10✔
453
}
10✔
454

455
unsafe extern "C" fn ssh_parse_request(
150✔
456
    flow: *mut Flow, state: *mut std::os::raw::c_void, pstate: *mut AppLayerParserState,
150✔
457
    stream_slice: StreamSlice, _data: *mut std::os::raw::c_void,
150✔
458
) -> AppLayerResult {
150✔
459
    let state = &mut cast_pointer!(state, SSHState);
150✔
460
    let buf = stream_slice.as_slice();
150✔
461
    let hdr = &mut state.transaction.cli_hdr;
150✔
462
    state.transaction.tx_data.0.updated_ts = true;
150✔
463
    if hdr.flags < SSHConnectionState::SshStateBannerDone {
150✔
464
        return state.parse_banner(buf, false, pstate, flow, &stream_slice);
52✔
465
    } else {
466
        return state.parse_record(buf, false, pstate, flow, &stream_slice);
98✔
467
    }
468
}
150✔
469

470
unsafe extern "C" fn ssh_parse_response(
129✔
471
    flow: *mut Flow, state: *mut std::os::raw::c_void, pstate: *mut AppLayerParserState,
129✔
472
    stream_slice: StreamSlice, _data: *mut std::os::raw::c_void,
129✔
473
) -> AppLayerResult {
129✔
474
    let state = &mut cast_pointer!(state, SSHState);
129✔
475
    let buf = stream_slice.as_slice();
129✔
476
    let hdr = &mut state.transaction.srv_hdr;
129✔
477
    state.transaction.tx_data.0.updated_tc = true;
129✔
478
    if hdr.flags < SSHConnectionState::SshStateBannerDone {
129✔
479
        return state.parse_banner(buf, true, pstate, flow, &stream_slice);
63✔
480
    } else {
481
        return state.parse_record(buf, true, pstate, flow, &stream_slice);
66✔
482
    }
483
}
129✔
484

485
#[no_mangle]
486
pub unsafe extern "C" fn SCSshStateGetTx(
803✔
487
    state: *mut std::os::raw::c_void, _tx_id: u64,
803✔
488
) -> *mut std::os::raw::c_void {
803✔
489
    let state = cast_pointer!(state, SSHState);
803✔
490
    return &state.transaction as *const _ as *mut _;
803✔
491
}
803✔
492

493
extern "C" fn ssh_state_get_tx_count(_state: *mut std::os::raw::c_void) -> u64 {
2,740✔
494
    return 1;
2,740✔
495
}
2,740✔
496

497
#[no_mangle]
498
pub unsafe extern "C" fn SCSshTxGetFlags(
14✔
499
    tx: *mut std::os::raw::c_void, direction: u8,
14✔
500
) -> SSHConnectionState {
14✔
501
    let tx = cast_pointer!(tx, SSHTransaction);
14✔
502
    if direction == u8::from(Direction::ToServer) {
14✔
503
        return tx.cli_hdr.flags;
7✔
504
    } else {
505
        return tx.srv_hdr.flags;
7✔
506
    }
507
}
14✔
508

509
#[no_mangle]
510
pub unsafe extern "C" fn SCSshTxGetAlStateProgress(
931✔
511
    tx: *mut std::os::raw::c_void, direction: u8,
931✔
512
) -> std::os::raw::c_int {
931✔
513
    let tx = cast_pointer!(tx, SSHTransaction);
931✔
514

931✔
515
    if tx.cli_hdr.flags >= SSHConnectionState::SshStateFinished
931✔
516
        && tx.srv_hdr.flags >= SSHConnectionState::SshStateFinished
124✔
517
    {
518
        return SSHConnectionState::SshStateFinished as i32;
124✔
519
    }
807✔
520

807✔
521
    if direction == u8::from(Direction::ToServer) {
807✔
522
        if tx.cli_hdr.flags >= SSHConnectionState::SshStateBannerDone {
290✔
523
            return SSHConnectionState::SshStateBannerDone as i32;
250✔
524
        }
40✔
525
    } else if tx.srv_hdr.flags >= SSHConnectionState::SshStateBannerDone {
517✔
526
        return SSHConnectionState::SshStateBannerDone as i32;
420✔
527
    }
97✔
528

529
    return SSHConnectionState::SshStateInProgress as i32;
137✔
530
}
931✔
531

532
// Parser name as a C style string.
533
const PARSER_NAME: &[u8] = b"ssh\0";
534

535
#[no_mangle]
536
pub unsafe extern "C" fn SCRegisterSshParser() {
2,163✔
537
    let parser = RustParser {
2,163✔
538
        name: PARSER_NAME.as_ptr() as *const std::os::raw::c_char,
2,163✔
539
        default_port: std::ptr::null(),
2,163✔
540
        ipproto: IPPROTO_TCP,
2,163✔
541
        //simple patterns, no probing
2,163✔
542
        probe_ts: None,
2,163✔
543
        probe_tc: None,
2,163✔
544
        min_depth: 0,
2,163✔
545
        max_depth: 0,
2,163✔
546
        state_new: ssh_state_new,
2,163✔
547
        state_free: ssh_state_free,
2,163✔
548
        tx_free: ssh_state_tx_free,
2,163✔
549
        parse_ts: ssh_parse_request,
2,163✔
550
        parse_tc: ssh_parse_response,
2,163✔
551
        get_tx_count: ssh_state_get_tx_count,
2,163✔
552
        get_tx: SCSshStateGetTx,
2,163✔
553
        tx_comp_st_ts: SSHConnectionState::SshStateFinished as i32,
2,163✔
554
        tx_comp_st_tc: SSHConnectionState::SshStateFinished as i32,
2,163✔
555
        tx_get_progress: SCSshTxGetAlStateProgress,
2,163✔
556
        get_eventinfo: Some(SSHEvent::get_event_info),
2,163✔
557
        get_eventinfo_byid: Some(SSHEvent::get_event_info_by_id),
2,163✔
558
        localstorage_new: None,
2,163✔
559
        localstorage_free: None,
2,163✔
560
        get_tx_files: None,
2,163✔
561
        get_tx_iterator: None,
2,163✔
562
        get_tx_data: ssh_get_tx_data,
2,163✔
563
        get_state_data: ssh_get_state_data,
2,163✔
564
        apply_tx_config: None,
2,163✔
565
        flags: 0,
2,163✔
566
        get_frame_id_by_name: Some(SshFrameType::ffi_id_from_name),
2,163✔
567
        get_frame_name_by_id: Some(SshFrameType::ffi_name_from_id),
2,163✔
568
        get_state_id_by_name: Some(SSHConnectionState::ffi_id_from_name),
2,163✔
569
        get_state_name_by_id: Some(SSHConnectionState::ffi_name_from_id),
2,163✔
570
    };
2,163✔
571

2,163✔
572
    let ip_proto_str = CString::new("tcp").unwrap();
2,163✔
573

2,163✔
574
    if SCAppLayerProtoDetectConfProtoDetectionEnabled(ip_proto_str.as_ptr(), parser.name) != 0 {
2,163✔
575
        let alproto = applayer_register_protocol_detection(&parser, 1);
2,163✔
576
        ALPROTO_SSH = alproto;
2,163✔
577
        if SCAppLayerParserConfParserEnabled(ip_proto_str.as_ptr(), parser.name) != 0 {
2,163✔
578
            let _ = AppLayerRegisterParser(&parser, alproto);
2,163✔
579
        }
2,163✔
580
        SCAppLayerParserRegisterLogger(IPPROTO_TCP, ALPROTO_SSH);
2,163✔
581
        SCLogDebug!("Rust ssh parser registered.");
582
    } else {
583
        SCLogNotice!("Protocol detector and parser disabled for SSH.");
×
584
    }
585
}
2,163✔
586

587
#[no_mangle]
588
pub extern "C" fn SCSshEnableHassh() {
21✔
589
    if !HASSH_DISABLED.load(Ordering::Relaxed) {
21✔
590
        HASSH_ENABLED.store(true, Ordering::Relaxed)
17✔
591
    }
4✔
592
}
21✔
593

594
#[no_mangle]
595
pub extern "C" fn SCSshHasshIsEnabled() -> bool {
91✔
596
    hassh_is_enabled()
91✔
597
}
91✔
598

599
#[no_mangle]
600
pub extern "C" fn SCSshDisableHassh() {
1✔
601
    HASSH_DISABLED.store(true, Ordering::Relaxed)
1✔
602
}
1✔
603

604
#[no_mangle]
605
pub extern "C" fn SCSshEnableBypass(mode: EncryptionHandling) {
6✔
606
    unsafe {
6✔
607
        ENCRYPTION_BYPASS_ENABLED = mode;
6✔
608
    }
6✔
609
}
6✔
610

611
#[no_mangle]
612
pub unsafe extern "C" fn SCSshTxGetLogCondition(tx: *mut std::os::raw::c_void) -> bool {
75✔
613
    let tx = cast_pointer!(tx, SSHTransaction);
75✔
614

75✔
615
    if SCSshHasshIsEnabled() {
75✔
616
        if tx.cli_hdr.flags == SSHConnectionState::SshStateFinished
35✔
UNCOV
617
            && tx.srv_hdr.flags == SSHConnectionState::SshStateFinished
×
618
        {
619
            return true;
×
620
        }
35✔
621
    } else if tx.cli_hdr.flags == SSHConnectionState::SshStateBannerDone
40✔
622
        && tx.srv_hdr.flags == SSHConnectionState::SshStateBannerDone
29✔
623
    {
624
        return true;
14✔
625
    }
26✔
626
    return false;
61✔
627
}
75✔
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc