Conectați Gmail sau Microsoft 365 la Nextcloud Mail folosind OAuth2

Pentru a conecta Gmail sau Microsoft 365 la Nextcloud Mail cu OAuth2, înregistrați o aplicație web la furnizorul de e-mail, copiați URI-ul de redirecționare al Nextcloud Mail în înregistrarea respectivă și salvați ID-ul clientului și secretul în setările de administrare Groupware ale Nextcloud. Apoi conectați cutia poștală în Mail și aprobați solicitarea de conectare a furnizorului. O configurare funcțională trebuie atât să încarce mesajele primite, cât și să trimită un mesaj de test - nu doar să afișeze un ecran de autorizare reușită.

Verifică dacă contul tău și instalarea Nextcloud se potrivesc acestei metode

Nextcloud Mail folosește IMAP pentru a citi mesajele și SMTP pentru a le trimite. OAuth2 obține permisiunea de la furnizorul de identitate; XOAUTH2 este mecanismul pe care clientul de mail îl folosește pentru a prezenta un token de acces acestor servicii de mail. Nu transformă autentificarea Nextcloud într-o autentificare unică universală pentru fiecare server de mail.

Documentația actuală de administrare a Nextcloud descrie integrări dedicate Gmail OAuth și Microsoft Outlook XOAUTH2. Asistența Microsoft a fost adăugată în Mail 3.0.0; textul meniului poate varia în funcție de versiunile de Mail și Nextcloud. Această prezentare detaliată se bazează pe manualul de administrare Nextcloud 35 Mail , actualizat la data verificării din octombrie 2026.

• Folosește o adresă URL Nextcloud HTTPS care se deschide în mod fiabil dintr-un browser, cu aplicația Mail instalată și activată.
• Să aveți acces de administrator Nextcloud și permisiunea de a înregistra o aplicație OAuth în Google Cloud sau Microsoft Entra.
• Aflați dacă este vorba de un cont Gmail/Google Workspace, Outlook.com sau o cutie poștală Microsoft 365 găzduită în Exchange Online.
• Confirmați că furnizorul permite accesul IMAP și, pentru trimitere, SMTP autentificat conform politicilor organizației.

Limită importantă: un furnizor IMAP personalizat care acceptă OAuth2 nu este acceptat automat de ecranele de configurare Gmail/Microsoft ale Nextcloud Mail. Solicitarea funcției Nextcloud Mail pentru furnizorii generici OAuth2 documentează această distincție. Pentru un alt furnizor, verificați versiunea exactă de Mail și metodele de autentificare acceptate, în loc să introduceți acreditări Google sau Microsoft fără legătură.

Înregistrați un client OAuth cu URI-ul de redirecționare corect

Gmail sau Google Workspace

1. În Nextcloud, conectați-vă ca administrator, deschideți Setări administrare → Groupware și localizați integrarea Gmail . Copiați URI-ul de redirecționare afișat de instanța dvs. Nu presupuneți că un URL copiat din instalarea altcuiva este corect.
2. Deschideți Google Cloud Console și selectați sau creați un proiect. Configurați setările de consimțământ/branding și de public pentru Google Auth Platform, în funcție de organizația Workspace sau de utilizatorii externi; adăugați utilizatori de testare dacă aplicația rămâne în Testare.
3. Creați un client OAuth de tip aplicație web . Introduceți adresa URL exactă din Nextcloud în URI-uri de redirecționare autorizate , apoi salvați ID-ul clientului și secretul clientului în siguranță. Google necesită o potrivire literală a URI-ului de redirecționare, inclusiv schema, calea, scrierea cu majuscule și bara oblică finală.
4. Examinați domeniile de aplicare ale autorizării și cerințele de publicare. Utilizările accesului Gmail IMAP și SMTP OAuth https://mail.google.com/, un domeniu de aplicare larg și restricționat, supus politicilor Google privind datele utilizatorilor și verificarea. Administratorul trebuie să stabilească dacă utilizarea propusă poate îndeplini aceste cerințe.

Google documentează fluxul de înregistrare a serverului web în instrucțiunile aplicației web OAuth2 și în domeniul de aplicare și protocolul specific Gmail XOAUTH2 . O configurație de testare este utilă pentru validarea inițială, dar o aplicație OAuth externă lăsată în Testare primește, în general, token-uri de actualizare care expiră după șapte zile atunci când solicită acces la e-mailul Gmail. Consultați instrucțiunile Google privind expirarea token-urilor . Prin urmare, reautorizarea săptămânală repetată poate indica o limitare a stării de publicare, mai degrabă decât o parolă IMAP nefuncțională.

Microsoft 365 sau Outlook.com

1. În setările de administrare → Groupware ale Nextcloud , găsiți integrarea Microsoft și copiați URI-ul de redirecționare afișat.
2. În centrul de administrare Microsoft Entra , accesați Înregistrări aplicații și creați o înregistrare. Pentru tipurile de conturi descrise în ghidul standard Nextcloud, alegeți atât conturi Microsoft organizaționale, cât și personale; utilizați o platformă de redirecționare web și introduceți exact URI-ul Nextcloud.
3. Copiați ID-ul aplicației (client) . Sub Certificate și secrete , creați un secret client și copiați imediat valoarea sa , nu identificatorul secretului. Înregistrați expirarea sa în calendarul de operațiuni.
4. Utilizați permisiunile delegate legate de e-mail necesare pentru fluxul IMAP și SMTP OAuth al furnizorului, cu acordul organizației, acolo unde este necesar. Microsoft documentează domeniile de aplicare IMAP.AccessAsUser.Allși SMTP.Senddomeniile de aplicare, precum și offline_accesspentru token-urile de reîmprospătare. Nu confundați aceste permisiuni de protocol cu ​​permisiunile Microsoft Graph Mail.Read/Mail.Send.

