Protokół OAuth2 jest preferowaną metodą łączenia wielu hostowanych kont pocztowych z usługą Nextcloud Mail, ponieważ dostawca poczty wydaje tokeny zamiast wymagać od Nextcloud korzystania ze standardowego hasła użytkownika do skrzynki pocztowej. W praktyce jednak, o dobrej konfiguracji nie świadczy pomyślne zamknięcie okna dialogowego zgody na uwierzytelnianie OAuth. Zaletą jest to, że Nextcloud Mail może ładować foldery przez IMAP, wysyłać pocztę przez SMTP, odświeżać uwierzytelnianie bez wielokrotnych monitów użytkownika i kontynuować te działania po wygaśnięciu pierwszego tokena dostępu.
W tym przewodniku omówiono dwie integracje OAuth, które aplikacja Nextcloud Mail dokumentuje bezpośrednio: konta Google oraz hostowane konta Microsoft Outlook/Microsoft 365. Na dzień 6 października 2026 r. w sklepie z aplikacjami Nextcloud App Store aplikacja Mail 5.12.3 była wymieniana jako stabilna wersja dla wersji Nextcloud od 32 do 35, natomiast w aktualnym podręczniku administratora opisano konfigurację Google OAuth i Microsoft XOAUTH2. Jeśli korzystasz ze starszej wersji aplikacji Mail, zaktualizuj ją w zakresie kompatybilności obsługiwanym przez serwer Nextcloud przed rozwiązywaniem problemów, które mogły już ulec zmianie.
Oficjalne źródła obejmują podręcznik administratora Nextcloud Mail , stronę Nextcloud Mail w sklepie z aplikacjami , dokumentację Google dotyczącą protokołów IMAP, POP i SMTP OAuth oraz dokumentację firmy Microsoft dotyczącą protokołów OAuth dla protokołów IMAP i SMTP .
Przed zmianą ustawień dostawcy zdefiniuj oczekiwany rezultat. Działająca konfiguracja powinna przejść wszystkie poniższe kontrole:
Jeśli konfiguracja przejdzie tylko etap akceptacji, ale nie testy IMAP i SMTP, należy ją uznać za niekompletną. Autoryzacja OAuth i dostęp do protokołu pocztowego to powiązane, ale oddzielne etapy.
Usługa Nextcloud Mail udostępnia obecnie wbudowaną obsługę protokołu OAuth dla kont Google i Microsoft. Serwery pocztowe Google obsługują protokół OAuth 2.0 z protokołem SASL XOAUTH2 dla protokołów IMAP i SMTP. Firma Microsoft dokumentuje obsługę protokołu OAuth2 dla protokołów IMAP, POP i SMTP w usługach Microsoft 365 i Outlook.com. Następnie usługa Nextcloud używa tokenu wydanego przez dostawcę podczas uwierzytelniania w protokołach pocztowych.
Nie należy zakładać, że każdy serwer pocztowy obsługujący OpenID Connect lub OAuth2 można umieścić w tym samym interfejsie. Prośba o rozszerzenie usługi Nextcloud Mail z 2026 r. dotycząca ogólnych zewnętrznych dostawców OAuth/OpenID pozostała rozszerzeniem, a nie udokumentowaną, ogólną ścieżką konfiguracji. Jeśli Twoim dostawcą nie jest ani Google, ani Microsoft, sprawdź obsługę tego konkretnego dostawcy przed wdrożeniem produkcyjnym opartym na OAuth2. Dyskusja na temat projektu jest dostępna w numerze dotyczącym ogólnego rozszerzenia usługi Nextcloud Mail dotyczącego OAuth2 .
Zaloguj się jako administrator Nextcloud, otwórz ustawienia administracyjne, przejdź do Groupware i znajdź integrację z Gmailem . Instrukcja administracji Nextcloud zaleca wprowadzenie w tej sekcji identyfikatora klienta Google i tajnego klucza klienta. Podczas konfigurowania Google użyj adresu URI przekierowania wyświetlanego przez Twoją instancję; nie rekonstruuj ścieżki na podstawie przykładu, ponieważ odwrotne proxy, zmiany w katalogu głównym witryny i układ wdrożenia mogą wpłynąć na zewnętrznie widoczny adres URL.
Kontrola jakości: adres URI przekierowania powinien używać produkcyjnej nazwy hosta HTTPS i być dostępny z przeglądarki użytkownika. Jeśli Nextcloud wyświetla wewnętrzną nazwę hosta, gdy użytkownicy uzyskują dostęp do publicznej nazwy hosta, należy najpierw poprawić konfigurację adresu URL Nextcloud/serwera proxy. OAuth nie zrekompensuje niezgodności publicznego adresu URL.
W Google Cloud skonfiguruj ustawienia Google Auth Platform/zgody dla projektu i utwórz klienta OAuth dla aplikacji internetowej . Dodaj adres URI przekierowania skopiowany z NextCloud jako autoryzowany adres URI przekierowania. Google wymaga, aby adres URI przekierowania w żądaniu autoryzacji dokładnie odpowiadał autoryzowanej wartości; schemat, wielkość liter, ścieżka i ukośnik na końcu mają znaczenie. Google dokumentuje to zachowanie w dokumencie „ Using OAuth 2.0 for Web Server Applications” .
Dostęp do poczty Gmail jest ważny z punktu widzenia zgodności. Google klasyfikuje szeroki zakres, obejmujący użycie protokołów IMAP, SMTP i POP3, jako zakres ograniczony. W zależności od tego, czy aplikacja jest wewnętrzna, testowana, czy przeznaczona do szerszego użytku produkcyjnego, mogą obowiązywać wymagania weryfikacji Google. Przed wdrożeniem dużej grupy użytkowników https://mail.google.com/zapoznaj się z dokumentacją Google dotyczącą zakresów ograniczonych oraz wskazówkami dotyczącymi weryfikacji aplikacji OAuth .
Wróć do Ustawień administracyjnych > Groupware > Integracja z Gmailem , wklej identyfikator klienta Google i tajny klucz klienta, a następnie zapisz. Unikaj ujawniania tajnego klucza na zrzutach ekranu, zgłoszeniach, historii powłoki ani udostępnionych notatkach. Jeśli później zmienisz tajny klucz klienta OAuth, zaktualizuj NextCloud niezwłocznie i zaplanuj kontrolowaną weryfikację istniejących kont.
Otwórz Nextcloud Mail jako użytkownik i dodaj konto Gmail. Aktualny kod pocztowy rozpoznaje Gmaila przez standardowe hosty IMAP/SMTP Gmaila i przełącza metodę uwierzytelniania na XOAUTH2, gdy administrator skonfigurował Google OAuth. Dokumenty Google imap.gmail.com:993obsługują IMAP przez SSL i smtp.gmail.comTLS na obsługiwanych portach SMTP.
Zaloguj się do Google i sprawdź ekran akceptacji. Dostawca może wyświetlić ostrzeżenia lub ograniczyć dostęp, jeśli aplikacja OAuth nie została skonfigurowana lub zweryfikowana pod kątem używanych zakresów i odbiorców.
Nie zatrzymuj się na „koncie połączonym”. Otwórz skrzynkę odbiorczą, otwórz co najmniej jedną wiadomość, wyślij wiadomość do drugiej skrzynki pocztowej, którą kontrolujesz, odpowiedz na nią i potwierdź połączenie w obie strony. Ten test dowodzi znacznie więcej niż samo przekierowanie OAuth.
Otwórz centrum administracyjne Microsoft Entra i utwórz rejestrację aplikacji. Przewodnik Nextcloud zaleca administratorom wybór typów kont, które umożliwiają korzystanie z kont Microsoft (zarówno organizacyjnych, jak i osobistych) oraz skonfigurowanie adresu URI przekierowania internetowego skopiowanego z Nextcloud. Jeśli Twoja organizacja celowo korzysta z jednego dzierżawcy, nie kopiuj bezmyślnie przykładu z wieloma dzierżawcami: dopasuj obsługiwane typy kont i ustawienia dzierżawcy do swojej polityki tożsamości.
Firma Microsoft wymaga rejestracji identyfikatorów URI przekierowania w aplikacji. Niezgodność może skutkować błędami, takimi jak AADSTS50011. Aktualne wytyczne firmy Microsoft znajdują się w dokumencie „ Najlepsze praktyki i ograniczenia dotyczące identyfikatorów URI przekierowania” .
Skopiuj identyfikator aplikacji (klienta) . Następnie otwórz sekcję Certyfikaty i klucze tajne , utwórz nowy klucz tajny klienta i natychmiast skopiuj jego wartość . Microsoft zapewnia, że wartość nie jest wyświetlana ponownie po opuszczeniu strony. Firma ogranicza również czas życia klucza tajnego klienta do 24 miesięcy lub mniej i zaleca krótszy okres wygaśnięcia w aktualnej dokumentacji rejestracji aplikacji.
Ta data wygaśnięcia jest zależnością operacyjną, a nie jednorazowym szczegółem instalacji. Umieść datę wygaśnięcia hasła w procesie rotacji danych uwierzytelniających w swojej organizacji. W przeciwnym razie pozornie stabilne wdrożenie Nextcloud Mail może później zakończyć się niepowodzeniem, ponieważ nie będzie można dokończyć odświeżania tokena.
W ustawieniach administracyjnych Nextcloud otwórz Groupware i obszar integracji z Microsoft. Wprowadź identyfikator klienta i tajny klucz klienta. Oficjalny przewodnik Nextcloud używa wartości dzierżawy commondla szerokiej konfiguracji hostowanego programu Outlook i wyraźnie ostrzega, że niestandardowy identyfikator dzierżawy wykracza poza ten podstawowy przewodnik, chyba że zmieniono również obsługiwane typy kont.
W przypadku uprawnień protokołu bazowego, Microsoft dokumentuje zakresy delegowane, w tym https://outlook.office.com/IMAP.AccessAsUser.Alldla IMAP i https://outlook.office.com/SMTP.SendSMTP, a także informacje o offline_accesstym, kiedy potrzebny jest token odświeżania. Nextcloud konstruuje przepływ dostawcy; nadal należy potwierdzić, czy zasady dzierżawy i reguły dostępu warunkowego zezwalają na żądany delegowany dostęp.
Dodaj adres Outlook lub Microsoft 365 w aplikacji Poczta Nextcloud i kontynuuj proces logowania/wyrażania zgody w systemie Microsoft. W podręczniku administratora Nextcloud wyjaśniono, że po skonfigurowaniu protokołu OAuth hasło wprowadzone podczas konfiguracji konta zostaje odrzucone, a użytkownik zostaje poproszony o wyrażenie zgody w systemie Microsoft.
Ponownie, widoczny wynik zgody to tylko sygnał pośredni. Sprawdź, czy lista folderów się załaduje, czy wiadomość testowa może zostać odczytana, czy wiadomość może zostać wysłana, a folder Wysłane zawiera oczekiwaną kopię.
| Sygnał | Co to znaczy | Co robić dalej |
|---|---|---|
| Wyrażenie zgody powiodło się, a skrzynka odbiorcza została załadowana | Autoryzacja i IMAP prawdopodobnie działają | Przetestuj wysyłanie i odświeżanie SMTP |
| Wyrażenie zgody powiodło się, ale foldery nie ładują się | Przekierowanie mogło zostać zakończone z powodu awarii połączenia pocztowego | Sprawdź politykę dostawcy, dostęp IMAP, logi Nextcloud i ustawienia konta |
| Odbieranie działa, ale wysyłanie się nie udaje | Protokół IMAP działa; autoryzacja SMTP lub polityka serwera mogą nie działać | Zweryfikuj usługę SMTP, uprawnienia delegowane i ograniczenia dzierżawcy/dostawcy |
| Na początku działa, ale później ciągle prosi o zalogowanie | Możliwe, że użycie tokena odświeżającego, ważność klucza tajnego, stan aplikacji lub polityka dostawcy nie działają | Sprawdź datę wygaśnięcia sekretu, stan publikacji/weryfikacji aplikacji OAuth, błędy tokena i ostatnie zmiany zasad |
| Błąd niezgodności przekierowania | Zarejestrowany adres URL wywołania zwrotnego nie jest dokładnie zgodny z żądaniem | Skopiuj ponownie URI z Nextcloud i porównaj go znak po znaku |
Zmień konfigurację aplikacji OAuth, jeśli adres URI przekierowania, obsługiwana grupa odbiorców konta, ustawienie dzierżawcy lub konfiguracja zgody nie pasują do wdrożenia. Wielokrotne próby nie naprawią niezgodności strukturalnej.
Zmień adres URL wdrożenia/konfigurację serwera proxy, gdy Nextcloud generuje wewnętrzny, HTTP lub inny niepoprawny publiczny adres zwrotny. Najpierw popraw kanoniczny zewnętrzny adres URL, a następnie utwórz ponownie lub zaktualizuj adres URI przekierowania dostawcy.
Używaj administracji specyficznej dla dostawcy zamiast ogólnych założeń OAuth, gdy dostęp warunkowy, zasady zgody administratora, weryfikacja aplikacji Google lub ograniczone zakresy uniemożliwiają użytkownikom ukończenie autoryzacji. Te mechanizmy kontroli są celowo egzekwowane przez dostawcę tożsamości.
Rozważ inną metodę uwierzytelniania tylko wtedy, gdy dostawca i Twoja polityka bezpieczeństwa wyraźnie na to zezwalają. Na przykład, interfejs Nextcloud Mail informuje, że hasło Google App może być alternatywą, gdy Google OAuth nie jest skonfigurowane, a konto Google korzysta z uwierzytelniania dwuskładnikowego. Nie jest to równoważne z OAuth2 i nie powinno być traktowane jako preferowany zamiennik w całej organizacji tylko dlatego, że jest prostsze w konfiguracji.
W historii projektu Nextcloud Mail występuje istotne zastrzeżenie diagnostyczne. W lipcu 2026 roku opiekunowie potwierdzili zgłoszenie błędu, w którym błędy OAuth po stronie dostawcy mogły nadal powodować wyświetlanie tej samej strony przekierowania „Połączono z kontem” co w przypadku pomyślnej autoryzacji. Raport dotyczył bezpośrednio firmy Microsoft i zidentyfikował ten sam wzorzec kontrolera dla Google. W oddzielnym raporcie z 2026 roku opisano trudności z ponownym połączeniem konta po tym, jak jego token odświeżania stał się bezużyteczny. Zgłoszenia te dotyczyły kodu z ery Mail 5.10.7; nie zakładaj, że każda wersja będzie miała ten problem na zawsze, ale nie używaj też strony przekierowania jako jedynego dowodu powodzenia.
Możesz zapoznać się z problemem obsługi błędów przekierowania OAuth i ponownego połączenia OAuth w projekcie . Jeśli rozwiązujesz problem z bieżącą wersją, najpierw sprawdź zainstalowaną wersję aplikacji Mail i najnowsze informacje o wydaniu, zanim zastosujesz obejścia opracowane dla starszej gałęzi.
OAuth2 ulepsza model uwierzytelniania dla Nextcloud Mail, ale nie eliminuje konieczności zarządzania polityką dostawcy, identyfikatorami URI przekierowań, poświadczeniami aplikacji i dostępem do protokołu pocztowego. Konfiguracja jest gotowa do produkcji, gdy cała ścieżka – autoryzacja dostawcy, odświeżanie tokenów, pobieranie IMAP i wysyłanie SMTP – działa przewidywalnie zgodnie z politykami obowiązującymi użytkowników.
Porównaj 10 narzędzi do pingowania, które umożliwiają szybkie wykrywanie sieci LAN, skanowanie międzyplatformowe i zarządzanie adresami IP. Dowiedz się, co narzędzie pingujące może Ci powiedzieć, a czego nie.
Porównaj sześć narzędzi do zarządzania siecią służących do monitorowania wydajności, obejmujących zasięg SNMP, mapowanie, alerty, modele wdrażania i kompromisy kosztów.
Porównaj siedem darmowych i otwartych monitorów pingów — od kompletnych pakietów sieciowych po ukierunkowane sondy opóźnień — i wybierz odpowiedni monitor pod kątem dostępności, utraty pakietów i historii.
Dowiedz się, co oznacza QoS w sieciach, w jaki sposób oznaczenia DSCP i kolejki ruchu nadają priorytet aplikacjom głosowym, wideo i biznesowym oraz czego QoS nie jest w stanie naprawić.
Porównaj niezawodne oprogramowanie serwera SFTP dla systemów Windows i Linux, w tym OpenSSH, Bitvise, SolarWinds i SFTPGo. Znajdź rozwiązanie odpowiednie dla swoich potrzeb w zakresie bezpieczeństwa i transferu plików.
Porównaj siedem narzędzi do zarządzania adresami IP służących do wykrywania podsieci, koordynacji DNS i DHCP, inwentaryzacji sieci i otwartego oprogramowania IPAM.
Porównaj sześć narzędzi do monitorowania systemu Windows Server pod kątem zbierania danych systemu Windows, widoczności aplikacji, modelu wdrażania i licencjonowania, aby znaleźć odpowiednie rozwiązanie.
Porównaj narzędzia do skanowania sieciowego umożliwiające szybkie wykrywanie urządzeń, skanowanie adresów IP na wielu platformach oraz zarządzanie IPAM w przedsiębiorstwie. Znajdziesz tu wskazówki dotyczące dopasowania każdej opcji do swojej sieci.
Zbuduj praktyczny monitoring sieci z przejrzystym zakresem urządzeń, przydatnymi wskaźnikami wydajności, przydatnymi alertami oraz porównaniem SolarWinds NPM, PRTG i OpManager.
Użyj opcji --traceroute programu Nmap, aby mapować przeskoki do autoryzowanego hosta, zrozumieć dane wyjściowe dotyczące przeskoków i czasu RTT oraz rozwiązywać problemy z brakującymi odpowiedziami bez nadmiernego skanowania.
