Start TLS Function

Owning Palette: Transport Layer Security Functions

Requires: Base Development System

Negotiates a Transport Layer Security (TLS) connection on the specified TCP socket as a client. If successful, the connection is transparently encrypted. Otherwise, the connection is closed.

Add to the block diagram

Find on the palette

	timeout ms specifies the time, in milliseconds, that the function waits before timing out. A value of –1 indicates to wait indefinitely. The default value is 25000.
	TCP connection specifies the network connection reference that uniquely identifies the TCP connection.
	immutable TLS configuration specifies the reference to the immutable TLS configuration.
	server hostname specifies the hostname of the server you are connecting. This function checks server hostname and fails TLS negotiation if server hostname does not match the hostname indicated in the server certificate. This function skips the check if server hostname is unspecified.
	error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
	server certificate validation specifies the requirements for the server certificate. 0 Any Trusted CA (default)—Requires a server certificate signed by any OS-provided certificate authority (CA) or by a CA explicitly added using the Add Trusted Certificate To TLS Configuration function. 1 None—Does not require a server certificate. When you choose this option, the TLS connection provides confidentiality, but not authentication. Choosing this option introduces a security vulnerability. Only use this option for debugging and development purposes. Do not use this option in deployed systems.
	TLS connection returns a network connection reference that uniquely identifies the TLS connection. Use this value to refer to this TLS connection in subsequent function calls.
	server certificate chain returns an array of Distinguished Encoding Rules (DER) certificates provided by the server. The first element of the array is the certificate of the server.
	error out contains error information. This output provides standard error out functionality.