Conecte o Gmail ou o Microsoft 365 ao Nextcloud Mail usando OAuth2.

Para conectar o Gmail ou o Microsoft 365 ao Nextcloud Mail com OAuth2, registre um aplicativo web com o provedor de e-mail, copie o URI de redirecionamento do Nextcloud Mail para esse registro e salve o ID e o segredo do cliente nas configurações de administração do Groupware do Nextcloud. Em seguida, conecte a caixa de correio no Mail e aceite a solicitação de login do provedor. Uma configuração funcional deve carregar as mensagens recebidas e enviar uma mensagem de teste — não apenas exibir uma tela de autorização bem-sucedida.

Verifique se sua conta e instalação do Nextcloud são compatíveis com este método.

O Nextcloud Mail usa IMAP para ler mensagens e SMTP para enviá-las. O OAuth2 obtém permissão do provedor de identidade; o XOAUTH2 é o mecanismo que o cliente de e-mail usa para apresentar um token de acesso a esses serviços de e-mail. Ele não transforma o login do Nextcloud em um login único universal para todos os servidores de e-mail.

A documentação de administração atual do Nextcloud descreve integrações dedicadas com o Gmail OAuth e o Microsoft Outlook XOAuth2. O suporte da Microsoft foi adicionado no Mail 3.0.0; a nomenclatura do menu pode variar de acordo com as versões do Mail e do Nextcloud. Este guia passo a passo é baseado no manual de administração do Nextcloud Mail 35 , atualizado em outubro de 2026.

• Use um URL HTTPS do Nextcloud que abra de forma confiável em um navegador, com o aplicativo Mail instalado e ativado.
• Ter acesso de administrador do Nextcloud e permissão para registrar um aplicativo OAuth no Google Cloud ou no Microsoft Entra.
• Saiba se a conta é do Gmail/Google Workspace, Outlook.com ou uma caixa de correio do Microsoft 365 hospedada no Exchange Online.
• Confirme se o provedor permite acesso IMAP e, para envio, SMTP autenticado de acordo com as políticas da organização.

Limitação importante: um provedor IMAP personalizado que aceite OAuth2 não é automaticamente compatível com as telas de configuração do Gmail/Microsoft do Nextcloud Mail. A solicitação de recurso do Nextcloud Mail para provedores OAuth2 genéricos documenta essa distinção. Para outro provedor, verifique a versão específica do Mail e os métodos de autenticação compatíveis, em vez de inserir credenciais do Google ou da Microsoft que não sejam relevantes.

Registre um cliente OAuth com o URI de redirecionamento correto.

Gmail ou Google Workspace

1. No Nextcloud, faça login como administrador, abra Configurações de administração → Groupware e localize a integração com o Gmail . Copie o URI de redirecionamento exibido pela sua instância. Não assuma que um URL copiado da instalação de outra pessoa esteja correto.
2. Abra o Console do Google Cloud e selecione ou crie um projeto. Configure as definições de consentimento/marca e público-alvo da Plataforma de Autenticação do Google conforme apropriado para a sua organização do Workspace ou para usuários externos; adicione usuários de teste se o aplicativo ainda estiver em fase de testes.
3. Crie um cliente OAuth do tipo Aplicativo Web . Insira a URL exata do Nextcloud em URIs de redirecionamento autorizadas e salve o ID do cliente e o segredo do cliente em um local seguro. O Google exige uma correspondência literal da URI de redirecionamento, incluindo esquema, caminho, maiúsculas e minúsculas e barra no final.
4. Analise os escopos de autorização e os requisitos de publicação. O acesso OAuth do Gmail via IMAP e SMTP utiliza https://mail.google.com/um escopo amplo e restrito, sujeito às políticas de dados do usuário e de verificação do Google. O administrador deve determinar se o uso proposto atende a esses requisitos.

O Google documenta o fluxo de registro do servidor web em suas instruções para aplicativos web OAuth2 , bem como o escopo e protocolo XOAUTH2 específicos do Gmail . Uma configuração de teste é útil para a validação inicial, mas um aplicativo OAuth externo deixado em modo de teste geralmente recebe tokens de atualização que expiram após sete dias ao solicitar acesso ao Gmail. Consulte as orientações do Google sobre expiração de tokens . Portanto, a necessidade de reautorização semanal repetida pode indicar uma limitação no estado de publicação, e não uma senha IMAP incorreta.

Microsoft 365 ou Outlook.com

1. Nas configurações de Administração do Nextcloud → Groupware , encontre a integração com a Microsoft e copie o URI de redirecionamento exibido.
2. No centro de administração do Microsoft Entra , acesse Registros de aplicativos e crie um registro. Para os tipos de conta descritos no guia padrão do Nextcloud, selecione contas Microsoft organizacionais e pessoais; use uma plataforma de redirecionamento da Web e insira o URI do Nextcloud exatamente como está.
3. Copie o ID do aplicativo (cliente) . Em Certificados e segredos , crie um segredo do cliente e copie o valor dele imediatamente, não o identificador do segredo. Registre a data de expiração no seu calendário de operações.
4. Use as permissões delegadas relacionadas a e-mail necessárias para o fluxo OAuth IMAP e SMTP do provedor, com o consentimento da organização quando necessário. A Microsoft documenta os escopos IMAP.AccessAsUser.All` mail.read` e `mail.send` SMTP.Send, bem como offline_accessos de tokens de atualização. Não confunda essas permissões de protocolo com as permissões `Mail.Read` e `Mail.Send` do Microsoft Graph.

