Co to jest OAuth i dlaczego jest wymagane?

OAuth 2.0 (Open Authorization) to otwarty standard autoryzacji, który pozwala aplikacjom uzyskać dostęp do zasobów użytkownika bez konieczności podawania hasła bezpośrednio w tej aplikacji. Google wdrożyło OAuth jako jedyną metodę autoryzacji dla Gmail i innych usług Google w aplikacjach trzecich.

Korzyści z OAuth są znaczące:

• Bezpieczeństwo hasła: Twoje hasło Gmail nigdy nie jest widoczne dla eM Client ani nie jest na nim przechowywane
• Granularne uprawnienia: Możesz precyzyjnie kontrolować, do jakich danych Google ma dostęp eM Client
• Łatwe odwołanie: Możesz w dowolnym momencie cofnąć dostęp eM Client do konta bez zmiany hasła
• Ochrona przed phishingiem: Logujesz się na oficjalnej stronie Google, a nie przez nieznaną aplikację

Google wymusiło użycie OAuth dla wszystkich aplikacji, wyłączając w 2022 roku obsługę „mniej bezpiecznych aplikacji", które łączyły się przez zwykłe hasło. Jeśli próbujesz skonfigurować Gmail z hasłem bezpośrednio w polu IMAP, otrzymasz błąd autoryzacji.

Jak przebiega logowanie Gmail przez przeglądarkę

Gdy konfigurujesz konto Gmail w eM Client lub gdy token dostępu wygaśnie, uruchamiany jest następujący przepływ OAuth:

1. eM Client otwiera wewnętrzne okno (WebView2) lub zewnętrzną przeglądarkę z adresem strony logowania Google
2. Na stronie Google wpisujesz adres e-mail i hasło — nie w eM Client, tylko na stronie Google
3. Jeśli masz włączoną weryfikację dwuetapową (2FA), potwierdź tożsamość (SMS, aplikacja Authenticator, klucz sprzętowy)
4. Google wyświetla listę uprawnień, o które prosi eM Client (odczyt i wysyłanie poczty, dostęp do kalendarza, kontaktów)
5. Klikasz Zezwól lub Allow
6. Google przekazuje eM Client token dostępowy (refresh token) ważny przez długi czas
7. eM Client przechowuje ten token i używa go do kolejnych połączeń — bez konieczności ponownego logowania

Cały ten proces zwykle trwa mniej niż minutę. Po pomyślnej autoryzacji eM Client powinien automatycznie zsynchronizować pocztę, kalendarze i kontakty Google.

Problemy z oknem logowania (WebView2)

eM Client domyślnie używa komponentu WebView2 do wyświetlania strony logowania Google w wewnętrznym oknie aplikacji. Problemy mogą wystąpić w kilku sytuacjach:

Okno logowania jest puste lub nie ładuje się

Przyczyną może być przestarzały lub uszkodzony WebView2 Runtime. Rozwiązanie:

1. Wyszukaj w Google „Microsoft Edge WebView2 Runtime" i pobierz instalator ze strony Microsoft
2. Zainstaluj WebView2 Runtime
3. Uruchom eM Client ponownie i spróbuj ponownie autoryzować konto

Strona logowania wyświetla się w zewnętrznej przeglądarce

W niektórych wersjach eM Client lub przy określonych ustawieniach systemowych okno logowania może otworzyć się w domyślnej przeglądarce (Chrome, Firefox, Edge). Jest to normalne zachowanie — zaloguj się na stronie Google, a eM Client powinien automatycznie odebrać token autoryzacyjny.

Pętla logowania — Google ciągle prosi o zalogowanie

Ten problem może wynikać z konfliktu TLS 1.3. Jeśli Twój system Windows ma problemy z obsługą TLS 1.3, możliwe jest zablokowanie tej wersji protokołu. Poszukaj rozwiązania „DisableTLS1.3.reg" — jest to plik rejestru, który wyłącza TLS 1.3 w WebView2, zmuszając do użycia TLS 1.2.

Google blokuje logowanie z „nieznanej aplikacji"

