nchan_redis_tls_verify_certificate

Controls whether to verify SSL certificates when communicating with Redis over TLS in NCHan.

Syntaxnchan_redis_tls_verify_certificate on | off;
Defaultoff
Contextupstream
Arguments1

Description

The nchan_redis_tls_verify_certificate directive is used in the Nchan module for NGINX to specify whether to verify SSL certificates when establishing a secure connection to a Redis server that supports TLS. This directive is critical for securing the communication between Nchan and the Redis backend, ensuring that the client verifies the authenticity of the server’s certificate against trusted certificate authorities.

When this directive is set to on, Nchan will perform SSL certificate verification, helping to prevent man-in-the-middle attacks and ensuring that data sent to and from the Redis server remains secure and confidential. Conversely, if set to off, the verification will be skipped, which may expose the server to security risks, making it more vulnerable to potential attacks. This parameter is especially important in production environments where secure communications are paramount.

The directive must be placed within an upstream context, as it relates to configuring how Nchan interacts with the Redis backend. The successful application of this directive depends on the proper configuration of SSL certificates on the Redis server as well as ensuring that the NGINX Nchan module is compiled with the necessary SSL support.

Config Example

upstream redis_backend {
    server 127.0.0.1:6379;
    nchan_redis_tls_verify_certificate on;
}

Ensure that your Redis server has a valid SSL certificate; otherwise, Nginx may fail to connect when verification is enabled.

Misconfigured CA certificates may lead to connection failures even when the SSL certificate is valid, so ensure your CA bundle is correct.

← Back to all directives