Błąd ERRSSLHANDSHAKENOTCOMPLETED oznacza przerwanie procesu uzgadniania połączenia SSL/TLS pomiędzy przeglądarką a serwerem. Najczęściej wynika z problemów z certyfikatem, niezgodności protokołów lub błędnej konfiguracji klienta czy serwera. Poniżej znajdziesz szczegółowe wyjaśnienie, typowe przyczyny oraz instrukcje naprawcze krok po kroku zarówno dla webmasterów/deweloperów, jak i użytkowników końcowych.
1. Czym jest handshake SSL/TLS?
- Handshake SSL/TLS to proces negocjacji połączenia szyfrowanego pomiędzy klientem (np. przeglądarką) a serwerem. W jego trakcie wymieniane są certyfikaty, ustalane protokoły szyfrowania oraz inne parametry bezpieczeństwa.
- Jeśli handshake się nie powiedzie, połączenie uznawane jest za niezaufane i pojawia się komunikat błędu, np. ERRSSLHANDSHAKENOTCOMPLETED.
2. Najczęstsze przyczyny błędu ERRSSLHANDSHAKENOTCOMPLETED
Klient (użytkownik końcowy):
- Nieprawidłowa data i godzina systemowa na komputerze lub urządzeniu mobilnym.
- Przestarzała przeglądarka nieobsługująca nowoczesnych protokołów SSL/TLS czy zestawów szyfrów.
- Nieprawidłowe lub problematyczne wtyczki/przedłużenia w przeglądarce.
- Blokujące oprogramowanie antywirusowe/firewall manipulujące połączeniami SSL.
- Zainfekowany komputer (atak typu man-in-the-middle).
Serwer (webmaster/web deweloper):
- Niewłaściwy, wygasły lub nieprawidłowy certyfikat SSL.
- Błędy albo niezgodność konfiguracji protokołów SSL/TLS (np. wyłączony TLS 1.2).
- Brak wsparcia dla SNI przy wielu domenach na jednym IP.
- Nieobsługiwane zestawy szyfrów (cipher suites) lub niezgodności szyfrów.
- Błędy serwera pośredniczącego (np. proxy, CDN, Cloudflare).
3. Jak naprawić błąd – instrukcje krok po kroku
Dla użytkownika końcowego:
- Sprawdź datę i godzinę systemową.
- Ustaw automatyczną synchronizację z serwerami czasu.
- Zaktualizuj przeglądarkę.
- Upewnij się, że używasz najnowszej wersji (np. Chrome, Firefox, Edge).
- Spróbuj innej przeglądarki.
- Czasami problem dotyczy tylko jednego programu.
- Wyłącz wszystkie rozszerzenia i resetuj ustawienia przeglądarki.
- Najpierw uruchom tryb incognito, potem wyłączaj rozszerzenia pojedynczo.
- Wyłącz oprogramowanie typu antywirus/firewall na czas testów.
- Następnie sprawdź, czy problem występuje nadal. Jeśli nie, skonfiguruj wyjątek SSL w oprogramowaniu zabezpieczającym.
- Spróbuj połączenia z innej sieci internetowej.
- Czasami restrykcyjny router lub sieć firmowa może blokować niektóre połączenia SSL.
- Jeśli błąd utrzymuje się na jednej stronie, powiadom administratora tej witryny, podając szczegóły.
Dla webmastera/web dewelopera:
- Sprawdź certyfikat SSL
- Czy jest ważny (nie wygasł), prawidłowo zainstalowany i nie został cofnięty/revokowany?
- Sprawdź łańcuch certyfikatów (CA Bundle/intermediate).
- Zweryfikuj konfigurację protokołów SSL/TLS
- Włącz obsługę nowoczesnych wersji: min. TLS 1.2 (zalecane także TLS 1.3).
- Wyłącz stare protokoły (SSL3.0, TLS 1.0, TLS 1.1).
- Sprawdź dostępność wspólnych zestawów szyfrów (cipher suites) między serwerem a klientem.
- Upewnij się, że server obsługuje szeroko wspierane zestawy szyfrów.
- Jeśli korzystasz z SNI (kilka domen na jednym IP), sprawdź, czy obsługa SNI jest poprawnie zaimplementowana po obu stronach.
- Zweryfikuj konfigurację serwera pośredniczącego (reverse proxy, load balancer, CDN) – np. Cloudflare, Nginx, Apache.
- Sprawdź ustawienia trybu SSL (pełny, elastyczny, wymuszony).
- Przetestuj swój serwer online –
- Użyj narzędzi takich jak SSL Labs/SSL Checker, aby zidentyfikować wszystkie błędy w konfiguracji.
- Przejrzyj logi serwera www oraz systemowe.
- Będą tam informacje o dokładnym powodzie przerwania handshake’u.
- W razie ciągłych problemów rozważ ponowne wygenerowanie, instalację i re-konfigurację certyfikatu SSL.
4. Tabele – przegląd częstych przyczyn i kto może naprawić
| Przykładowa przyczyna | Osoba naprawiająca | Kluczowe działania naprawcze |
|---|---|---|
| Błędna data/godzina | Użytkownik końcowy | Synchronizacja zegara |
| Przestarzała przeglądarka | Użytkownik końcowy | Aktualizacja lub zmiana przeglądarki |
| Certyfikat wygasł/niepoprawny | Webmaster/deweloper | Ponowna instalacja/wydanie certyfikatu |
| Niekompatybilny protokół lub zestaw szyfrów | Webmaster/deweloper | Modernizacja konfiguracji TLS/SNI/cipher suites |
| Zła konfiguracja CDN/proxy | Webmaster/deweloper | Korekta ustawień pośrednika |
5. Dodatkowe informacje i dobre praktyki
- Zawsze korzystaj z automatycznego odnawiania certyfikatów SSL (np. Let’s Encrypt).
- Po każdej zmianie konfiguracji wykonuj testy SSL online i na różnych urządzeniach/OS/przeglądarkach.
- Monitoruj daty ważności certyfikatów oraz cyklicznie sprawdzaj logi dot. handshake’u po stronie serwera.
6. Przydatne narzędzia dla webmasterów
- [SSL Labs SSL Test] – audyt konfiguracji SSL/TLS.
- Logi serwera www (np. Apache, Nginx) – szczegóły handshake.
- Wireshark lub narzędzia debugujące ruch HTTPS – analiza handshake krok po kroku.
Podsumowanie –
Błąd ERRSSLHANDSHAKENOTCOMPLETED można zazwyczaj usunąć kilkoma prostymi krokami po stronie klienta lub poprzez poprawną konfigurację certyfikatu i ustawień SSL/TLS na serwerze. Kluczowe jest systematyczne diagnozowanie – od prostych (zegary, przeglądarki) po zaawansowane (cipher suites, SNI, proxy).
W przypadku trudności diagnostycznych, zachodzi konieczność ścisłej współpracy webmastera z użytkownikami i analizowania logów serwera, ponieważ handshake to proces ze złożoną sekwencją zależności.