Jeśli Google wykryje próbę logowania z nieznanego urządzenia lub lokalizacji, może wymagać dodatkowej weryfikacji. Sprawdź pocztę Gmail w przeglądarce — powinien tam być e-mail z powiadomieniem o próbie dostępu. Postępuj zgodnie z instrukcjami Google, aby potwierdzić dostęp.

Konta Google Workspace (firmowe)

Jeśli używasz konta Google Workspace (dawniej G Suite) — konta firmowego lub szkolnego — administrator IT może mieć dodatkowe ograniczenia dotyczące dostępu aplikacji trzecich.

Możliwe sytuacje:

• Dostęp do aplikacji innych firm jest zablokowany: Administrator wyłączył możliwość używania zewnętrznych klientów poczty. Skontaktuj się z administratorem IT
• eM Client nie jest na liście zatwierdzonych aplikacji: Administrator musi dodać eM Client do listy zaufanych aplikacji w Google Admin Console
• Wymagana jest weryfikacja urządzenia: Niektóre organizacje wymagają, aby urządzenie było zarejestrowane w systemie MDM

W przypadku kont firmowych Google Workspace, skontaktuj się z administratorem IT, jeśli autoryzacja OAuth nie powodzi się.

Alternatywa: hasło aplikacji

Jeśli z jakiegoś powodu autoryzacja OAuth nie działa, możesz skonfigurować Gmail w eM Client używając hasła aplikacji i protokołu IMAP/SMTP. Wymaga to jednak włączonej weryfikacji dwuetapowej na koncie Google.

1. Zaloguj się do konta Google w przeglądarce
2. Przejdź do Moje konto Google → Bezpieczeństwo
3. Włącz Weryfikację dwuetapową jeśli nie jest włączona
4. Wróć do sekcji Bezpieczeństwo i kliknij Hasła aplikacji
5. W polu „Aplikacja" wybierz Poczta, w polu „Urządzenie" — Komputer z Windows
6. Kliknij Generuj — Google wygeneruje 16-znakowe hasło aplikacji
7. W eM Client skonfiguruj konto Gmail ręcznie przez IMAP: serwer imap.gmail.com, port 993 (SSL), SMTP smtp.gmail.com, port 587 (STARTTLS)
8. Jako hasło użyj wygenerowanego hasła aplikacji (bez spacji)

Pamiętaj, że hasło aplikacji jest jednorazowe — po zamknięciu okna Google nie możesz go zobaczyć ponownie. Jeśli go zgubisz, musisz wygenerować nowe.

Ponowna autoryzacja konta Gmail

Jeśli eM Client prosi o ponowne zalogowanie do Gmail (token OAuth wygasł), wykonaj następujące kroki:

1. Przejdź do Menu → Narzędzia → Konta
2. Wybierz konto Gmail z ikoną błędu lub powiadomieniem
3. Kliknij przycisk Ponownie autoryzuj lub Napraw
4. Zaloguj się do Google w oknie, które się otworzy
5. Zatwierdź uprawnienia dla eM Client
6. Kliknij OK aby zamknąć ustawienia kont

Możesz też cofnąć dostęp eM Client do konta Google (przez myaccount.google.com → Bezpieczeństwo → Aplikacje z dostępem do konta) i autoryzować go od nowa — to pomaga gdy token jest uszkodzony lub nieprawidłowy.

Podsumowanie

Logowanie do Gmail przez przeglądarkę w eM Client to normalne i oczekiwane zachowanie wynikające z wymogów Google dotyczących używania OAuth 2.0. Dzięki temu Twoje hasło Gmail jest bezpieczne — eM Client nigdy go nie widzi ani nie przechowuje.

Jeśli okno logowania nie otwiera się lub jest puste, zaktualizuj WebView2 Runtime. Dla kont firmowych Google Workspace sprawdź z administratorem IT, czy zewnętrzne aplikacje mają dostęp. Alternatywnie możesz skonfigurować dostęp przez IMAP/SMTP z hasłem aplikacji generowanym w ustawieniach bezpieczeństwa Google.