Rozwiązywanie problemów z klientem Sophos Connect
Jeśli Sophos Connect nie nawiąże połączenia, diagnostyka rozpoczyna się w punkcie końcowym: zanotuj czas błędu, przeczytaj komunikat o tej próbie w sekcji Events i sprawdź tylko ścieżkę, której dotyczy problem. Zmiany w regułach zapory sieciowej, zasadach VPN lub certyfikatach oparte na podejrzeniach utrudniają analizę. Ten element Runbook obejmuje klienta w systemach Windows i macOS; Instrukcje dla Windows i macOS wyjaśniają instalację.
Szybko zawęź
- Zapisz sytuację początkową: Czas ze strefą czasową, użytkownikiem, systemem operacyjnym, wersją Sophos Connect, IPsec lub SSL VPN i źródłem profilu (
.scx,.ovpnlub.pro). - Sprawdź sieć lokalną: Adapter fizyczny wymaga prawidłowego adresu IP. Nazwa publiczna musi być możliwa do rozpoznania bez VPN.
- Przeczytaj zdarzenie: W obszarze Events porównaj wpis z próbą połączenia. Zapisz sformułowania i wartości zastępcze bez zmian.
- Rozróżnij problem klienta od problemu po stronie zdalnej: Jeśli interfejs lub usługa nie uruchamia się, kontynuuj analizę na urządzeniu końcowym. Jeśli klient dociera do bramy, ale próba kończy się niepowodzeniem na etapie polityki, uwierzytelniania lub IKE, administrator zapory musi skorelować zdarzenia.
- Sprawdź wynik: Połącz ponownie po dokładnie jednej akcji i zanotuj nowy znacznik czasu.
- Eskaluj: Przekazuj powtarzające się błędy za pomocą zdarzenia, dziennika VPN i
scvpntsr.zip; nie zapisuj danych dostępowych na zgłoszeniu.
Status Connected potwierdza jedynie, że tunel został utworzony. DNS, routing i dostęp do dozwolonego miejsca docelowego wewnętrznego to osobne testy.
Prawidłowo czytaj wydarzenia
Wiadomość pod Wydarzenia jest najlepszym pierwszym filtrem. Nie opisuje jednak ostatecznej przyczyny w każdym przypadku. Na przykład DNS resolution failed może jedynie potwierdzić, że klient nie mógł rozpoznać nazwy bramy; Dlaczego zastosowany resolwer nie odpowiada, należy wyjaśnić osobno.
Sieć, DNS i udostępnianie
- No network connection: Ethernet lub WiFi nie mają adresu IP. Najpierw przywróć łączność lokalną bez VPN.
- DNS resolution failed: Nie można rozpoznać nazwy bramy. Sprawdź, czy serwer DNS jest przypisany do interfejsu fizycznego i uruchom
nslookup www.sophos.comw Wierszu poleceń w systemie Windows lub w Terminalu w systemie macOS. Oczekiwany jest co najmniej jeden adres IP. Jeśli ten test publiczny zakończy się niepowodzeniem, następny krok należy do sieci lokalnej lub dostawcy, a nie do zasad VPN. - DNS resolution failed for gateway:
<gateway name:port>: Nazwa hosta w udostępnianiu jest nieprawidłowa; w przypadku zaimportowanego.ovpnadministrator zapory musi sprawdzić ustawienia SSL VPN. - Cannot connect to policy gateway:
<gateway name>: Dla provisioningu w Windows i macOS od Sophos Connect 2.1. Porównajgatewayiuser_portal_portz bramą i portem HTTPS usługi VPN Portal. Sprawdź też, czy port wychodzący nie jest zablokowany i czy brama polityki jest dostępna. - Import file contains a duplicate connection:
<connection name>: Dla provisioningu w Windows i macOS od Sophos Connect 2.1. Nadaj unikatową nazwę każdej zduplikowanej wartościdisplay_namew pliku.pro. - The connection data could not be added. Connection with name
<connection name>already exists: Sprawdź już zaimportowane połączenie i usuń je tylko wtedy, gdy bieżące źródło profilu jest dostępne do ponownego importu.
Rejestracja i status profilu
User authentication of
<username entered>failed: Powtórz uważnie wpis jeden raz. Jeśli błąd się powtórzy, administrator zapory musi sprawdzić stan hasła, użytkownika i autoryzację VPN. Wiele domysłów może uruchomić mechanizmy blokujące.Server expected remote ID
<expected ID value>but got<actual ID value>: Identyfikator lokalny w zaporze i profilu klienta nie są zgodne. Uzyskaj bieżący profil od administratora zapory.Possible pre-shared key mismatch
<connection name>: Tylko IPsec. Klucz wstępny i wyeksportowany profil to nie to samo; nie przekazuj klucza w zgłoszeniu ani na czacie.No SSL VPN policy is defined for this user:
<username>: Polityka zdalnego dostępu SSL VPN nie zawiera pasujących członków. Jest to zadanie autoryzacji po stronie zapory ogniowej.The Single sign-on (SSO) option is grayed out: Windows od Sophos Connect 2.4; macOS od 2.1. Aktualna dokumentacja rozwiązywania problemów wskazuje dla obu platform brak wartości
sso_api_portisso_api_domainw profilu.ovpnlub.scx. Poproś administratora zapory o zaktualizowaną konfigurację, zaimportuj ją i połącz się ponownie; nie jest to zalecenie ręcznej edycji profili. Klient macOS w wersji 2.0 nie uzyskuje w ten sposób obsługi SSO.SSO Authentication failed due to Webview2 setup error: Napraw lub zaktualizuj WebView2 i status aktualizacji systemu Windows; klient nie mógł otworzyć strony logowania Microsoft.
Logowanie Entra SSO nie udaje się w przeglądarce lub nie następuje powrót do klienta (macOS, Sophos Connect 2.1 lub nowszy): Sprawdź procedurę logowania SSO w przeglądarce na macOS, która opisuje wybór przeglądarki, przełączenie awaryjne i powrót do Sophos Connect. Jeśli potrzebny jest inny tryb przeglądarki, poproś dział IT o zatwierdzony plik
.prozgodny ze schematem provisioningu dlasso_auth_browser_type. Spełnij wymagania zgodności lub skontaktuj się z działem IT; nie osłabiaj Conditional Access, MFA ani walidacji certyfikatów.
Zdarzenia IPsec
- UDP ports 500/4500 blocked: Lokalna zapora sieciowa lub router blokuje IKE/NAT-T. Jeśli nie zarządzasz routerem, sprawdź to w mobilnym hotspocie. Jeśli pracuje tam ten sam klient, jest to mocny wskaźnik oryginalnej ścieżki sieciowej.
- No response from gateway:
<gateway FQDN or IP specified in connection>: Brama IPsec nie odpowiada na IKE. Administrator zapory sieciowej musi sprawdzić dostępność i publiczne połączenie WAN. - Received NO_PROPOSAL_CHOSEN notification from gateway: Polityka Sophos Connect nie jest aktywna lub propozycja fazy 1 i wyeksportowany profil nie są zgodne. Nie rozluźniaj propozycji na ślepo; Porównuj zasady i profile w kontrolowany sposób.
- SA disabled or deleted by gateway: Brama usunęła SA, na przykład po zmianie polityki lub ręcznym rozłączeniu. Połącz ponownie raz; po powtórzeniu korelują ze znacznikiem czasu zapory ogniowej.
- Failure to add route [network/mask] prevented phase 2 completion: Tylko system Windows. Po skonfigurowaniu fazy 2 SA nie można było wyznaczyć trasy. Dezaktywuj i ponownie aktywuj adapter TAP. Jeśli błąd będzie się powtarzał, otwórz Wiersz poleceń jako administrator:
net stop scvpn
net start scvpn
Oczekuje się, że usługa będzie ponownie działać, a nowa próba połączenia wyznaczy trasę. Zatrzymanie powoduje przerwanie istniejących tuneli Sophos Connect na tym urządzeniu.
- Failed to load connection info into strongSwan: Tylko Windows;
charon-svc.exelub usługa strongSwan nie jest uruchomiona. Rozpocznij w Wierszu poleceń jako administrator:
net start strongswan
Jeśli usługa nie uruchomi się lub ponownie ulegnie awarii, nie kontynuuj pętli ponownego uruchamiania, ale wykonaj kopię zapasową raportu pomocy technicznej i zdarzeń systemu Windows.
Zdarzenia SSL VPN
- Policy mismatch error. Will download policy and retry connection.: Połączenie Windows utworzone z pliku
.propobiera zmienioną politykę i automatycznie łączy się ponownie. Przy TCP klient wykrywa zmianę podczas aktywnego połączenia; przy UDP może być konieczne odczekanie do wygaśnięcia limitu bezczynności. - Policy mismatch error. Import a new policy for this connection.: Ręcznie zaimportowany
.ovpnjest przestarzały. Uzyskaj i zaimportuj nowy, specyficzny dla użytkownika.ovpnz portalu VPN. - Compression mismatch error. Will retry connection.: W przypadku
.ovpnpodłącz ponownie ręcznie; połączenie udostępnione próbuje tego automatycznie. - Server certificate cannot be verified:
<gateway name>. Do you want to continue? Podczas provisioningu VPN Portal przedstawia certyfikat, którego endpoint nie może zweryfikować — zwykle samopodpisany certyfikat zapory. Kontynuuj dopiero po potwierdzeniu bramy i certyfikatu zaufanym kanałem. Administrator powinien przypisać publicznie zaufany certyfikat do Admin console and end-user interaction albo w kontrolowany sposób rozesłać CA Sophos Firewall do magazynów zaufania zarządzanych endpointów. Nie wyłączaj walidacji certyfikatu. - Could not connect to untrusted server:
<gateway>: Ostrzeżenie o certyfikacie zostało anulowane. Najpierw wyjaśnij tożsamość i łańcuch zaufania, a następnie spróbuj ponownie. - Timed out waiting for server response: Zastąp nazwę hosta, DDNS lub publiczny adres WAN konfiguracji SSL VPN nie wskazuje poprawnie zapory sieciowej. W przypadku
.proużyj Update policy; W przypadku.ovpnuzyskaj nowy plik po poprawieniu stacji zdalnej przez administratora zapory.
Napraw błędy GUI i usług
Interfejs nie otwiera się lub nie odpowiada
W systemie Windows otwórz Menedżer zadań > Szczegóły, wybierz scgui.exe, uruchom Zakończ zadanie i uruchom ponownie Sophos Connect za pomocą skrótu na pulpicie. W systemie macOS otwórz proces Sophos Connect w Monitorze aktywności, wybierz Wymuś zamknięcie i uruchom ponownie aplikację z Launchpada. To zakończy zablokowaną powierzchnię, a nie automatycznie przyczynę. Jeśli błąd się powtórzy, zapisz wersję i scgui.log.
Service is unavailable
W systemie Windows zdarzenie oznacza, że scvpn nie jest uruchomiony. Otwórz Wiersz poleceń jako administrator:
net start scvpn
W przypadku Service Unavailable po zawieszeniu się rozłączenia IPsec w systemie macOS najpierw zamknij GUI w Monitorze aktywności. Następnie załaduj ponownie udokumentowaną usługę w Terminalu z uprawnieniami administratora:
sudo /bin/launchctl unload -w /Library/LaunchDaemons/com.sophos.connect.scvpn.plist
sudo /bin/launchctl load -w /Library/LaunchDaemons/com.sophos.connect.scvpn.plist
Otwórz ponownie Sophos Connect i sprawdź, czy komunikat zniknął. Te polecenia przerywają tunel. Jeśli błąd się powtórzy, nie ładuj ponownie usług wielokrotnie, ale zapisz logi i raporty.
Więcej błędów lokalnych usług SSL VPN
- Management port is unavailable: Sophos Connect nie mógł zająć portu TCP
25340do komunikacji z OpenVPN. Sprawdź, jaka inna aplikacja lokalna korzysta z portu i zakończ go tylko wtedy, gdy znana jest jego funkcja. Następnie podłącz ponownie. - OpenVPN service is unavailable: W systemie Windows sprawdź typ uruchamiania usługi OpenVPN. Jeśli jest ustawiony na Disabled, zanotuj dotychczasową wartość, zmień ją na Manual, a następnie uruchom ponownie usługę Sophos Connect. Spowoduje to przerwanie aktywnych tuneli. Następnie sprawdź usługę i połączenie; jeśli próba się nie powiedzie, przywróć poprzedni typ uruchamiania i eskaluj problem. Nie stosuj tego ustawienia usług Windows w systemie macOS.
- Failed to create temporary file: Uruchom ponownie urządzenie. Klient nie mógł utworzyć pliku tymczasowego w celu przekazania atrybutów połączenia.
- Failed to write to pipe lub bardziej ogólnie SSL VPN error: Podłącz ponownie raz. Jeśli błąd będzie się powtarzał, uruchom ponownie urządzenie; następnie eskaluj, korzystając z dzienników, zamiast ciągłego restartowania.
- Sophos Connect can’t establish a tunnel po zainstalowaniu obu klientów: dokumentacja rozwiązywania problemów opisuje ponowną instalację obu klientów w kolejności: stary Sophos SSL VPN Client, a następnie Sophos Connect. Instrukcja instalacji wyklucza jednak równoległe używanie innych klientów VPN. Te sprzeczne informacje nie stanowią ogólnego zatwierdzenia współistnienia klientów. Jeśli stary klient nie jest już potrzebny, pozostań przy zatwierdzonej konfiguracji docelowej bez niego; jeśli oba są bezwzględnie wymagane, najpierw uzgodnij konkretną kombinację z Sophos oraz zaplanuj oddzielny pilotaż i procedurę wycofania zmian, zamiast instalować oba na próbę.
- Ręcznie importowane profile
.ovpnlub.scxnie pobierają automatycznie późniejszych zmian polityk. Auto-connect i Update policy wymagają provisioningu: w Windows ze zgodnym klientem, a w macOS od 2.1, nie z 2.0.auto_connect_hostwłącza Auto-connect; Update policy jest dostępne po pierwszym udanym połączeniu. Rename, Clear credentials i Delete pozostają osobnymi działaniami; po Delete profile ręczne wymagają ponownego importu. - Po aktualizacji lub odinstalowaniu na Macu z Sophos Endpoint nadal działają stare procesy: Według dokumentacji rozwiązywania problemów Tamper Protection może uniemożliwić wyładowanie demonów Sophos Connect. Zabezpiecz logi, uruchom Maca ponownie jeden raz w oknie serwisowym, a następnie sprawdź stan klienta i procesów. Aktualna instrukcja odinstalowania nie zawiera już ogólnego zalecenia wyłączenia ochrony; nie oznacza to ani obowiązku jej wyłączenia, ani gwarancji, że ochrona nigdy nie ma wpływu na ten problem. Jeśli usunięcie nadal jest zablokowane, skonsultuj konkretną kombinację Endpoint/klient z działem IT lub Sophos. Wprowadzaj tylko wyraźnie zatwierdzone, tymczasowe zmiany ochrony, a następnie sprawdź, czy ochrona została ponownie włączona i jest aktywna zarówno na urządzeniu końcowym, jak i w konsoli zarządzania — również wtedy, gdy próba się nie powiedzie. Ochronę profili i procedurę wycofania zmian opisuje procedura odinstalowania w macOS; nie kończ wielokrotnie demonów.
Połączono, ale DNS lub ruch nie działa
Najpierw narysuj wyraźną linię podziału:
- Dostępny wewnętrzny adres IP, wewnętrzna nazwa FQDN nie: Sprawdź serwer DNS, wyszukaj domenę i status profilu. Jeśli DNS ulegnie zmianie, gdy tunel IPsec jest aktywny, Sophos Connect pokaże nowe wartości dopiero po rozłączeniu i ponownym podłączeniu.
- Po odłączeniu pełnego tunelu dostęp do Internetu już nie działa: Szczególnie w systemie macOS wewnętrzne serwery DNS mogą pozostać na karcie fizycznej. Rozłącz i podłącz ponownie lokalne połączenie Wi-Fi lub Ethernet. Jeśli sytuacja się powtórzy, udokumentuj wersję, profil i czas; Nie nadpisuj trwale ręcznie DNS.
- Ani wewnętrzny adres IP, ani nazwa nie są dostępne: Nie jest to dowód na błąd klienta. Sprawdź adres IP VPN, sieć docelową, trasę powrotną, NAT i regułę zapory ogniowej w zaporze Sophos. Sprawdź reguły zapory ogniowej za pomocą przeglądarki dzienników, testu zasad i przechwytywania pakietów zajmuje się tą diagnozą.
- Tylko konfiguracja protokołu IPsec lub SA nie powiodła się: Element Runbook po stronie zapory to Rozwiązywanie problemów z VPN IPsec zapory Sophos.
- Zasady SSL VPN lub konfiguracja bramy są nieprawidłowe: Konfiguracja należy do Konfigurowanie dostępu zdalnego SSL VPN, a nie do obejścia usługi klienta.
- Małe dostępy działają, duże transfery się zawieszają: Sprawdź MTU/MSS wzdłuż ścieżki. Oto co Sprawdź MTU i MSS zapory Sophos pod kątem problemów z VPN.
Received connection reset from gateway: <gateway name> pojawia się w scvpn.log dla SSL VPN, gdy zmieniają się ustawienia zapory, administrator rozłącza użytkownika albo Sophos Firewall uruchamia się ponownie. Zaimportuj aktualną konfigurację i połącz się ponownie. Same logi klienta nie wskazują jednoznacznie, która operacja nastąpiła po stronie zapory.
Utwórz kopię zapasową dzienników i raportów pomocy technicznej
Aby rozpocząć, otwórz Events lub wybierz Open VPN log z menu z trzema kropkami. Jeśli to możliwe, przed ponownym uruchomieniem zabezpiecz bieżący stan błędu: każdy plik logu podlega tylko jednej rotacji. Po ponownym uruchomieniu endpointu lub klienta poprzednia sesja znajduje się na przykład w openvpn.log.old, a nowa w openvpn.log. Dla logów nie udokumentowano maksymalnego rozmiaru; pliki .txt nie podlegają rotacji.
Dla komunikatu Received connection reset from gateway Sophos wskazuje plik scvpn.log w folderze instalacyjnym, ale nie publikuje ścieżki katalogu logów, która byłaby stała między wersjami Windows i macOS. Nie należy zgadywać ani wpisywać ścieżki na stałe — użyj Open VPN log lub raportu pomocy technicznej. Powyższe polecenia usługi macOS celowo używają udokumentowanej ścieżki bezwzględnej /Library/LaunchDaemons/com.sophos.connect.scvpn.plist.
Sophos Connect generuje scvpntsr.zip poprzez menu z trzema kropkami > About > Generate technical support report. Raport obejmuje konfiguracje VPN, zdarzenia połączeń, szczegóły provisioningu, informacje o uwierzytelnianiu SSO, szczegóły dotyczące przeglądarki i informacje o urządzeniu końcowym. Zawiera między innymi następujące pliki diagnostyczne:
openvpn.log: próby połączenia SSL VPN, status, interfejs wirtualny, przepływ pakietów i błędy.charon.log: strongSwan, IKE, ESP, zdarzenia bezpieczeństwa, zmiany konfiguracji i przepływ pakietów.scvpn.log: Logowanie, połączenie, rozłączenie i inne zdarzenia VPN.scgui.log: wersje Sophos Connect i OpenVPN, informacje o wersji WebView2 tylko w systemie Windows oraz logowania SSO. Nie należy z tego wyciągać wniosku, że macOS wymaga WebView2.configs.txt: Szczegóły importowanych połączeń.pro,.ovpni.scx; Sophos opisuje ten plik jako niezawierający żadnych danych osobowych.route.txt: Tabele routingu punktów końcowych.ipconfig.txt: Konfiguracja IP punktu końcowego.systeminfo.txt: Informacje o systemie końcowym.
Stwierdzenie o braku danych osobowych dotyczy wyłącznie configs.txt, a nie całego archiwum, i nie oznacza, że wszystkie zawarte w nim dane konfiguracyjne można bezpiecznie ujawniać. Przechowuj raport jako poufny materiał dla pomocy technicznej zgodnie z wewnętrznymi zasadami i udostępniaj go wyłącznie uprawnionym odbiorcom przez zatwierdzony kanał przesyłania. Nigdy nie kopiuj haseł, kodów OTP ani kluczy prywatnych do treści zgłoszenia lub publicznie udostępnianego fragmentu logu.
Dodatkowa kontrola SCCLI w macOS
Udokumentowana domyślna lokalizacja narzędzia SCCLI to /Library/Sophos\ Connect/. Na Macu objętym pilotażem najpierw sprawdź, czy faktycznie zainstalowany pakiet zawiera tam sccli i jakie opcje wskazuje jego lokalna pomoc. Poniższe przykłady tylko odczytują wersję i połączenia; nie stanowią informacji o przeprowadzonym tutaj teście działania w macOS ani potwierdzenia dystrybucji przez MDM czy możliwości przenoszenia skryptów z Windows:
/Library/Sophos\ Connect/sccli show --version
echo $?
/Library/Sophos\ Connect/sccli list -d
echo $?
Sprawdzaj status za pomocą echo $? bezpośrednio po każdym poleceniu SCCLI, zanim inne polecenie go nadpisze. W systemie Windows Command Prompt używa zamiast tego echo %ERRORLEVEL%; nie jest to składnia macOS. Powłoka zwraca status procesu, niekoniecznie niezmieniony numeryczny kod diagnostyczny z wewnętrznego komunikatu klienta. Jeśli brakuje pliku wykonywalnego lub nie można go uruchomić, sprawdź pakiet i stan instalacji; nie traktuj tego statusu jako testu tunelu.
Dokumentacja błędów podaje -1 dla nieprawidłowych opcji lub pustych danych logowania, 1 dla nieprawidłowych danych wejściowych lub danych, których nie można przeanalizować, 2 dla brakującego pliku lub pustego hasła/certyfikatu, 5 dla plików, których nie można odczytać, 14 dla odpowiedzi, której nie można przeanalizować, 101 dla nieudanego żądania i 120 dla brakujących danych serwera. 1016 oznacza żądanie danych logowania, 1024 oznacza „nie znaleziono połączenia”, 1101 oznacza nieudane logowanie, a 9009 — polecenie, którego nie znaleziono lub nie można uruchomić. Są to wskazówki diagnostyczne z dokumentacji, a nie gwarancja, że każdy z tych kodów pojawi się w macOS w dokładnie takiej postaci jako status powłoki. Zapisuj razem dokładny komunikat, status odczytany bezpośrednio po poleceniu i wersję klienta; przy błędach plików lub połączeń sprawdzaj źródło i nazwy, a przy błędach logowania wyjaśnij uprawnienia i uwierzytelnianie z działem IT, zamiast wielokrotnie zgadywać hasła.
SCCLI oferuje również add, remove, update, enable, disable, get i show; nie oznacza to, że jest to nowo wprowadzony zestaw poleceń ani że został sprawdzony dla każdej wersji klienta na Macu. Działania zmieniające stan nie należą do tego przykładu diagnostycznego: remove może najpierw rozłączyć aktywne połączenie i nie może usunąć połączenia zarządzanego; polityki mogą ograniczać add, remove lub disable. Auto-connect za pomocą add -a jest w źródle oznaczone jako TBD i nie jest tutaj przedstawiane jako działający sposób wdrożenia. Nigdy nie zapisuj haseł ani kodów OTP jako argumentów poleceń, w skryptach, historii powłoki ani logach. Jeśli osobno zatwierdzona procedura logowania korzysta z SCCLI, używaj interaktywnego monitu tego narzędzia, a nie udokumentowanych argumentów zawierających hasło. Pozostałe opcje sprawdź w pomocy zainstalowanego narzędzia; zmiany wprowadzaj tylko przy zabezpieczonym źródle profilu i zatwierdzonej procedurze wycofania zmian, a następnie przeprowadź test VPN.
Przeprowadź eskalację w sposób czysty
Sprawna skrzynka zawiera system operacyjny i kompilację, wersję Sophos Connect, typ profilu i źródło, czas błędu ze strefą czasową, dokładny tekst zdarzenia, oczekiwane miejsce docelowe, wynik według adresu IP i nazwy oraz scvpntsr.zip. W przypadku podejrzeń po stronie zapory sieciowej dodawany jest odpowiedni fragment przeglądarki dziennika oraz odpowiednie dzienniki protokołu IPsec lub SSL VPN; Usługi i dzienniki zapory Sophos je klasyfikują.
Eskaluj, jeśli usługa ponownie ulegnie awarii po pojedynczym kontrolowanym uruchomieniu, ten sam błąd może zostać odtworzony w profilu współdzielonym, tożsamość certyfikatu pozostaje niejasna lub konflikt sygnatur czasowych klienta i zapory ogniowej. Zgłoszenie do pomocy technicznej można przesłać w uporządkowany sposób, korzystając z opcji Przygotuj i otwórz zgłoszenie do pomocy technicznej Sophos.