Skip to main content

TCP Connection

TCP Connection is the endpoint resource TCP Client sends to. It holds the address, the socket options, the timeouts, and the TLS configuration.

TLS is off by default. Enabling it exposes a trust mode, hostname verification, the certificate resources to use, and optional protocol and cipher-suite restrictions.

The resource has three tabs: Configuration, Advanced, and TLS.

Configuration

FieldRequiredDescription
NameOptionalName of the resource.
DescriptionOptionalDescription of the resource.
HostOptionalTarget hostname or IP. Mapping and vault values are supported.
PortOptionalTarget TCP port, 165535. Required.
TCP Keep-AliveOptionalDefaults to selected.
TCP No-Delay (Nagle off)OptionalDefaults to selected.

Advanced

FieldRequiredDescription
Connect Timeout (ms)OptionalDefaults to 10000.
Read Timeout (ms)OptionalDefaults to 30000.

Both timeouts can be overridden per-activity on TCP Client.

TLS

FieldRequiredDescription
Enable TLSOptionalDefaults to cleared.
Trust ModeOptionalHow the server certificate is trusted. Defaults to Default (JVM truststore).
Verify HostnameOptionalDefaults to selected.
Trust CertificateOptionalCertificate resource for server trust — the same picker as Encrypt/Decrypt. The certificate or keystore and its password live in the resource; nothing is entered here.
Client Certificate (mTLS)OptionalCertificate resource holding the client certificate and key for mutual TLS.
Certificate TypeOptionalEncryption resource type used to resolve the certificate. Defaults to ssl.
Enabled ProtocolsOptionalFor example TLSv1.3, TLSv1.2. Empty uses the JVM default.
Enabled Cipher SuitesOptionalEmpty uses the JVM default.

Trust Mode

OptionMeaning
Default (JVM truststore)Trust certificates in the JVM truststore.
Custom truststoreTrust certificates from a supplied truststore.
Pinned certificateTrust a specific pinned certificate.
Insecure — trust all (dev/test only)Trust any certificate.
warning

Leave Verify Hostname on. Disabling it exposes the connection to MITM.