5.4. Using SSL-encrypted connections with the syslog-ng agent

When connecting to a syslog-ng server using an encrypted connection, the syslog-ng agent verifies the certificate of the server. The connection is established only if the Certificate Authority (CA) that issued the certificate of the server is available in the Certificate Store (MMC > Certificates > Computer Account > Local Computer > Trusted Root Certificates) of the Windows-based host.

[Note] Note

This certificate (sometimes also called the CACert of the server) is not the certificate of the server: it is the certificate of the CA that signed the certificate of the server. (For details on how certificate-based authentication works, see Section 2.7, “Secure logging using TLS”)

To enable SSL-encrypted connections to the server, complete the following steps:

Procedure 5.4.1. Enabling encrypted connections

  1. Start the configuration interface of the syslog-ng Agent for Windows application.

  2. Select syslog-ng Agent Settings > Destinations > Network, and double-click on IPv4.

  3. Select the server that accepts encrypted connections and click Edit.

  4. Select the Use SSL option.

    [Warning] Warning

    The connection can be established only if the Certificate Authority (CA) that issued the certificate of the server is available in the Certificate Store (MMC > Certificates > Computer Account > Local Computer > Trusted Root Certificates) of the Windows-based host. See Section 5.4.3, “Importing certificates with the Microsoft Management Console” for details on importing certificates.

    [Note] Note

    The subject_alt_name parameter (or the Common Name parameter if the subject_alt_name parameter is empty) of the server's certificate must contain the hostname or the IP address (as resolved from the syslog-ng clients and relays) of the server (e.g., syslog-ng.example.com).

    Alternatively, the Common Name or the subject_alt_name parameter can contain a generic hostname, e.g., *.example.com.

    Note that if the Common Name of the certificate contains a generic hostname, do not specify a specific hostname or an IP address in the subject_alt_name parameter.

  5. Select Apply, then OK. To activate the changes, restart the syslog-ng Agent service.


© 2007-2010 BalaBit IT Security
Please send your comments or documentation bugs to: documentation@balabit.com