snmp_usm 0.2.1

Implementation of the User-based Security Model (USM) for Simple Network Management Protocol (SNMP) version 3.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

use snmp_usm::{SecurityError, SecurityParams};

#[test]
fn it_encodes_empty_security_params() {
    let result = SecurityParams::for_discovery().encode();
    let expected = [
        0x30, 0x0E, 0x04, 0x00, 0x02, 0x01, 0x00, 0x02, 0x01, 0x00, 0x04, 0x00, 0x04, 0x00, 0x04,
        0x00,
    ];

    assert_eq!(result, expected);
}

#[test]
fn it_creates_security_params_with_username_and_auth_params() {
    let incoming_security_params = vec![
        0x30, 0x21, 0x04, 0x11, 0x80, 0x00, 0x1F, 0x88, 0x80, 0xFA, 0xA8, 0x11, 0x60, 0x0F, 0xA2,
        0xC5, 0x5E, 0x00, 0x00, 0x00, 0x00, 0x02, 0x01, 0x18, 0x02, 0x03, 0x01, 0x85, 0xFC, 0x04,
        0x00, 0x04, 0x00, 0x04, 0x00,
    ];
    let result = SecurityParams::decode(&incoming_security_params)
        .unwrap()
        .set_username(b"username")
        .set_auth_params_placeholder()
        .encode();
    let expected = vec![
        0x30, 0x35, 0x04, 0x11, 0x80, 0x00, 0x1F, 0x88, 0x80, 0xFA, 0xA8, 0x11, 0x60, 0x0F, 0xA2,
        0xC5, 0x5E, 0x00, 0x00, 0x00, 0x00, 0x02, 0x01, 0x18, 0x02, 0x03, 0x01, 0x85, 0xFC, 0x04,
        0x08, 0x75, 0x73, 0x65, 0x72, 0x6E, 0x61, 0x6D, 0x65, 0x04, 0x0C, 0x00, 0x00, 0x00, 0x00,
        0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x04, 0x00,
    ];

    assert_eq!(result, expected);
}

#[test]
fn it_returns_malformed_security_params_error_for_empty_security_params() {
    let incoming_security_params = [];
    let result = SecurityParams::decode(&incoming_security_params);

    assert_eq!(result, Err(SecurityError::MalformedSecurityParams));
}

#[test]
fn it_returns_malformed_security_params_error_for_negative_engine_boots() {
    let security_params = [
        0x30, 0x0E, 0x04, 0x00, 0x02, 0x01, 0xFF, 0x02, 0x01, 0x00, 0x04, 0x00, 0x04, 0x00, 0x04,
        0x00,
    ];
    let result = SecurityParams::decode(&security_params);

    assert_eq!(result, Err(SecurityError::MalformedSecurityParams));
}

#[test]
fn it_returns_malformed_security_params_error_for_negative_engine_time() {
    let security_params = [
        0x30, 0x0E, 0x04, 0x00, 0x02, 0x01, 0x00, 0x02, 0x01, 0xFF, 0x04, 0x00, 0x04, 0x00, 0x04,
        0x00,
    ];
    let result = SecurityParams::decode(&security_params);

    assert_eq!(result, Err(SecurityError::MalformedSecurityParams));
}