Połącz Gmaila lub Microsoft 365 z pocztą NextCloud za pomocą protokołu OAuth2

Aby połączyć Gmaila lub Microsoft 365 z Nextcloud Mail za pomocą OAuth2, zarejestruj aplikację internetową u dostawcy poczty, skopiuj adres URI przekierowania Nextcloud Mail do tej rejestracji i zapisz identyfikator klienta oraz klucz tajny w ustawieniach administracyjnych usługi grupowej Nextcloud. Następnie połącz skrzynkę pocztową w aplikacji Mail i zatwierdź monit logowania dostawcy. Działająca konfiguracja musi zarówno wczytywać wiadomości przychodzące, jak i wysyłać wiadomość testową — a nie tylko wyświetlać ekran pomyślnej autoryzacji.

Sprawdź, czy Twoje konto i instalacja Nextcloud pasują do tej metody

Usługa Nextcloud Mail używa protokołu IMAP do odczytu wiadomości i protokołu SMTP do ich wysyłania. OAuth2 uzyskuje pozwolenie od dostawcy tożsamości; XOAUTH2 to mechanizm, którego klient poczty używa do przedstawienia tokena dostępu do tych usług pocztowych. Nie zmienia on logowania Nextcloud w uniwersalne logowanie jednokrotne dla każdego serwera pocztowego.

Aktualna dokumentacja administracyjna Nextcloud opisuje dedykowaną integrację Gmail OAuth i Microsoft Outlook XOAUTH2. Obsługa Microsoft została dodana w Mail 3.0.0; treść menu może się różnić w zależności od wersji Mail i Nextcloud. Niniejszy przewodnik jest oparty na podręczniku administrowania Mail Nextcloud 35 , aktualnym od października 2026 r.

• Użyj adresu URL HTTPS Nextcloud, który otwiera się niezawodnie w przeglądarce, gdy masz zainstalowaną i włączoną aplikację Poczta.
• Uzyskaj dostęp administratora Nextcloud i uprawnienia do rejestracji aplikacji OAuth w Google Cloud lub Microsoft Entra.
• Sprawdź, czy jest to konto Gmail/Google Workspace, Outlook.com czy skrzynka pocztowa Microsoft 365 hostowana w usłudze Exchange Online.
• Sprawdź, czy dostawca zezwala na dostęp IMAP i uwierzytelnianie protokołu SMTP zgodnie z polityką organizacji, w celu wysyłania wiadomości.

Ważne ograniczenie: niestandardowy dostawca IMAP akceptujący OAuth2 nie jest automatycznie obsługiwany przez ekrany konfiguracji Gmail/Microsoft w usłudze Nextcloud Mail. Wniosek o funkcję Nextcloud Mail dla ogólnych dostawców OAuth2 dokumentuje tę różnicę. W przypadku innego dostawcy, sprawdź dokładną wersję swojej usługi Mail i obsługiwane przez nią metody uwierzytelniania, zamiast wprowadzać niepowiązane dane logowania Google lub Microsoft.

Zarejestruj klienta OAuth z właściwym adresem URI przekierowania

Gmail lub Google Workspace

1. W NextCloud zaloguj się jako administrator, otwórz Ustawienia administracyjne → Groupware i znajdź integrację z Gmailem . Skopiuj adres URI przekierowania wyświetlany przez Twoją instancję. Nie zakładaj, że adres URL skopiowany z instalacji innej osoby jest poprawny.
2. Otwórz Konsolę Google Cloud i wybierz lub utwórz projekt. Skonfiguruj ustawienia zgody/brandingu i odbiorców Google Auth Platform odpowiednio do organizacji Workspace lub użytkowników zewnętrznych; dodaj użytkowników testowych, jeśli aplikacja pozostaje w fazie testowania.
3. Utwórz klienta OAuth typu aplikacja internetowa . Wpisz dokładny adres URL z Nextcloud w polu Autoryzowane adresy URI przekierowania , a następnie bezpiecznie zapisz identyfikator klienta i klucz tajny klienta. Google wymaga dosłownego dopasowania adresu URI przekierowania, w tym schematu, ścieżki, wielkości liter i ukośnika.
4. Przejrzyj zakresy autoryzacji i wymagania dotyczące publikacji. Użycia dostępu IMAP i SMTP OAuth w Gmailu https://mail.google.com/to szeroki, ograniczony zakres podlegający zasadom Google dotyczącym danych użytkowników i weryfikacji. Administrator musi ustalić, czy proponowane użycie spełnia te wymagania.

