Подключите Gmail или Microsoft 365 к Nextcloud Mail с помощью OAuth2.

Для подключения Gmail или Microsoft 365 к Nextcloud Mail с использованием OAuth2 зарегистрируйте веб-приложение у почтового провайдера, скопируйте URI перенаправления Nextcloud Mail в эту регистрацию и сохраните идентификатор клиента и секрет в настройках администрирования группового ПО Nextcloud. Затем подключите почтовый ящик в Mail и подтвердите запрос на вход от провайдера. Для корректной работы необходимо, чтобы входящие сообщения загружались, а тестовое сообщение отправлялось, а не просто отображался экран успешной авторизации.

Убедитесь, что ваша учетная запись и установка Nextcloud соответствуют этому методу.

Nextcloud Mail использует IMAP для чтения сообщений и SMTP для их отправки. OAuth2 получает разрешение от поставщика идентификации; XOAUTH2 — это механизм, который почтовый клиент использует для предоставления токена доступа этим почтовым службам. Это не превращает вход в Nextcloud в универсальный единый вход для каждого почтового сервера.

В текущей документации по администрированию Nextcloud описаны специальные интеграции с Gmail OAuth и Microsoft Outlook XOAUTH2. Поддержка Microsoft была добавлена ​​в Mail 3.0.0; формулировки в меню могут отличаться в зависимости от версии Mail и Nextcloud. Данное руководство основано на руководстве по администрированию Nextcloud 35 Mail , актуальном по состоянию на октябрь 2026 года.

• Используйте HTTPS-адрес Nextcloud, который надежно открывается в браузере, при условии, что приложение «Почта» установлено и включено.
• Необходимо иметь права администратора Nextcloud и разрешение на регистрацию приложения OAuth в Google Cloud или Microsoft Entra.
• Узнайте, используется ли учетная запись в Gmail/Google Workspace, Outlook.com или в почтовом ящике Microsoft 365, размещенном в Exchange Online.
• Убедитесь, что провайдер разрешает доступ по протоколу IMAP, а для отправки — аутентифицированный SMTP в соответствии с политикой организации.

Важное ограничение: пользовательский IMAP-провайдер, принимающий OAuth2, не поддерживается автоматически экранами настройки Gmail/Microsoft в Nextcloud Mail. В запросе на добавление универсальных OAuth2-провайдеров в Nextcloud Mail задокументировано это различие. Для другого провайдера проверьте точную версию вашей почты и поддерживаемые ею методы аутентификации, вместо того чтобы вводить несвязанные учетные данные Google или Microsoft.

Зарегистрируйте OAuth-клиент с правильным URI перенаправления.

Gmail или Google Workspace

1. В Nextcloud войдите в систему как администратор, откройте «Настройки администрирования» → «Групповое ПО» и найдите интеграцию с Gmail . Скопируйте URI перенаправления, отображаемый вашим экземпляром. Не следует предполагать, что URL-адрес, скопированный с чужой установки, является правильным.
2. Откройте консоль Google Cloud и выберите или создайте проект. Настройте параметры согласия/брендинга и аудитории платформы Google Auth Platform в соответствии с потребностями вашей организации Workspace или внешних пользователей; добавьте тестовых пользователей, если приложение остается в режиме тестирования.
3. Создайте OAuth-клиент типа «Веб-приложение» . В поле «Авторизованные URI перенаправления» укажите точный URL-адрес из Nextcloud , затем надежно сохраните идентификатор клиента и секретный ключ клиента. Google требует точного совпадения URI перенаправления, включая схему, путь, регистр букв и завершающую косую черту.
4. Ознакомьтесь с областями авторизации и требованиями к публикации. Доступ к Gmail по протоколам IMAP и SMTP OAuth имеет https://mail.google.com/широкую ограниченную область действия, на которую распространяются политики Google в отношении пользовательских данных и проверки. Администратор должен определить, соответствует ли предлагаемое использование этим требованиям.

Google описывает процесс регистрации веб-сервера в своих инструкциях по использованию веб-приложений OAuth2 , а также конкретную область действия и протокол Gmail XOAUTH2 . Тестовая конфигурация полезна для первоначальной проверки, но внешнее приложение OAuth, оставленное в режиме тестирования, обычно получает токены обновления, срок действия которых истекает через семь дней при запросе доступа к почте Gmail. См. рекомендации Google по истечению срока действия токенов . Поэтому повторная еженедельная авторизация может указывать на ограничение состояния публикации, а не на неработающий пароль IMAP.

Microsoft 365 или Outlook.com

1. В настройках администрирования Nextcloud → Групповое ПО найдите интеграцию с Microsoft и скопируйте отображаемый URI перенаправления.
2. В центре администрирования Microsoft Entra перейдите в раздел «Регистрация приложений» и создайте регистрацию. Для типов учетных записей, описанных в стандартном руководстве Nextcloud, выберите как корпоративную, так и личную учетную запись Microsoft; используйте платформу веб- перенаправления и введите URI Nextcloud точно.
3. Скопируйте идентификатор приложения (клиента) . В разделе «Сертификаты и секреты» создайте секрет клиента и сразу же скопируйте его значение , а не идентификатор секрета. Запишите дату истечения срока его действия в свой операционный календарь.
4. Используйте делегированные разрешения, связанные с почтой, необходимые для потока аутентификации IMAP и SMTP OAuth поставщика, с обязательным согласием организации. Microsoft описывает области IMAP.AccessAsUser.Allдействия SMTP.Send, а также offline_accessдля токенов обновления. Не путайте эти разрешения протокола с разрешениями Microsoft Graph Mail.Read/Mail.Send.

