Logging in using SSL from the CLC Server Command Line Tools

A secure connection is established to a CLC Server by supplying the relevant port number, usually 8443, to the clcserver command. E.g.

clcserver -S <servername> -U <username> -W <passcode> -P 8443

The clcserver command uses SSL if it is present on the port it connects to.

If the server certificate is untrusted, the connection will not be established and login will fail with the message: SSL Handshake failed. Check certificate.

To specify that the certificate should be trusted, it must be added to the CLC Server Command Line Tools truststore. To do this, run the clcserversslstore tool with the relevant connection details, e.g.

	clcserversslstore -S server.com -U bob -W secret -P 8443

The details of the certificate are then displayed, and the option to add the certificate to the truststore (y) or not to do so (n) is provided.

The server (server.com) presented an untrusted certificate with the following
 attributes:
SUBJECT
=======
Common Name        : server.com
Alternative Names  : N/A
Organizational Unit: Enterprise
Organization       : QIAGEN
Locality           : Aarhus N
State              : N/A
Country            : DK
ISSUER
=======
Common Name        : server.com
Organizational Unit: Enterprise
Organization       : QIAGEN
Locality           : Aarhus N
State              : N/A
Country            : DK
FINGERPRINTS
============
SHA-1              : 21 34 6E 8D 9B 01 33 B5 D6 40 73 56 7A 2F 87 A7 EE 3C 21 44
SHA-256            : E5 7F F3 19 8A C1 53 16 00 39 EC F6 65 B3 15 AD 6F 71 DC 2C 8E D0 D9 91 54 DD AE 40 34 A9 0B F2
VALIDITY PERIOD
===============
Valid From         : 4 Apr 2024
Valid To           : 4 Apr 2025
Trust this certificate? [yn]

After the certificate is added to the CLC Server Command Line Tools truststore, the clcserver tool can be used to connect securely to the CLC Server.

Add the -L flag to the clcserversslstore command, along with the connection information, to list the certificates trusted by the CLC Server Command Line Tools.