You can edit the vRealize Log Insight agent configuration file to change the SSL configuration, add a path to the trusted root certificates, and say whether the agent accepts certificates.
This procedure applies to the vRealize Log Insight agents for Windows and Linux.
- Log in as root or use sudo to run console commands.
- Log in to the Linux machine on which you installed the vRealize Log Insight Linux agent, open a console and run pgrep liagent to verify that the vRealize Log Insight Linux agent is installed and running.
Log in to the Windows machine on which you installed the vRealize Log Insight Windows agent and start the Services manager to verify that the vRealize Log Insight agent service is installed.
- Navigate to the folder containing the liagent.ini file.
Operating system Path Linux /var/lib/loginsight-agent/ Windows %ProgramData%\VMware\Log Insight Agent
- Open the liagent.ini file in any text editor.
- Add the following keys to the
[server]section of the liagent.ini file.
Key Description ssl_ca_path
Overrides the default storage path for root Certificate Authority-signed certificates, which are used to verify connection peer certificates.
When you provide a path for ssl_ca_path, you override the defaults for both Linux and Windows agents. You can use a file where multiple certificates in PEM format are concatenated or a directory that contains certificates are in PEM format and have names of the form hash.0. (See the -hash option of the x509 utility.)
Linux: If no value is specified, the agent uses the value assigned to the LI_AGENT_SSL_CA_PATH environment variable. If that value is not present, the agent attempts to load trusted certificates from the/etc/pki/tls/certs/ca-bundle.crt file or from the /etc/ssl/certs/ca-certificates.crt file.
Windows: If no value is specified, the agent uses the value specified by the LI_AGENT_SSL_CA_PATH environment variable. If that value is not present, the vRealize Log Insight Windows agent loads certificates from the Windows root certificate store.
ssl_accept_any Defines whether any certificates are accepted by the vRealize Log Insight agent. The possible values are
0. When the value is set to yes or 1, the agent accepts any certificate from the server and establish secure connection for sending data. The default value is no.
ssl_accept_any_trusted The possible values are yes, 1, no, or 0. If the vRealize Log Insight agent has a locally stored trusted Certificate Authority-signed certificate and receives a different valid certificate signed by a different trusted Certificate Authority, it checks the configuration option. If the value is set to yes or 1, the agent accepts the new valid certificate. If the value is set to no or 0, it rejects the certificate and ends the connection. The default value is no. ssl_cn The
Common Nameof the self-signed certificate.
The default value is
VMware vCenter Log Insight. You can define a custom
Common Nameto be checked against the certificate
Common Namefield. The vRealize Log Insight agent compares the
Common Namefield of the received certificate to the host name specified for the
hostnamekey in the
[server]section. If they do not match, the agent checks the
Common Nametext box against the ssl_cn key in the liagent.ini file. If the values match, the vRealize Log Insight agent accepts the certificate.Note: These keys are ignored if SSL is disabled.
- Save and close the liagent.ini file.
The following is an example of the SSL configuration.
proto=cfapi port=9543 ssl=yes ssl_ca_path=/etc/pki/tls/certs/ca-bundle.crt ssl_accept_any=no ssl_accept_any_trusted=yes ssl_cn=LOGINSIGHT