nchan_redis_ssl_trusted_certificate

Defines a trusted SSL certificate for Redis connections in a Nchan pub/sub configuration.

Syntaxnchan_redis_ssl_trusted_certificate path/to/certificate.pem;
Defaultnone
Contextupstream
Arguments1

Description

The nchan_redis_ssl_trusted_certificate directive specifies the path to a trusted SSL certificate file for secure connections to Redis. When using SSL/TLS to communicate with Redis, it’s essential to ensure that the connection is secure and that the server's identity can be verified. This directive facilitates that by providing the necessary certificate chain for verification during the SSL handshake process.

This directive is typically defined within an upstream context block where Redis is configured as a backend for Nchan’s pub/sub architecture. By specifying a trusted certificate, Nchan can establish secure connections to Redis, thus ensuring that the messages published and subscribed through the system are transmitted securely. The certificate supplied should be in PEM format, which is the standard for TLS certificates.

In practice, if this directive is not correctly set or points to an invalid file, clients may experience failed connections to Redis, resulting in lost messages or other operational issues in the pub/sub functionality. Thus, proper configuration is crucial for maintaining the integrity and confidentiality of the communication with Redis.

Config Example

upstream redis {
    server 127.0.0.1:6379;
    nchan_redis_ssl_trusted_certificate /etc/ssl/certs/redis_cert.pem;
}

Ensure the certificate is in PEM format.

File permissions of the certificate file must allow the NGINX user to read it.

If the certificate is self-signed, ensure it's added to the trusted root store.

← Back to all directives