Pentru detalii despre înregistrare, consultați documentația de înregistrare a aplicațiilor Microsoft și instrucțiunile IMAP/SMTP OAuth de la Exchange Online . Configurarea generală documentată a Nextcloud lasă câmpul chiriașului la common. O valoare specifică chiriașului sau un public acceptat mai restrâns trebuie utilizat numai atunci când administratorul a verificat tipul de cont asociat și modificările de politică.

Salvați acreditările în Nextcloud și conectați căsuța poștală

1. Reveniți la setările de administrare → Groupware . Lipiți ID-ul clientului și secretul clientului furnizorului în secțiunea corespunzătoare de integrare Gmail sau integrare Microsoft și salvați. Nu introduceți niciodată secretul în câmpul URI de redirecționare și nu îl publicați în capturi de ecran, tichete sau control al versiunilor.
2. Conectați-vă ca utilizatorul cutiei poștale dorite, deschideți Mail și alegeți să adăugați un cont de e-mail. Introduceți adresa sa de e-mail, selectați mai întâi configurarea automată a contului și începeți conectarea. Fluxul Microsoft documentat al Nextcloud poate prezenta în continuare un câmp pentru parolă; titlul introdus este eliminat atunci când se configurează OAuth-ul furnizorului. Nu înlocuiți inutil parola unui cont real.
3. În fereastra pop-up a furnizorului, selectați identitatea Google sau Microsoft corectă, verificați accesul solicitat și acordați consimțământul dacă este aprobat de organizația dvs. Permiteți ferestrele pop-up din browser și reveniți la fila Nextcloud originală după ce furnizorul redirecționează înapoi.
4. Dacă configurarea automată selectează serverul greșit, verificați numele de gazdă IMAP și SMTP manuale și opțiunile de criptare pentru furnizorul respectiv. Butonul OAuth este asociat cu endpoint-uri Gmail/Microsoft recunoscute; numele de gazdă fără legătură introduse manual pot să nu activeze fluxul de conectare așteptat.

În formularul contului Nextcloud Mail, un endpoint Google recunoscut cu OAuth configurat poate afișa Conectați-vă cu Google , iar echivalentul Microsoft poate afișa Conectați-vă cu Microsoft . Sursa formularului contului Nextcloud Mail live documentează aceste etichete condiționale. Prezența butonului specific furnizorului este un semn timpuriu util că Nextcloud a recunoscut integrarea intenționată, dar nu dovedește că autorizarea sau accesul la cutia poștală s-au finalizat.

Rezolvați defecțiunile în funcție de etapa în care apar

Microsoft explică controlul SMTP AUTH, inclusiv suprascrierea per cutie poștală, în documentația sa Exchange Online SMTP AUTH . Evitați slăbirea globală a securității e-mailurilor doar pentru a face o singură cutie poștală să funcționeze; dacă politica interzice protocolul, utilizați în schimb un client de e-mail aprobat sau un flux de lucru acceptat de organizație.

Verificați ambele direcții ale fluxului de corespondență

1. Deschideți Inbox în Nextcloud Mail, actualizați pagina și confirmați că apare un mesaj primit recent cu expeditorul, subiectul și conținutul așteptate.
2. Trimiteți un scurt e-mail de test către o altă cutie poștală pe care o controlați. Verificați livrarea acolo, apoi verificați folderul Trimis din Nextcloud Mail. Aceasta separă problemele legate de permisiunile SMTP de problemele legate de sincronizarea IMAP.
3. Deconectați-vă și reconectați-vă, apoi redeschideți Mail. Pentru implementările operaționale, verificați din nou după ce tokenul de acces ar fi fost în mod normal actualizat; succesul imediat nu dovedește reînnoirea tokenului pe termen lung.

Dacă sincronizarea inbox-ului continuă să nu se realizeze, Nextcloud documentează problemele occ mail:account:exportpentru a găsi ID-ul contului de e-mail și occ mail:account:sync -vvv ACCOUNT_IDpentru depanare specifică. Manualul său de depanare Groupware explică, de asemenea, înregistrarea în jurnal a depanării IMAP/SMTP pentru fiecare cont și avertizează că jurnalele pot conține informații sensibile. Capturați doar ceea ce este necesar, redactați token-urile și adresele înainte de partajare și dezactivați depanarea detaliată ulterior.

Configurarea este gata de utilizare după finalizarea acordului furnizorului, Mail poate prelua mesajele curente, e-mailurile trimise ajung la destinație, iar conexiunea rămâne utilizabilă fără solicitări repetate de autorizare. Dacă oricare dintre aceste verificări eșuează, depanați etapa respectivă în loc să recreați imediat întreaga aplicație OAuth.