User Manual

SARA-R4 series-AT commands manual
UBX-17003787 - R16

20Device and data security
Page 240 of 401
Parameter Type Description
o <param_val1> (string) is the internal name identifying a trusted root certificate; the
maximum length is 200 characters. The factory-programmed value is an empty string.
• 4: expected server hostname;
o <param_val1> (string) is the hostname of the server, used when certificate validation level
is set to Level 2; the maximum length is 256 characters. The factory-programmed value is
an empty string.
• 5: client certificate internal name;
o <param_val1> (string) is the internal name identifying a client certificate to be sent to the
server; the maximum length is 200 characters. The factory-programmed value is an empty
string.
• 6: client private key internal name;
o <param_val1> (string) is the internal name identifying a private key to be used; the
maximum length is 200 characters. The factory-programmed value is an empty string.
• 7: client private key password;
o <param_val1> (string) is the password for the client private key if it is password protected;
the maximum length is 128 characters. The factory-programmed value is an empty string.
• 8: pre-shared key;
o <preshared_key> (string) is the pre-shared key used for connection; the factory-
programmed value is an empty string. The accepted string type and length depends on the
<string_type> value.
o <string_type> (number) defines the type and the maximum length of the <preshared_key>
string. Allowed values for <string_type>:
- 0 (default value): <preshared_key> is an ASCII string and its maximum length is 64
characters
- 1: <preshared_key> is an hexadecimal string and its maximum length is 128 characters
SARA-R410M-01B / SARA-R410M-02B / SARA-R410M-52B / SARA-R412M /
SARA-N4
The <string_type> parameter is not supported. The <preshared_key> parameter is
an ASCII string (maximum length 64 characters).
• 9: pre-shared key identity;
o <preshared_key_id> (string) is the pre-shared key identity used for connection; the factory-
programmed value is an empty string. The accepted string type and length depends on the
<string_type> value.
o <string_type> (number) defines the type of the <preshared_key_id> string. Allowed values
for <string_type>:
- 0 (default value): <preshared_key_id> is an ASCII string and its maximum length is 128
characters
- 1: <preshared_key_id> is an hexadecimal string and its maximum length is 256
characters
SARA-R410M-01B / SARA-R410M-02B / SARA-R410M-52B / SARA-R412M /
SARA-N4
The <string_type> parameter is not supported. The <preshared_key_id> parameter
is an ASCII string (maximum length 128 characters).
• 10: SNI (Server Name Indication);
o <param_val1> (string) value for the additional negotiation header SNI (Server Name
Indication) used in SSL/TLS connection negotiation; the maximum length is 128
characters. The factory-programmed value is an empty string.
• 11: PSK key and PSK key identity generated by RoT (Root of trust); allowed values for <param_
val1>:
o 0 (factory-programmed value): OFF - The PSK and PSK key ID are NOT generated by RoT
o 1: ON - The PSK and PSK key ID are generated by RoT in the process of SSL/TLS connection
negotiation
• 12: server certificate pinning;
o <server_certificate> (string) internal name identifying a certificate configured to be
used for server certificate pinning; the maximum length is 200 characters. The factory-
programmed value is an empty string.
o <pinning_level> defines the certificate pinning information level. Allowed values for
<pinning_level>
- 0: pinning based on information comparison of received and configured certificate
public key
- 1: pinning based on binary comparison of received and configured certificate public key