Для получения подробной информации о регистрации обратитесь к документации Microsoft по регистрации приложений и инструкциям Exchange Online по аутентификации IMAP/SMTP OAuth . В документации Nextcloud для общих настроек поле "Арендатор" остается пустым common. Значение, специфичное для конкретного арендатора, или более узкая поддерживаемая аудитория должны использоваться только после того, как администратор проверит соответствующие изменения типа учетной записи и политики.

Сохраните учетные данные в Nextcloud и подключите почтовый ящик.

1. Вернитесь в раздел «Администрирование» → «Групповое ПО» . Вставьте идентификатор клиента и секретный ключ поставщика в соответствующий раздел интеграции с Gmail или Microsoft и сохраните. Никогда не указывайте секретный ключ в поле URI перенаправления и не публикуйте его на скриншотах, в заявках или в системах контроля версий.
2. Войдите в систему как пользователь почтового ящика, откройте «Почта» и выберите добавление почтовой учетной записи. Введите ее адрес электронной почты, сначала выберите автоматическую настройку учетной записи и начните подключение. В описанном в документации Microsoft процессе Nextcloud может по-прежнему отображаться поле для пароля; введенный пароль-заполнитель удаляется при настройке OAuth провайдера. Не заменяйте пароль учетной записи реальным без необходимости.
3. В всплывающем окне поставщика услуг выберите правильную учетную запись Google или Microsoft, ознакомьтесь с запрашиваемым доступом и предоставьте согласие, если оно одобрено вашей организацией. Разрешите всплывающие окна браузера и вернитесь на исходную вкладку Nextcloud после перенаправления от поставщика услуг.
4. Если автоматическая настройка выбирает неправильный сервер, проверьте вручную заданные имена хостов IMAP и SMTP, а также параметры шифрования для данного провайдера. Кнопка OAuth связана с распознанными конечными точками Gmail/Microsoft; вручную введенные несвязанные имена хостов могут не активировать ожидаемый процесс входа в систему.

В форме учетной записи Nextcloud Mail распознанная конечная точка Google с настроенным OAuth может отображать «Войти через Google» , а аналогичная точка Microsoft — «Войти через Microsoft» . Исходный код формы учетной записи Nextcloud Mail в реальном времени документирует эти условные метки. Наличие кнопки, специфичной для поставщика услуг, является полезным предварительным признаком того, что Nextcloud распознал предполагаемую интеграцию, но это не доказывает, что авторизация или доступ к почтовому ящику завершены.

Устраняйте сбои по этапам их возникновения.

Microsoft подробно описывает управление аутентификацией SMTP, включая возможность переопределения для каждого почтового ящика, в своей документации по аутентификации SMTP в Exchange Online . Избегайте глобального ослабления безопасности почты только для того, чтобы обеспечить работу одного почтового ящика; если политика запрещает протокол, используйте вместо этого утвержденный почтовый клиент или поддерживаемый организацией рабочий процесс.

Проверьте оба направления потока почты.

1. Откройте папку «Входящие» в Nextcloud Mail, обновите страницу и убедитесь, что отображается недавно полученное сообщение с ожидаемым отправителем, темой и содержимым.
2. Отправьте короткое тестовое письмо на другой почтовый ящик, который вы контролируете. Проверьте доставку там, а затем проверьте папку «Отправленные» в Nextcloud Mail. Это позволит отделить проблемы с правами доступа SMTP от проблем синхронизации IMAP.
3. Выйдите из системы и войдите снова, затем откройте Почту. Для рабочих развертываний проверьте еще раз после того, как токен доступа будет обновлен; немедленный успех не гарантирует долгосрочное обновление токена.

Если синхронизация входящих сообщений по-прежнему не удается, в документации Nextcloud описаны occ mail:account:exportспособы поиска идентификатора почтового аккаунта и occ mail:account:sync -vvv ACCOUNT_IDцеленаправленного устранения неполадок. В руководстве по устранению неполадок группового ПО также объясняется ведение журналов отладки IMAP/SMTP для каждой учетной записи и предупреждается, что журналы могут содержать конфиденциальную информацию. Записывайте только необходимую информацию, удаляйте токены и адреса перед отправкой и отключайте подробную отладку после этого.

Настройка готова к использованию, когда завершится подтверждение со стороны поставщика услуг, почтовое приложение сможет получать текущие сообщения, исходящая почта достигнет адресата, а соединение останется работоспособным без повторных запросов на авторизацию. Если какой-либо из этих тестов не пройден, следует устранить неполадки на этом конкретном этапе, вместо того чтобы сразу же пересоздавать все приложение OAuth.