Struct ublox_cellular::command::device_data_security::PrepareSecurityDataImport

pub struct PrepareSecurityDataImport<'a> {
    pub data_type: SecurityDataType,
    pub internal_name: &'a str,
    pub data_size: usize,
    pub password: Option<&'a str>,
}

26.1.2 SSL/TLS certificates and private keys manager +USECMNG

Manages the X.509 certificates and private keys with the following functionalities:

• Import of certificates and private keys
• List and information retrieval of imported certificates and private keys
• Removal of certificates and private keys
• MD5 calculation of imported certificate or private key

The number and the format of the certificates and the private keys accepted depend on the module series:

• TOBY-L2 / MPCI-L2 / LARA-R2 / TOBY-R2 / SARA-U2 / LISA-U2 / SARA-G4 / SARA-G3 - certificates and private keys both in DER (Distinguished Encoding Rules) and in PEM (Privacy-Enhanced Mail) format are accepted. If the provided format is PEM, the imported certificate or private key will be automatically converted in DER format for the internal storage. It is also possible to validate certificates and private keys. Up to 16 certificates or private keys can be imported.

Notes:

• The certificates and private keys are kept in DER format and are not retrievable (i.e. cannot be downloaded from the module); for data validation purposes an MD5 hash string of the stored certificate or private key (stored in DER format) can be retrieved.
• Data for certificate or private key import can be provided with a stream of byte similar to +UDWNFILE or from a file stored on the FS.

Fields

data_type: SecurityDataType

Type of the security data

internal_name: &'a str

Unique identifier of an imported certificate or private key. If an existing name is used the data will be overridden.

TOBY-L2 / MPCI-L2 / LARA-R2 / TOBY-R2 / SARA-U2 / LISA-U2 / SARA-G4 / SARA-G3:

• The maximum length is 200 characters

data_size: usize

Size in bytes of a certificate or private key being imported.

TOBY-L2 / MPCI-L2 / LARA-R2 / TOBY-R2 / SARA-U2 / LISA-U2 / SARA-G4 / SARA-G3:

• The maximum allowed size is 8192 bytes.

password: Option<&'a str>

Decryption password; applicable only for PKCS8 encrypted client private keys.

The maximum length is 128 characters.

Trait Implementations

impl<'a> AtatCmd<AtatCmd> for PrepareSecurityDataImport<'a>

type Response = NoResponse

The type of the response. Must implement the AtatResp trait.

type Error = GenericError

The type of the error.

fn as_bytes(&self) -> Vec<u8, { ATAT_PREPARESECURITYDATAIMPORT_LEN + 15usize }>

Return the command as a heapless Vec of bytes.

fn parse(
    &self,
    res: Result<&[u8], InternalError>
) -> Result<Self::Response, Error<Self::Error>>

Parse the response into a Self::Response or Error<Self::Error> instance.

const CAN_ABORT: bool

Whether or not this command can be aborted.

const MAX_TIMEOUT_MS: u32

The max timeout in milliseconds.

const FORCE_RECEIVE_STATE: bool

Force the ingress manager into receive state immediately after sending the command.

const EXPECTS_RESPONSE_CODE: bool

Force client to look for a response. Empty slice is then passed to parse by client. Implemented to enhance expandability fo ATAT

impl<'a> AtatLen for PrepareSecurityDataImport<'a>

const LEN: usize

impl<'a> Clone for PrepareSecurityDataImport<'a>

fn clone(&self) -> PrepareSecurityDataImport<'a>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Serialize for PrepareSecurityDataImport<'a>

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where
    S: Serializer, 

Serialize this value into the given Serde serializer.