Para obter detalhes sobre o registro, consulte a documentação de registro de aplicativos da Microsoft e as instruções de OAuth IMAP/SMTP do Exchange Online . A configuração de uso geral documentada do Nextcloud deixa o campo de locatário em branco common. Um valor específico do locatário ou um público-alvo compatível mais restrito deve ser usado somente quando o administrador tiver verificado o tipo de conta associado e as alterações de política.

Salve as credenciais no Nextcloud e conecte a caixa de correio.

1. Retorne às configurações de Administração → Groupware . Cole o ID do cliente e o segredo do cliente do provedor na seção de integração com o Gmail ou com a Microsoft correspondente e salve. Nunca insira o segredo no campo URI de redirecionamento nem o publique em capturas de tela, tickets ou sistemas de controle de versão.
2. Inicie sessão como o utilizador da caixa de correio pretendida, abra a secção "Email" e escolha adicionar uma conta de correio. Introduza o endereço de correio, selecione primeiro a configuração automática da conta e inicie a ligação. O fluxo documentado do Nextcloud para a Microsoft pode ainda apresentar um campo de palavra-passe; o valor inserido é descartado quando o OAuth do fornecedor é configurado. Não substitua a palavra-passe da conta por uma palavra-passe real sem necessidade.
3. Na janela pop-up do provedor, selecione a identidade correta do Google ou da Microsoft, revise o acesso solicitado e conceda o consentimento, caso seja aprovado pela sua organização. Permita pop-ups do navegador e retorne à guia original do Nextcloud após o redirecionamento do provedor.
4. Se a configuração automática selecionar o servidor errado, verifique os nomes de host IMAP e SMTP e as opções de criptografia configuradas manualmente para esse provedor específico. O botão OAuth está associado a endpoints reconhecidos do Gmail/Microsoft; nomes de host não relacionados inseridos manualmente podem não ativar o fluxo de login esperado.

No formulário de conta de e-mail do Nextcloud, um endpoint do Google reconhecido com OAuth configurado pode exibir " Entrar com o Google" , e o equivalente da Microsoft pode exibir "Entrar com a Microsoft" . O código-fonte do formulário de conta de e-mail do Nextcloud documenta esses rótulos condicionais. A presença do botão específico do provedor é um sinal inicial útil de que o Nextcloud reconheceu a integração pretendida, mas não comprova que a autorização ou o acesso à caixa de correio foram concluídos.

Resolva as falhas de acordo com o estágio em que elas ocorrem.

A Microsoft explica o controle de autenticação SMTP, incluindo a opção de sobrescrita por caixa de correio, na documentação de autenticação SMTP do Exchange Online . Evite comprometer a segurança global do e-mail apenas para que uma caixa de correio funcione; se a política da empresa proibir o protocolo, use um cliente de e-mail aprovado ou um fluxo de trabalho compatível com a organização.

Verifique o fluxo de correspondência em ambas as direções.

1. Abra a caixa de entrada do Nextcloud Mail, atualize a página e confirme se uma mensagem recebida recentemente aparece com o remetente, o assunto e o conteúdo esperados.
2. Envie um e-mail de teste curto para outra caixa de correio que você controla. Verifique a entrega lá e, em seguida, confira a pasta "Enviados" no Nextcloud Mail. Isso ajuda a diferenciar problemas de permissão SMTP de problemas de sincronização IMAP.
3. Saia da sua conta e entre novamente, depois abra o Mail. Para implantações operacionais, verifique novamente após o período em que o token de acesso normalmente seria atualizado; o sucesso imediato não garante a renovação do token a longo prazo.

Se a caixa de entrada ainda não sincronizar, o Nextcloud fornece instruções occ mail:account:exportpara encontrar o ID da conta de e-mail e occ mail:account:sync -vvv ACCOUNT_IDpara solucionar problemas específicos. O manual de solução de problemas do Groupware também explica o registro de depuração IMAP/SMTP por conta e alerta que os registros podem conter informações confidenciais. Capture apenas o necessário, oculte tokens e endereços antes de compartilhar e desative a depuração detalhada posteriormente.

A configuração estará pronta para uso quando o consentimento do provedor for concluído, o Mail conseguir recuperar as mensagens atuais, as mensagens enviadas chegarem ao destino e a conexão permanecer utilizável sem solicitações repetidas de autorização. Se alguma dessas verificações falhar, solucione o problema nessa etapa específica em vez de recriar todo o aplicativo OAuth imediatamente.