tech.pisoft.teagent.TEAgentSSLAuthenticConnection
The TEAgentSSLAuthenticConnection class opens an TLS (formerly SSL) secured connection with username and password authentication.
Since: 1.0
© Pi Soft, 2018-2026 · Tricryption Engine 8.1
Inheritance
Static Public Attributes
| Type | Name | Description |
|---|---|---|
| final String | SSL_VERSION_SYS_PROPERTY | System property that pins the KS-facing TLS protocol to a single explicit version (e.g. |
| final String | DEFAULT_SSL_VERSION | SSLContext factory algorithm for the agile default. |
| final String[] | DEFAULT_SSL_PROTOCOLS | Agile default enabled-protocol list. |
Public Member Functions
| Member | Description |
|---|---|
TEAgentSSLAuthenticConnection() | The TEAgentSSLAuthenticConnection constructor constructs a non-connected object. |
TEAgentSSLAuthenticConnection(String strServerName, int nPort, String strUserName, String strPasswd) | The TEAgentSSLAuthenticConnection constructor specifies a server name, port number, username and password. |
synchronized void open(String strServerName, int nPort, AuthenticationContext ctx) | The open method opens a connection and authenticates with a context. |
Member Function Documentation
TEAgentSSLAuthenticConnection()
The TEAgentSSLAuthenticConnection constructor constructs a non-connected object.
TEAgentSSLAuthenticConnection(String strServerName, int nPort, String strUserName, String strPasswd)
The TEAgentSSLAuthenticConnection constructor specifies a server name, port number, username and password.
Parameters
| Parameter | Description |
|---|---|
strServerName | A string representing the name or IP of the Key Server. |
nPort | An integer representing a Key Service communication port number. |
strUserName | A string representing a username. |
strPasswd | A string representing a password. |
Exceptions
| Exception | Description |
|---|---|
TEAgentException | if the request cannot be completed on the connection, or the Key Service returns an error for it (delivered as a TEServerException). |
synchronized void open(String strServerName, int nPort, AuthenticationContext ctx)
The open method opens a connection and authenticates with a context.
A GSSAPIAuthenticationContext (a Kerberos login) opens a SERVER-VERIFYING connection: the JDK's PKIX trust manager over the anchors the context names and nothing else, nothing forgiven, the handshake completed here so a key server that does not verify is refused as that, by name, before any protocol byte – and a context naming no anchor is refused before anything is dialled. Every other context opens as before (its own exchange authenticates the server: SRP-6a's M2 proof).
Parameters
| Parameter | Description |
|---|---|
strServerName | A string representing the Key Server name or ip address. |
nPort | An integer representing the Key Service port. |
ctx | An AuthenticationContext. |
Exceptions
| Exception | Description |
|---|---|
TEAgentException | SSL_CONNECTION_ERR "the key server's certificate did not verify: ..." or naming the missing anchor; otherwise if the request cannot be completed on the connection, or the Key Service returns an error for it (delivered as a TEServerException). |