Google dokumentuje proces rejestracji serwera WWW w instrukcjach dotyczących aplikacji internetowej OAuth2 oraz szczegółowy zakres i protokół XOAUTH2 dla Gmaila . Konfiguracja testowa jest przydatna do wstępnej walidacji, ale zewnętrzna aplikacja OAuth pozostawiona w trybie testowym zazwyczaj otrzymuje tokeny odświeżania, które wygasają po siedmiu dniach od momentu żądania dostępu do poczty Gmail. Zapoznaj się z wytycznymi Google dotyczącymi wygasania tokenów . Powtarzające się cotygodniowe ponowne autoryzacje mogą zatem wskazywać na ograniczenie stanu publikacji, a nie na zerwane hasło IMAP.

Microsoft 365 lub Outlook.com

1. W Ustawieniach administracyjnych Nextcloud → Groupware znajdź integrację z Microsoft i skopiuj wyświetlony adres URI przekierowania.
2. W centrum administracyjnym Microsoft Entra przejdź do sekcji Rejestracje aplikacji i utwórz rejestrację. W przypadku typów kont opisanych w standardowym przewodniku NextCloud wybierz zarówno konta Microsoft dla organizacji, jak i konta osobiste; skorzystaj z platformy przekierowania internetowego i wprowadź dokładnie adres URI NextCloud.
3. Skopiuj identyfikator aplikacji (klienta) . W sekcji „Certyfikaty i sekrety” utwórz sekret klienta i natychmiast skopiuj jego wartość , a nie identyfikator sekretu. Zapisz datę jego wygaśnięcia w kalendarzu operacji.
4. Użyj uprawnień delegowanych związanych z pocztą wymaganych dla przepływu IMAP i SMTP OAuth dostawcy, za zgodą organizacji, jeśli jest wymagana. Firma Microsoft dokumentuje zakresy i IMAP.AccessAsUser.Alltokeny odświeżania. Nie należy mylić tych uprawnień protokołu z uprawnieniami Microsoft Graph Mail.Read/Mail.Send.SMTP.Sendoffline_access

Szczegóły rejestracji można znaleźć w dokumentacji rejestracji aplikacji firmy Microsoft oraz w instrukcjach IMAP/SMTP OAuth w usłudze Exchange Online . Udokumentowana konfiguracja ogólnego przeznaczenia w NextCloud pozostawia pole dzierżawcy na poziomie common. Wartość specyficzna dla dzierżawcy lub węższa obsługiwana grupa odbiorców powinna być używana tylko wtedy, gdy administrator zweryfikuje powiązane zmiany typu konta i zasad.

Zapisz dane uwierzytelniające w NextCloud i połącz skrzynkę pocztową

1. Wróć do Ustawień administracyjnych → Groupware . Wklej identyfikator klienta i tajny klucz klienta dostawcy do odpowiedniej sekcji integracji z Gmailem lub Microsoft i zapisz. Nigdy nie umieszczaj tajnego klucza w polu URI przekierowania ani nie publikuj go na zrzutach ekranu, zgłoszeniach ani w systemie kontroli wersji.
2. Zaloguj się jako użytkownik skrzynki pocztowej, otwórz aplikację Poczta i wybierz opcję dodania konta pocztowego. Wprowadź adres e-mail, wybierz opcję automatycznej konfiguracji konta i rozpocznij łączenie. Udokumentowany przepływ pracy firmy Microsoft w NextCloud może nadal wyświetlać pole hasła; wprowadzony symbol zastępczy jest pomijany po skonfigurowaniu protokołu OAuth dostawcy. Nie zastępuj go prawdziwym hasłem do konta, jeśli nie jest to konieczne.
3. W oknie podręcznym dostawcy wybierz prawidłową tożsamość Google lub Microsoft, sprawdź żądany dostęp i wyraź zgodę, jeśli Twoja organizacja go zatwierdziła. Zezwól na wyskakujące okienka w przeglądarce i wróć do pierwotnej karty NextCloud po przekierowaniu przez dostawcę.
4. Jeśli automatyczna konfiguracja wybierze niewłaściwy serwer, sprawdź ręcznie wprowadzone nazwy hostów IMAP i SMTP oraz opcje szyfrowania dla danego dostawcy. Przycisk OAuth jest powiązany z rozpoznanymi punktami końcowymi Gmail/Microsoft; ręcznie wprowadzone, niepowiązane nazwy hostów mogą nie aktywować oczekiwanego procesu logowania.

