Collega Gmail o Microsoft 365 a Nextcloud Mail tramite OAuth2

Per connettere Gmail o Microsoft 365 a Nextcloud Mail tramite OAuth2, è necessario registrare un'applicazione web presso il provider di posta elettronica, copiare l'URI di reindirizzamento di Nextcloud Mail nella registrazione e salvare l'ID client e il segreto nelle impostazioni di amministrazione di Groupware di Nextcloud. Successivamente, è necessario connettere la casella di posta in Mail e approvare la richiesta di accesso del provider. Una configurazione funzionante deve sia caricare i messaggi in arrivo che inviare un messaggio di prova, non limitarsi a visualizzare una schermata di autorizzazione riuscita.

Verifica che il tuo account e l'installazione di Nextcloud siano compatibili con questo metodo.

Nextcloud Mail utilizza IMAP per leggere i messaggi e SMTP per inviarli. OAuth2 ottiene l'autorizzazione dal provider di identità; XOAUTH2 è il meccanismo che il client di posta utilizza per presentare un token di accesso a questi servizi di posta. Non trasforma l'accesso a Nextcloud in un single sign-on universale per ogni server di posta.

La documentazione di amministrazione di Nextcloud descrive le integrazioni dedicate con Gmail OAuth e Microsoft Outlook XOAUTH2. Il supporto per Microsoft è stato aggiunto nella versione 3.0.0 di Mail; la terminologia dei menu potrebbe variare a seconda della versione di Mail e di Nextcloud. Questa procedura si basa sul manuale di amministrazione di Nextcloud 35 Mail , aggiornato a ottobre 2026.

• Utilizza un URL Nextcloud HTTPS che si apra correttamente da un browser, con l'app Mail installata e abilitata.
• È necessario disporre dell'accesso di amministratore Nextcloud e dell'autorizzazione per registrare un'applicazione OAuth in Google Cloud o Microsoft Entra.
• Verifica se l'account è Gmail/Google Workspace, Outlook.com o una casella di posta Microsoft 365 ospitata su Exchange Online.
• Verifica che il provider consenta l'accesso IMAP e, per l'invio, l'SMTP autenticato in conformità con le policy dell'organizzazione.

Limite importante: un provider IMAP personalizzato che accetta OAuth2 non è automaticamente supportato dalle schermate di configurazione di Gmail/Microsoft di Nextcloud Mail. La richiesta di funzionalità per i provider OAuth2 generici di Nextcloud Mail documenta questa distinzione. Per un altro provider, verifica la versione specifica di Mail in uso e i metodi di autenticazione supportati, anziché inserire credenziali Google o Microsoft non correlate.

Registra un client OAuth con l'URI di reindirizzamento corretto

Gmail o Google Workspace

1. In Nextcloud, accedi come amministratore, apri le impostazioni di amministrazione → Groupware e individua l'integrazione con Gmail . Copia l'URI di reindirizzamento mostrato dalla tua istanza. Non dare per scontato che un URL copiato dall'installazione di qualcun altro sia corretto.
2. Apri la Google Cloud Console e seleziona o crea un progetto. Configura le impostazioni di consenso/branding e di pubblico di Google Auth Platform in base alle esigenze della tua organizzazione Workspace o degli utenti esterni; aggiungi utenti di prova se l'applicazione è ancora in fase di test.
3. Crea un client OAuth di tipo Applicazione Web . Inserisci l'URL esatto di Nextcloud in URI di reindirizzamento autorizzati , quindi salva in modo sicuro l'ID client e il segreto client. Google richiede una corrispondenza letterale dell'URI di reindirizzamento, inclusi schema, percorso, maiuscole/minuscole e barra finale.
4. Esamina gli ambiti di autorizzazione e i requisiti di pubblicazione. L'accesso Gmail tramite IMAP e SMTP OAuth ha https://mail.google.com/un ambito ampio e limitato, soggetto alle norme di Google in materia di dati utente e verifica. L'amministratore deve stabilire se l'utilizzo proposto soddisfa tali requisiti.

Google documenta il flusso di registrazione del server web nelle sue istruzioni per le applicazioni web OAuth2 e nello specifico ambito e protocollo XOAUTH2 di Gmail . Una configurazione di test è utile per la convalida iniziale, ma un'applicazione OAuth esterna lasciata in modalità di test generalmente riceve token di aggiornamento che scadono dopo sette giorni quando si richiede l'accesso alla posta Gmail. Consultare le linee guida di Google sulla scadenza dei token . Pertanto, ripetute richieste di riautorizzazione settimanali possono indicare una limitazione dello stato di pubblicazione piuttosto che una password IMAP errata.

Microsoft 365 o Outlook.com

1. Nelle impostazioni di amministrazione di Nextcloud → Groupware , individua l'integrazione con Microsoft e copia l'URI di reindirizzamento visualizzato.
2. Nel centro di amministrazione di Microsoft Entra , vai a Registrazioni app e crea una registrazione. Per i tipi di account descritti nella guida standard di Nextcloud, scegli sia l'account Microsoft aziendale che quello personale; utilizza una piattaforma di reindirizzamento Web e inserisci l'URI di Nextcloud esattamente come appare.
3. Copia l' ID dell'applicazione (client) . Nella sezione Certificati e segreti , crea un segreto client e copiane immediatamente il valore , non l'identificativo del segreto. Annota la data di scadenza nel tuo calendario operativo.
4. Utilizzare le autorizzazioni delegate relative alla posta elettronica richieste per il flusso OAuth IMAP e SMTP del provider, con il consenso dell'organizzazione ove richiesto. Microsoft documenta gli IMAP.AccessAsUser.Allambiti SMTP.Sende nonché offline_accessper i token di aggiornamento. Non confondere queste autorizzazioni di protocollo con le autorizzazioni Mail.Read/Mail.Send di Microsoft Graph.

