OAuth2 è il metodo preferito per connettere molti account di posta elettronica ospitati a Nextcloud Mail, poiché il provider di posta elettronica rilascia token anziché richiedere a Nextcloud di continuare a utilizzare la normale password della casella di posta dell'utente. In pratica, tuttavia, una buona configurazione non si misura semplicemente dalla chiusura corretta della finestra di consenso OAuth. Il risultato utile è che Nextcloud Mail può caricare le cartelle tramite IMAP, inviare email tramite SMTP, aggiornare l'autenticazione senza richiedere ripetutamente l'autenticazione all'utente e continuare a farlo anche dopo la scadenza del primo token di accesso.
Questa guida illustra le due integrazioni OAuth documentate direttamente da Nextcloud Mail: account Google e account Microsoft Outlook/Microsoft 365 ospitati. Al 6 ottobre 2026, l'App Store di Nextcloud elenca Mail 5.12.3 come versione stabile per Nextcloud dalla 32 alla 35, mentre il manuale di amministrazione corrente documenta la configurazione di Google OAuth e Microsoft XOAUTH2. Se si utilizza una versione precedente di Mail, è necessario aggiornarla entro l'intervallo di compatibilità supportato dal server Nextcloud prima di tentare di risolvere problemi relativi a comportamenti che potrebbero essere già cambiati.
Le fonti ufficiali utilizzate in questo documento includono il manuale di amministrazione di Nextcloud Mail , la pagina di Nextcloud Mail sull'App Store , la documentazione OAuth di Google per IMAP, POP e SMTP e la documentazione OAuth di Microsoft per IMAP e SMTP .
Prima di modificare le impostazioni del provider, definisci il risultato che ti aspetti. Una configurazione funzionante dovrebbe superare tutti questi controlli:
Se la configurazione supera solo la fase di richiesta di consenso ma non i test IMAP e SMTP, considerala incompleta. L'autorizzazione OAuth e l'accesso al protocollo di posta sono fasi correlate ma distinte.
Nextcloud Mail attualmente offre la gestione integrata dell'autenticazione OAuth per gli account Google e Microsoft. I server di posta di Google supportano OAuth 2.0 con SASL XOAUTH2 per IMAP e SMTP. Microsoft documenta il supporto di OAuth2 per IMAP, POP e SMTP in Microsoft 365 e Outlook.com. Nextcloud utilizza quindi il token rilasciato dal provider per l'autenticazione ai protocolli di posta.
Non date per scontato che qualsiasi server di posta compatibile con OpenID Connect o OAuth2 possa essere integrato nella stessa interfaccia. Una richiesta di miglioramento per Nextcloud Mail del 2026 relativa a provider OAuth/OpenID di terze parti generici è rimasta un miglioramento e non un percorso di configurazione generale documentato. Se il vostro provider non è né Google né Microsoft, verificate il supporto specifico per quel provider prima di implementare una soluzione di produzione basata su OAuth2. La discussione sul progetto è disponibile nella discussione relativa al miglioramento generico di OAuth2 per Nextcloud Mail .
Accedi come amministratore di Nextcloud, apri le impostazioni di amministrazione, vai su Groupware e trova l'integrazione con Gmail . Il manuale di amministrazione di Nextcloud indica di inserire un ID client e un segreto client di Google in questa sezione. Utilizza l'URI di reindirizzamento visualizzato dalla tua istanza quando configuri Google; non ricostruire il percorso da un esempio perché i proxy inversi, le modifiche alla directory principale del sito web e la configurazione dell'implementazione possono influenzare l'URL visibile esternamente.
Controllo qualità: l'URI di reindirizzamento deve utilizzare il nome host HTTPS di produzione ed essere raggiungibile dal browser dell'utente. Se Nextcloud mostra un nome host interno mentre gli utenti accedono a un nome host pubblico, correggere prima la configurazione dell'URL di Nextcloud/proxy. OAuth non compenserà un URL pubblico non corrispondente.
In Google Cloud, configura le impostazioni di Google Auth Platform/consenso per il progetto e crea un client OAuth per un'applicazione Web . Aggiungi l'URI di reindirizzamento copiato da Nextcloud come URI di reindirizzamento autorizzato. Google richiede che l'URI di reindirizzamento nella richiesta di autorizzazione corrisponda esattamente a un valore autorizzato; schema, maiuscole/minuscole, percorso e barra finale sono importanti. Google documenta questo comportamento in Utilizzo di OAuth 2.0 per applicazioni server Web .
L'accesso alla posta Gmail è importante dal punto di vista della conformità. Google classifica l'ambito ampio , che include l'utilizzo di IMAP, SMTP e POP3, come ambito limitato. A seconda che l'app sia interna, in fase di test o destinata a un utilizzo più ampio in produzione, potrebbero essere applicati i requisiti di verifica di Google. Prima di integrare un numero elevato di utenti, è https://mail.google.com/consigliabile consultare la documentazione di Google sugli ambiti limitati e le linee guida per la verifica delle app OAuth.
Torna alle impostazioni di amministrazione > Groupware > Integrazione Gmail , incolla l'ID client e il segreto client di Google e salva. Evita di esporre il segreto in screenshot, ticket, cronologia della shell o note condivise. Se in seguito modifichi il segreto client OAuth, aggiorna Nextcloud tempestivamente e pianifica una verifica controllata degli account esistenti.
Apri Nextcloud Mail come utente e aggiungi l'account Gmail. Il codice di Mail attuale riconosce Gmail tramite gli host IMAP/SMTP standard di Gmail e passa al metodo di autenticazione XOAUTH2 quando l'amministratore ha configurato Google OAuth. Google documenta imap.gmail.com:993l'utilizzo di IMAP su SSL e smtp.gmail.comcon TLS sulle porte SMTP supportate.
Continua con l'accesso a Google e rivedi la schermata di consenso. Il fornitore potrebbe mostrare avvisi o limitare l'accesso se l'app OAuth non è stata configurata o verificata per gli ambiti e il pubblico utilizzati.
Non fermarti alla semplice "connessione dell'account". Apri la Posta in arrivo, apri almeno un messaggio, invia un messaggio a una seconda casella di posta che controlli, rispondi e conferma l'avvenuta connessione. Questo test dimostra molto più del solo reindirizzamento OAuth.
Apri il Centro di amministrazione di Microsoft Entra e crea una registrazione dell'app. La guida di Nextcloud indica agli amministratori di scegliere tipi di account che consentano account Microsoft sia aziendali che personali, come esempio generale, e di configurare un URI di reindirizzamento Web copiato da Nextcloud. Se la tua organizzazione utilizza deliberatamente un singolo tenant, non copiare ciecamente l'esempio multi-tenant: allinea i tipi di account supportati e le impostazioni del tenant con i tuoi criteri di identità.
Microsoft richiede che gli URI di reindirizzamento siano registrati nell'applicazione. Una mancata corrispondenza può causare errori come AADSTS50011. Le linee guida attuali di Microsoft sono disponibili in Procedure consigliate e limitazioni per gli URI di reindirizzamento .
Copia l' ID dell'applicazione (client) . Quindi apri Certificati e segreti , crea un nuovo segreto client e copia immediatamente il valore del segreto . Microsoft afferma che il valore non viene più visualizzato dopo aver lasciato la pagina. Inoltre, limita la durata del segreto client a 24 mesi o meno e raccomanda un periodo di scadenza più breve nella sua documentazione attuale sulla registrazione delle app.
Quella data di scadenza è una dipendenza operativa, non un dettaglio di installazione da impostare una sola volta. Includi la data di scadenza del segreto nel processo di rotazione delle credenziali della tua organizzazione. In caso contrario, un'implementazione di Nextcloud Mail apparentemente stabile potrebbe in seguito fallire perché l'aggiornamento del token non può più essere completato.
Nelle impostazioni di amministrazione di Nextcloud, apri Groupware e l'area di integrazione con Microsoft. Inserisci l'ID client e il segreto client. La guida ufficiale di Nextcloud utilizza il valore del tenant commonper la configurazione generica di Outlook ospitato e avverte esplicitamente che un ID tenant personalizzato non rientra in tale guida di base, a meno che non siano stati modificati anche i tipi di account supportati.
Per quanto riguarda le autorizzazioni del protocollo sottostante, Microsoft documenta gli ambiti delegati, inclusi quelli https://outlook.office.com/IMAP.AccessAsUser.Allper IMAP e https://outlook.office.com/SMTP.SendSMTP, oltre offline_accessa specificare quando è necessario un token di aggiornamento. Nextcloud gestisce il flusso del provider; è comunque necessario verificare che le policy del tenant e le regole di accesso condizionale consentano l'accesso delegato richiesto.
Aggiungi l'indirizzo Outlook o Microsoft 365 a Nextcloud Mail e prosegui con la procedura di accesso/consenso di Microsoft. Il manuale di amministrazione di Nextcloud spiega che, una volta configurato OAuth, la password inserita durante la configurazione dell'account viene ignorata e all'utente viene richiesto il consenso di Microsoft.
Anche in questo caso, il risultato del consenso visibile è solo un segnale intermedio. Verifica che l'elenco delle cartelle venga caricato, che un messaggio di prova possa essere letto, che un messaggio possa essere inviato e che la cartella Posta inviata contenga la copia prevista.
| Segnale | Cosa significa | Cosa fare dopo? |
|---|---|---|
| Il consenso è stato concesso e la Posta in arrivo è stata caricata. | L'autorizzazione e IMAP probabilmente funzionano | Verifica il comportamento di invio e aggiornamento SMTP |
| Il consenso è stato dato correttamente, ma le cartelle non vengono caricate. | Il reindirizzamento potrebbe essere stato completato mentre la connessione di posta non è andata a buon fine. | Verifica le policy del provider, l'accesso IMAP, i log di Nextcloud e le impostazioni dell'account. |
| La ricezione funziona, ma l'invio fallisce. | IMAP funziona; l'autorizzazione SMTP o le policy del server potrebbero non funzionare | Verificare il servizio SMTP, le autorizzazioni delegate e le restrizioni imposte dal tenant/provider. |
| Inizialmente funziona, ma in seguito richiede ripetutamente l'accesso. | L'utilizzo del token di aggiornamento, la validità del segreto, lo stato dell'app o le policy del fornitore potrebbero non funzionare. | Controlla la scadenza del segreto, lo stato di pubblicazione/verifica dell'app OAuth, gli errori del token e le recenti modifiche alle policy. |
| Errore di mancata corrispondenza del reindirizzamento | L'URL di callback registrato non corrisponde esattamente alla richiesta | Copia nuovamente l'URI da Nextcloud e confrontalo carattere per carattere. |
Modifica la configurazione dell'applicazione OAuth quando l'URI di reindirizzamento, il pubblico dell'account supportato, l'impostazione del tenant o la configurazione del consenso non corrispondono alla tua implementazione. Ripetere i tentativi non risolverà un'incongruenza strutturale.
Modifica la configurazione dell'URL di distribuzione/proxy quando Nextcloud genera un indirizzo di callback pubblico interno, HTTP o comunque errato. Correggi prima l'URL esterno canonico, quindi ricrea o aggiorna l'URI di reindirizzamento del provider.
Quando l'accesso condizionale, i criteri di consenso amministrativo, la verifica delle app Google o gli ambiti limitati impediscono agli utenti di completare l'autorizzazione, è necessario utilizzare le impostazioni amministrative specifiche del provider anziché le ipotesi generiche di OAuth . Questi controlli vengono applicati intenzionalmente dal provider di identità.
Valutate un metodo di autenticazione diverso solo se il provider e le vostre policy di sicurezza lo consentono esplicitamente. Ad esempio, l'interfaccia di Nextcloud Mail indica che la password per le app di Google può essere un'alternativa quando Google OAuth non è configurato e l'account Google utilizza l'autenticazione a due fattori. Questo non è equivalente a OAuth2 e non dovrebbe essere considerato il metodo di autenticazione preferenziale a livello aziendale solo perché è più semplice da configurare.
Nella cronologia del progetto Nextcloud Mail è presente un'importante avvertenza diagnostica. Nel luglio 2026, i manutentori hanno confermato una segnalazione di bug per cui gli errori OAuth lato provider potevano comunque generare la stessa pagina di reindirizzamento "Account connesso" come se l'autorizzazione fosse andata a buon fine. La segnalazione riguardava direttamente Microsoft e identificava lo stesso schema di controller anche per Google. Un'altra segnalazione del 2026 descriveva la difficoltà di riconnettere un account dopo che il suo token di aggiornamento era diventato inutilizzabile. Queste segnalazioni si riferivano al codice della versione 5.10.7 di Mail; non bisogna quindi presumere che tutte le versioni siano interessate per sempre, ma è anche importante non utilizzare la pagina di reindirizzamento come unica prova di successo.
È possibile esaminare il problema relativo alla gestione degli errori di reindirizzamento OAuth e il problema di riconnessione OAuth del progetto . Se si sta risolvendo un problema con una versione corrente, verificare prima la versione di Mail installata e le note di rilascio più recenti prima di applicare soluzioni alternative scritte per un ramo precedente.
OAuth2 migliora il modello di autenticazione per Nextcloud Mail, ma non elimina la necessità di gestire le policy del provider, gli URI di reindirizzamento, le credenziali dell'applicazione e l'accesso al protocollo di posta. Una configurazione è pronta per la produzione quando l'intero percorso (autorizzazione del provider, aggiornamento del token, recupero IMAP e invio SMTP) funziona in modo prevedibile in base alle policy applicate ai tuoi utenti.
Risolvi gli errori di decrittazione di Element Web verificando la verifica del dispositivo, il backup delle chiavi, le chiavi di ripristino e le chiavi della stanza mancanti, senza rischiare di perdere la cronologia dei messaggi.
Scopri come abilitare i provider di autenticazione a due fattori di Nextcloud, imporre l'autenticazione a due fattori per utenti o gruppi, preparare il ripristino e verificare gli accessi e le app client.
Con zimbraMtaMyNetworks, limita l'inoltro di email in uscita non autenticate in Zimbra agli indirizzi IP attendibili. Scopri come ispezionare, aggiornare, ricaricare e verificare la lista degli indirizzi consentiti in modo sicuro.
Imposta il valore di `memory_limit` di PHP ad almeno 512 MB per Nextcloud, trova la configurazione PHP web corretta, riavvia Apache o PHP-FPM e verifica che l'avviso sia scomparso.
Configura Coturn con Synapse per le chiamate Matrix WebRTC. Configura le credenziali condivise, il NAT, le porte del firewall, le opzioni TLS e distingui TURN (versione legacy) da MatrixRTC e LiveKit.
Configura Nextcloud Mail con OAuth2 per Gmail o Microsoft 365, verifica l'accesso IMAP/SMTP, risolvi i problemi di reindirizzamento e conosci i limiti.
Risolvi l'avviso di sessione "Impossibile verificare l'identità" di Element verificando l'identità con un altro dispositivo attendibile o con una chiave di ripristino e scopri quando è possibile eseguire un ripristino in sicurezza.
Confronta la migrazione da Kopano a grommunio e Zammad. Scopri quali dati della casella di posta elettronica ciascun metodo può conservare, come effettuare un test e verificare i risultati e quando è opportuno utilizzare IMAP o un'importazione personalizzata.
Spostare una directory di dati Nextcloud su un disco rigido esterno senza interrompere i riferimenti ai file. Utilizzare in tutta sicurezza backup, un mount persistente, rsync, permessi e un collegamento simbolico.
Risolvere i problemi relativi ai timer cron di systemd di Nextcloud su Ubuntu verificando l'utente del servizio, i percorsi di PHP e Nextcloud, l'attivazione del timer e la cronologia di esecuzione dei processi.
