Conecta Gmail o Microsoft 365 a Nextcloud Mail mediante OAuth2.

Para conectar Gmail o Microsoft 365 a Nextcloud Mail con OAuth2, registre una aplicación web con el proveedor de correo, copie la URI de redireccionamiento de Nextcloud Mail en dicho registro y guarde el ID de cliente y el secreto en la configuración de administración de Groupware de Nextcloud. A continuación, conecte el buzón en Mail y apruebe la solicitud de inicio de sesión del proveedor. Una configuración correcta debe cargar los mensajes entrantes y enviar un mensaje de prueba, no solo mostrar una pantalla de autorización exitosa.

Comprueba que tu cuenta y la instalación de Nextcloud se ajustan a este método.

Nextcloud Mail utiliza IMAP para leer mensajes y SMTP para enviarlos. OAuth2 obtiene autorización del proveedor de identidad; XOAUTH2 es el mecanismo que utiliza el cliente de correo para presentar un token de acceso a estos servicios de correo. Esto no convierte el inicio de sesión de Nextcloud en un inicio de sesión único universal para todos los servidores de correo.

La documentación de administración actual de Nextcloud describe integraciones dedicadas para Gmail OAuth y Microsoft Outlook XOAUTH2. La compatibilidad con Microsoft se agregó en Mail 3.0.0; la redacción de los menús puede variar según las versiones de Mail y Nextcloud. Este tutorial se basa en el manual de administración de Nextcloud Mail 35 , actualizado a octubre de 2026.

• Utilice una URL HTTPS de Nextcloud que se abra correctamente desde un navegador, con la aplicación Mail instalada y habilitada.
• Disponer de acceso de administrador de Nextcloud y permiso para registrar una aplicación OAuth en Google Cloud o Microsoft Entra.
• Averigüe si la cuenta es de Gmail/Google Workspace, Outlook.com o un buzón de Microsoft 365 alojado en Exchange Online.
• Confirme que el proveedor permite el acceso IMAP y, para el envío, el uso de SMTP autenticado, de acuerdo con las políticas de la organización.

Limitación importante: las pantallas de configuración de Gmail/Microsoft de Nextcloud Mail no admiten automáticamente un proveedor IMAP personalizado que acepte OAuth2. La solicitud de función de Nextcloud Mail para proveedores OAuth2 genéricos documenta esta distinción. Para otro proveedor, consulte su versión exacta de Mail y los métodos de autenticación compatibles en lugar de introducir credenciales de Google o Microsoft que no correspondan.

Registre un cliente OAuth con la URI de redireccionamiento correcta.

Gmail o Google Workspace

1. En Nextcloud, inicia sesión como administrador, abre Configuración de administración → Groupware y localiza la integración con Gmail . Copia la URI de redireccionamiento que muestra tu instancia. No des por sentado que una URL copiada de la instalación de otra persona es correcta.
2. Abre la consola de Google Cloud y selecciona o crea un proyecto. Configura los ajustes de consentimiento, marca y audiencia de la plataforma de autenticación de Google según corresponda a tu organización de Workspace o a los usuarios externos; agrega usuarios de prueba si la aplicación permanece en fase de pruebas.
3. Crea un cliente OAuth de tipo aplicación web . Introduce la URL exacta de Nextcloud en URI de redireccionamiento autorizadas y guarda de forma segura el ID de cliente y el secreto de cliente. Google requiere que la URI de redireccionamiento coincida literalmente, incluyendo el esquema, la ruta, las mayúsculas y la barra diagonal final.
4. Revise los ámbitos de autorización y los requisitos de publicación. El acceso OAuth de Gmail IMAP y SMTP tiene https://mail.google.com/un alcance restringido y amplio, sujeto a las políticas de verificación y datos de usuario de Google. El administrador debe determinar si el uso propuesto cumple con dichos requisitos.

Google documenta el flujo de registro del servidor web en sus instrucciones para aplicaciones web OAuth2 y en el alcance y protocolo específicos de Gmail XOAUTH2 . Una configuración de prueba es útil para la validación inicial, pero una aplicación OAuth externa que se deja en modo de prueba generalmente recibe tokens de actualización que caducan a los siete días al solicitar acceso al correo de Gmail. Consulte la guía de Google sobre la caducidad de los tokens . Por lo tanto, la reautorización semanal repetida puede indicar una limitación en el estado de publicación en lugar de una contraseña IMAP incorrecta.

Microsoft 365 o Outlook.com

1. En la configuración de administración de Nextcloud → Groupware , busque la integración con Microsoft y copie la URI de redireccionamiento que se muestra.
2. En el centro de administración de Microsoft Entra , vaya a Registros de aplicaciones y cree un registro. Para los tipos de cuenta descritos en la guía estándar de Nextcloud, seleccione cuentas de Microsoft tanto organizativas como personales; utilice una plataforma de redireccionamiento web e introduzca la URI de Nextcloud tal cual.
3. Copia el ID de la aplicación (cliente) . En Certificados y secretos , crea un secreto de cliente y copia su valor inmediatamente, no el identificador del secreto. Registra su fecha de vencimiento en tu calendario de operaciones.
4. Utilice los permisos delegados relacionados con el correo electrónico necesarios para el flujo OAuth IMAP y SMTP del proveedor, con el consentimiento de la organización cuando sea necesario. Microsoft documenta los IMAP.AccessAsUser.Allámbitos SMTP.Sendy offline_accesslos tokens de actualización. No confunda estos permisos de protocolo con los permisos Mail.Read/Mail.Send de Microsoft Graph.

