Redis TLS handshake failed

In breve: Redis TLS handshake failed — indica che client e server non completano la negoziazione TLS.

Cosa indica il problema

Redis TLS handshake failed — indica che client e server non completano la negoziazione TLS. La diagnosi deve collegare la prova, l’orario e il primo evento utile nei log prima di cambiare la configurazione.

Sintomi e cause probabili

Sintomi da verificare

• Il comportamento descritto da “Redis TLS handshake failed” si ripete nella stessa operazione
• Il controllo di ruolo del nodo, memoria, ACL e persistenza produce un dato coerente con lo stesso orario
• Un tentativo comparabile permette di capire se l’anomalia è generale o limitata a un solo elemento

Cause probabili

• Client e Redis non concordano CA, hostname, certificato o versione TLS
• Client collegato al nodo o ruolo sbagliato
• Autenticazione o ACL non coerenti
• Memoria oltre maxmemory e policy di eviction

Controlli da eseguire

1. Verifica catena, SNI, porta TLS e orologio di entrambi i lati
2. Eseguire INFO su ruolo, memoria e persistenza
3. Verificare utente ACL e comando consentito
4. Controllare TYPE e TTL della chiave
5. Leggere log Redis nello stesso intervallo

Dati utili

• Log Redis
• INFO e diagnostica del servizio
• Log dell’object cache o dell’applicazione

Correzione sicura

1. Allinea certificati e parametri TLS senza disattivare la verifica
2. Indirizzare scritture al primary corretto
3. Correggere credenziali e ACL minime
4. Liberare o dimensionare memoria con una policy adatta
5. Risolvere spazio e permessi della persistenza

Verifica finale

• Il comando viene eseguito sul nodo corretto
• Autenticazione e ACL consentono solo le azioni previste
• Memoria e persistenza restano sane
• L’applicazione non ricrea lo stesso errore

Errori da evitare

• Non disattivare globalmente WAF, ModSecurity, antispam o verifica TLS per aggirare il sintomo
• Non impostare permessi 777 e non cambiare proprietari in modo ricorsivo senza conoscere la struttura dell’account
• Non cancellare database, chiavi Redis, cache o file di sistema senza backup e senza aver identificato l’oggetto coinvolto
• Non ripetere pagamenti, import o webhook reali finché non hai verificato l’idempotenza

Guide Xlogic correlate

• Redis AOF rewrite failed
• Redis RDB snapshot failed permission denied
• Redis NOAUTH con WordPress Object Cache

Fonti tecniche

• Redis Documentation

Domande frequenti