W formularzu konta pocztowego Nextcloud, rozpoznany punkt końcowy Google ze skonfigurowanym OAuth może wyświetlać opcję Zaloguj się przez Google , a odpowiednik Microsoft – opcję Zaloguj się przez Microsoft . Źródło dokumentu formularza konta pocztowego Nextcloud na żywo dokumentuje te etykiety warunkowe. Obecność przycisku specyficznego dla dostawcy jest użytecznym, wczesnym sygnałem, że Nextcloud rozpoznał zamierzoną integrację, ale nie dowodzi, że autoryzacja lub dostęp do skrzynki pocztowej zostały zakończone.

Rozwiązuj awarie na etapie, na którym występują

Microsoft wyjaśnia mechanizm kontroli uwierzytelniania SMTP, w tym pomijanie poszczególnych skrzynek pocztowych, w dokumentacji uwierzytelniania SMTP w usłudze Exchange Online . Unikaj globalnego osłabiania zabezpieczeń poczty e-mail tylko po to, by jedna skrzynka pocztowa działała; jeśli zasady zabraniają użycia protokołu, użyj zatwierdzonego klienta poczty e-mail lub przepływu pracy obsługiwanego przez organizację.

Sprawdź przepływ poczty w obu kierunkach

1. Otwórz skrzynkę odbiorczą w aplikacji Nextcloud Mail, odśwież widok i sprawdź, czy pojawiła się ostatnio otrzymana wiadomość z oczekiwanym nadawcą, tematem i treścią.
2. Wyślij krótką wiadomość testową na inną kontrolowaną skrzynkę pocztową. Sprawdź tam dostarczoną wiadomość, a następnie sprawdź folder Wysłane w usłudze NextCloud Mail. To pozwoli oddzielić problemy z uprawnieniami SMTP od problemów z synchronizacją IMAP.
3. Wyloguj się i zaloguj ponownie, a następnie ponownie otwórz aplikację Mail. W przypadku wdrożeń operacyjnych sprawdź ponownie po odświeżeniu tokena dostępu; natychmiastowy sukces nie oznacza, że ​​token zostanie odnowiony na długi czas.

Jeśli skrzynka odbiorcza nadal nie synchronizuje się, Nextcloud oferuje dokumenty occ mail:account:exportumożliwiające znalezienie identyfikatora konta pocztowego i occ mail:account:sync -vvv ACCOUNT_IDukierunkowane rozwiązywanie problemów. Podręcznik rozwiązywania problemów z pracą grupową wyjaśnia również rejestrowanie debugowania IMAP/SMTP dla poszczególnych kont i ostrzega, że ​​logi mogą zawierać poufne informacje. Przechwytuj tylko potrzebne dane, usuwaj tokeny i adresy przed udostępnieniem i wyłącz szczegółowe debugowanie po udostępnieniu.

Konfiguracja jest gotowa do użycia po uzyskaniu zgody dostawcy. Mail może pobrać bieżące wiadomości, poczta wychodząca dociera do adresata, a połączenie pozostaje użyteczne bez wielokrotnych monitów o autoryzację. Jeśli którykolwiek z tych testów się nie powiedzie, rozwiąż problem na tym konkretnym etapie, zamiast od razu tworzyć całą aplikację OAuth.