Para obtener detalles sobre el registro, consulte la documentación de registro de aplicaciones de Microsoft y las instrucciones de autenticación OAuth IMAP/SMTP de Exchange Online . La configuración general documentada de Nextcloud deja el campo de inquilino vacío common. Solo se debe usar un valor específico para el inquilino o un público compatible más restringido cuando el administrador haya verificado el tipo de cuenta asociado y los cambios de política.

Guarda las credenciales en Nextcloud y conecta el buzón.

1. Vuelva a Configuración de administración → Groupware . Pegue el ID de cliente y el secreto de cliente del proveedor en la sección correspondiente de integración con Gmail o Microsoft y guarde. Nunca introduzca el secreto en el campo URI de redireccionamiento ni lo publique en capturas de pantalla, tickets o control de versiones.
2. Inicie sesión como el usuario del buzón de correo deseado, abra Mail y seleccione agregar una cuenta de correo. Ingrese su dirección de correo electrónico, seleccione primero la configuración automática de la cuenta y comience la conexión. El flujo de trabajo documentado de Nextcloud para Microsoft aún puede mostrar un campo de contraseña; el marcador de posición ingresado se descarta cuando se configura OAuth del proveedor. No sustituya innecesariamente una contraseña real de la cuenta.
3. En la ventana emergente del proveedor, seleccione la identidad correcta de Google o Microsoft, revise el acceso solicitado y otorgue su consentimiento si su organización lo aprueba. Permita las ventanas emergentes del navegador y regrese a la pestaña original de Nextcloud después de que el proveedor lo redirija.
4. Si la configuración automática selecciona el servidor incorrecto, revise los nombres de host IMAP y SMTP manuales y las opciones de cifrado para ese proveedor en particular. El botón OAuth está asociado con los puntos de conexión reconocidos de Gmail/Microsoft; los nombres de host no relacionados introducidos manualmente podrían no activar el flujo de inicio de sesión esperado.

En el formulario de cuenta de Nextcloud Mail, un punto final de Google reconocido con OAuth configurado puede mostrar " Iniciar sesión con Google" , y el equivalente de Microsoft puede mostrar " Iniciar sesión con Microsoft" . El código fuente del formulario de cuenta de Nextcloud Mail documenta estas etiquetas condicionales. La presencia del botón específico del proveedor es una señal temprana útil de que Nextcloud ha reconocido la integración prevista, pero no prueba que la autorización o el acceso al buzón se hayan completado.

Resuelva los fallos según la etapa en la que se produzcan.

Microsoft explica el control de autenticación SMTP, incluida la opción de anulación por buzón, en su documentación de autenticación SMTP de Exchange Online . Evite debilitar la seguridad del correo electrónico de forma generalizada solo para que funcione un buzón; si la política prohíbe el protocolo, utilice un cliente de correo electrónico aprobado o un flujo de trabajo compatible con la organización.

Verifique ambas direcciones del flujo de correo.

1. Abre la bandeja de entrada en Nextcloud Mail, actualiza la página y confirma que aparece un mensaje recibido recientemente con el remitente, el asunto y el contenido esperados.
2. Envía un correo electrónico de prueba a otro buzón que controles. Verifica la entrega allí y luego revisa la carpeta de Elementos enviados en Nextcloud Mail. Esto permite diferenciar los problemas de permisos SMTP de los problemas de sincronización IMAP.
3. Cierra sesión y vuelve a iniciarla, luego vuelve a abrir Mail. Para implementaciones operativas, vuelve a comprobarlo después de que el token de acceso se haya actualizado normalmente; el éxito inmediato no garantiza la renovación del token a largo plazo.

Si la bandeja de entrada sigue sin sincronizarse, Nextcloud ofrece documentación occ mail:account:exportpara encontrar el ID de la cuenta de correo y occ mail:account:sync -vvv ACCOUNT_IDpara solucionar problemas específicos. Su manual de solución de problemas de Groupware también explica el registro de depuración IMAP/SMTP por cuenta y advierte que los registros pueden contener información confidencial. Capture solo lo necesario, oculte los tokens y las direcciones antes de compartirlos y desactive la depuración detallada posteriormente.

La configuración estará lista cuando se complete el consentimiento del proveedor, Mail pueda recuperar los mensajes actuales, el correo saliente llegue a su destino y la conexión se mantenga activa sin necesidad de autorizaciones repetidas. Si alguna de estas comprobaciones falla, solucione el problema en esa etapa específica en lugar de recrear toda la aplicación OAuth de inmediato.