TLS socket API. More...

Topics
	DTLS Connection ID settings
	Allowed values for DTLS connection ID setting socket option NRF_SO_SEC_DTLS_CID.

	DTLS Connection ID statuses
	Allowed values for DTLS connection ID status socket option NRF_SO_SEC_DTLS_CID_STATUS.

	DTLS Fragmentation extension options
	Allowed values for DTLS Fragmentation extension socket option NRF_SO_SEC_DTLS_FRAG_EXT.

	DTLS handshake timeout values
	Allowed timeout values for DTLS handshake timeout socket option according to RFC6347 section 4.2.4.1. Default is 123 seconds. (https://tools.ietf.org/html/rfc6347#section-4.2.4.1)

	Invalid security tag
	Designated value that represents an invalid.

	Role for the socket connection
	Allowed roles for the socket connection NRF_SO_SEC_ROLE.

	Security tags for decrypting TLS traffic
	Reserved security tags used for decrypting TLS traffic using Nordic tools.

	TLS Cipher suites
	Allowed IANA cipher suites for the nRF modem.

	TLS peer verification options
	Allowed TLS peer verification options NRF_SO_SEC_PEER_VERIFY.

	TLS session cache options
	Allowed options for the TLS session cache NRF_SO_SEC_SESSION_CACHE.

	TLS/DTLS Handshake statuses
	Allowed values for TLS/DTLS handshake status socket option NRF_SO_SEC_HANDSHAKE_STATUS.

Macros
#define	NRF_SOCKET_TLS_MAX_MESSAGE_SIZE 2048
	Maximum TLS message size in bytes.

#define	NRF_SOCKET_TLS_MAX_SEC_TAG_LIST_SIZE 7
	Maximum number of security tags that can be associated with a socket.

#define	NRF_SO_SEC_TAG_LIST 1
	Select an array of security tags to use for credentials when connecting.

#define	NRF_SO_SEC_HOSTNAME 2
	Configure the hostname used for peer verification.

#define	NRF_SO_SEC_CIPHERSUITE_LIST 3
	Select which cipher suites are allowed to be used during the TLS handshake.

#define	NRF_SO_SEC_CIPHERSUITE_USED 4
	Retrieve the cipher suite used during the TLS/DTLS handshake (Read-only).

#define	NRF_SO_SEC_PEER_VERIFY 5
	Configure peer verification level.

#define	NRF_SO_SEC_ROLE 6
	Configure the role for the connection.

#define	NRF_SO_SEC_SESSION_CACHE 12
	Enable/disable TLS session caching.

#define	NRF_SO_SEC_SESSION_CACHE_PURGE 13
	Purge TLS session cache (write-only).

#define	NRF_SO_SEC_DTLS_HANDSHAKE_TIMEO 14
	Configure the DTLS handshake timeout value.

#define	NRF_SO_SEC_DTLS_CID 15
	Enable/disable the DTLS connection ID.

#define	NRF_SO_SEC_DTLS_CID_STATUS 16
	Get the DTLS connection ID status (read-only).

#define	NRF_SO_SEC_DTLS_CONN_SAVE 17
	Save DTLS connection (Write-only).

#define	NRF_SO_SEC_DTLS_CONN_LOAD 18
	load DTLS connection (Write-only)

#define	NRF_SO_SEC_HANDSHAKE_STATUS 19
	Get the end status of the last completed TLS/DTLS handshake procedure (Read-only).

#define	NRF_SO_SEC_DTLS_FRAG_EXT 20
	Enable/disable the DTLS fragmentation extension.

Typedefs
typedef uint32_t	nrf_sec_tag_t
	Security tags used on the TLS socket.

Detailed Description

TLS socket API.

Topics