TLS socket

TLS socket API. More...

Topics
	TLS peer verification options
	Allowed TLS peer verification options NRF_SO_SEC_PEER_VERIFY.
	Role for the socket connection
	Allowed roles for the socket connection NRF_SO_SEC_ROLE.
	TLS session cache options
	Allowed options for the TLS session cache NRF_SO_SEC_SESSION_CACHE.
	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).
	TLS Cipher suites
	Allowed IANA cipher suites for the nRF modem.
	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.
	TLS/DTLS Handshake statuses
	Allowed values for TLS/DTLS handshake status socket option NRF_SO_SEC_HANDSHAKE_STATUS.
	DTLS Fragmentation extension options
	Allowed values for DTLS Fragmentation extension socket option NRF_SO_SEC_DTLS_FRAG_EXT.
	TLS version values
	TLS version values for use with the NRF_SO_SEC_TLS_SUPPORTED_VERSION socket option.
	Security tags for decrypting TLS traffic
	Reserved security tags used for decrypting TLS traffic using Nordic tools.
	Invalid security tag
	Designated value that represents an invalid.

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.
#define	NRF_SO_SEC_TLS_SUPPORTED_VERSION   21
	Configure the minimum and maximum TLS version advertised during the handshake.

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

Detailed Description

TLS socket API.