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.


icon

Inputs/Outputs

  • ci32.png timeout ms —

    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.

  • cncrn.png TCP connection —

    TCP connection specifies the network connection reference that uniquely identifies the TCP connection.

  • cgnrn.png immutable TLS configuration —

    immutable TLS configuration specifies the reference to the immutable TLS configuration.

  • cstr.png server hostname —

    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.

  • cerrcodeclst.png error in —

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • cenum.png server certificate validation —

    server certificate validation specifies the requirements for the server certificate.

    0Any 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.
    1None—Does not require a server certificate. When you choose this option, the TLS connection provides confidentiality, but not authentication.
    Note Choosing this option introduces a security vulnerability. Only use this option for debugging and development purposes. Do not use this option in deployed systems.
  • incrn.png TLS connection —

    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.

  • i1dcclst.png server certificate chain —

    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.

  • i1du8.png certificate —

  • ierrcodeclst.png error out —

    error out contains error information. This output provides standard error out functionality.

    • Note If TLS negotiation fails, TCP connection is closed, and future calls to TLS Connection? will return FALSE.

    Examples

    Refer to the following example files included with LabVIEW.

    • labview\examples\Data Communication\Protocols\TLS\Connect to TLS Server.vi