nchan_redis_ssl_ciphers

Sets the SSL cipher suite for Redis connections in Nchan.

Syntaxnchan_redis_ssl_ciphers cipher_string;
Defaultnone
Contextupstream
Arguments1

Description

The nchan_redis_ssl_ciphers directive is used to specify the cipher suite that the Nchan module will use when establishing SSL/TLS connections to a Redis server. This is particularly important in ensuring secure communication between Nginx and the Redis server when messages are being buffered or published to subscribers over secure channels. This directive can be particularly critical in environments requiring stringent security measures, as the right cipher choice can mitigate potential vulnerabilities in the SSL/TLS protocol.

The syntax for this directive requires a single argument that specifies the ciphers in the format accepted by OpenSSL. This may include a list of cipher names or a policy string that defines which ciphers should be used. Depending on the version of OpenSSL in use, it is vital to check for any deprecated or insecure ciphers to ensure the best security posture. Users should also be aware that the order of ciphers can affect performance, as servers often prefer stronger ciphers first but must balance compatibility with older clients. Hence, careful configuration is necessary to achieve both security and performance.

The directive is set in the upstream context, meaning it is associated with defining how Nginx communicates with back-end Redis instances. It's important to note that incorrect configuration could result in failure to establish SSL connections, leading to communication breakdowns between the Nchan module and the Redis service, which can impact the overall functionality of the pub/sub system.

Config Example

upstream redis_backend {
    server redis.example.com:6379;
    nchan_redis_ssl_ciphers 'HIGH:!aNULL:!MD5';
}

Ensure that the cipher suite is compatible with the OpenSSL version in use.

Incorrectly setting this directive may prevent Nginx from establishing SSL connections with Redis.

Using a weak or outdated cipher may expose the system to security vulnerabilities.

← Back to all directives