yubihsm 0.17.3

Pure Rust client for YubiHSM2 devices
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

//! Get Pseudo Random Bytes
//!
//! <https://developers.yubico.com/YubiHSM2/Commands/Get_Pseudo_Random.html>
//!
use super::{Command, Response};
use session::SessionErrorKind::ProtocolError;
use {Adapter, CommandType, Session, SessionError};

pub(crate) const MAX_RAND_BYTES: u16 = 2048 // packet size
    - 1 // response type byte
    - 2; // length of response data

/// Get some number of bytes of pseudo random data generated on the device
pub fn get_pseudo_random<A: Adapter>(
    session: &mut Session<A>,
    bytes: u16,
) -> Result<Vec<u8>, SessionError> {
    if bytes >= MAX_RAND_BYTES {
        fail!(
            ProtocolError,
            "Requested too many random bytes (>= 2045) to fit in response packet"
        );
    }
    session
        .send_command(GetPseudoRandomCommand { bytes })
        .map(|response| response.bytes)
}

/// Request parameters for `command::get_pseudo_random`
#[derive(Serialize, Deserialize, Debug)]
pub(crate) struct GetPseudoRandomCommand {
    /// Number of random bytes to return
    pub bytes: u16,
}

impl Command for GetPseudoRandomCommand {
    type ResponseType = GetPseudoRandomResponse;
}

/// Response from `command::get_pseudo_random`
#[derive(Serialize, Deserialize, Debug)]
pub(crate) struct GetPseudoRandomResponse {
    /// Bytes of pseudo random data returned from the YubiHSM
    pub bytes: Vec<u8>,
}

impl Response for GetPseudoRandomResponse {
    const COMMAND_TYPE: CommandType = CommandType::GetPseudoRandom;
}