Per i dettagli sulla registrazione, consultare la documentazione di registrazione delle app di Microsoft e le istruzioni IMAP/SMTP OAuth di Exchange Online . La configurazione generica documentata di Nextcloud lascia il campo tenant vuoto common. Un valore specifico per il tenant o un pubblico supportato più ristretto devono essere utilizzati solo dopo che l'amministratore ha verificato le modifiche al tipo di account e ai criteri associati.

Salva le credenziali in Nextcloud e collega la casella di posta

1. Torna alle impostazioni di amministrazione → Groupware . Incolla l'ID client e il segreto client del provider nella sezione corrispondente all'integrazione con Gmail o con Microsoft e salva. Non inserire mai il segreto nel campo URI di reindirizzamento né pubblicarlo in screenshot, ticket o nel controllo di versione.
2. Accedi come l'utente della casella di posta desiderata, apri Mail e scegli di aggiungere un account di posta. Inserisci l'indirizzo email, seleziona prima la configurazione automatica dell'account e avvia la connessione. Il flusso Microsoft documentato da Nextcloud potrebbe comunque presentare un campo per la password; il segnaposto inserito verrà eliminato quando verrà configurato l'autenticazione OAuth del provider. Non sostituire la password con una password reale senza necessità.
3. Nella finestra a comparsa del provider, seleziona l'identità Google o Microsoft corretta, rivedi l'accesso richiesto e concedi il consenso se approvato dalla tua organizzazione. Consenti i pop-up del browser e torna alla scheda Nextcloud originale dopo il reindirizzamento da parte del provider.
4. Se la configurazione automatica seleziona il server sbagliato, verifica i nomi host IMAP e SMTP configurati manualmente e le opzioni di crittografia per quel provider specifico. Il pulsante OAuth è associato agli endpoint Gmail/Microsoft riconosciuti; l'inserimento manuale di nomi host non correlati potrebbe non attivare il flusso di accesso previsto.

Nel modulo di registrazione dell'account Nextcloud Mail, un endpoint Google riconosciuto con OAuth configurato può mostrare " Accedi con Google" , mentre l'equivalente Microsoft può mostrare "Accedi con Microsoft" . Il codice sorgente del modulo di registrazione dell'account Nextcloud Mail documenta queste etichette condizionali. La presenza del pulsante specifico del provider è un utile segnale preliminare che Nextcloud ha riconosciuto l'integrazione prevista, ma non dimostra che l'autorizzazione o l'accesso alla casella di posta siano stati completati.

Risolvere i guasti nella fase in cui si verificano

Microsoft illustra il controllo SMTP AUTH, inclusa la possibilità di sovrascrivere il protocollo per singola casella di posta, nella documentazione di Exchange Online relativa a SMTP AUTH . Evitate di compromettere la sicurezza della posta elettronica a livello globale solo per far funzionare una singola casella di posta; se le policy vietano il protocollo, utilizzate invece un client di posta approvato o un flusso di lavoro supportato dall'organizzazione.

Verificare entrambe le direzioni del flusso di posta

1. Apri la Posta in arrivo in Nextcloud Mail, aggiornala e verifica che il messaggio ricevuto di recente venga visualizzato con il mittente, l'oggetto e il contenuto previsti.
2. Invia una breve email di prova a un'altra casella di posta elettronica di tua proprietà. Verifica la ricezione dell'email, quindi controlla la cartella "Posta inviata" in Nextcloud Mail. Questo permette di distinguere i problemi di autorizzazione SMTP da quelli di sincronizzazione IMAP.
3. Disconnettiti e accedi di nuovo, quindi riapri Mail. Per le implementazioni operative, ricontrolla dopo che il token di accesso sarebbe normalmente stato aggiornato; un successo immediato non garantisce il rinnovo del token a lungo termine.

Se la sincronizzazione della posta in arrivo continua a non funzionare, Nextcloud fornisce documentazione occ mail:account:exportper individuare l'ID dell'account di posta e occ mail:account:sync -vvv ACCOUNT_IDper una risoluzione dei problemi mirata. Il manuale di risoluzione dei problemi di Groupware spiega anche la registrazione di debug IMAP/SMTP per singolo account e avverte che i log potrebbero contenere informazioni sensibili. Acquisite solo le informazioni necessarie, oscurate i token e gli indirizzi prima di condividere i log e disattivate la modalità di debug dettagliata in seguito.

La configurazione è pronta per l'uso quando il consenso del provider è completato, Mail è in grado di recuperare i messaggi correnti, la posta in uscita raggiunge la sua destinazione e la connessione rimane utilizzabile senza richieste di autorizzazione ripetute. Se uno qualsiasi di questi controlli fallisce, è necessario risolvere il problema relativo a quella specifica fase anziché ricreare immediatamente l'intera applicazione OAuth.