Настройка Google

Менеджер почтыEnterprise Edition+

Предварительные условия

Чтобы пользователи могли подключать Google Gmail к NocoBase, система должна быть развёрнута на сервере, который поддерживает доступ к сервисам Google. Бэкенд будет вызывать Google API.

Регистрация аккаунта

  1. Откройте https://console.cloud.google.com/welcome, чтобы войти в Google Cloud.
  2. При первом входе нужно согласиться с соответствующими условиями.

Создание приложения

  1. Нажмите "Select a project" сверху.

  1. Во всплывающем слое нажмите кнопку "NEW PROJECT".

  1. Заполните информацию о проекте.

  1. После создания проекта выберите этот проект.

Включить Gmail API

  1. Нажмите кнопку "APIs & Services".

  1. Перейдите в панель APIs & Services.

  1. Найдите mail.

  1. Нажмите кнопку ENABLE, чтобы включить Gmail API.

Настроить экран согласия OAuth

  1. Слева нажмите меню "OAuth consent screen".

  1. Выберите External.

  1. Заполните информацию о проекте (она будет отображаться на последующей странице авторизации) и нажмите save.

  1. Заполните Developer contact information и нажмите continue.

  1. Нажмите continue.

  1. Добавьте тестовых пользователей для тестирования до публикации приложения.

  1. Нажмите continue.

  1. Проверьте сводную информацию и вернитесь в dashboard.

Создать учётные данные

  1. Слева нажмите меню Credentials.

  1. Нажмите кнопку "CREATE CREDENTIALS" и выберите "OAuth client ID".

  1. Выберите "Web application".

  1. Заполните информацию о приложении.

  1. Укажите домен, на котором приложение будет развёрнуто (в этом примере — тестовый адрес NocoBase).

  1. Добавьте адрес авторизованного callback, он должен быть domain + "/admin/settings/mail/oauth2", например: https://pr-1-mail.test.nocobase.com/admin/settings/mail/oauth2

  1. Нажмите create, чтобы посмотреть OAuth-информацию.

  1. Скопируйте значения Client ID и Client Secret и вставьте их на страницу настройки почты.

  1. Нажмите save, чтобы завершить настройку.

Публикация приложения

Приступайте к публикации после завершения описанного выше процесса и после того, как тестовые пользователи авторизуются и будет выполнено тестирование входа, отправки почты и других функций.

  1. Нажмите меню "OAuth consent screen".

  1. Нажмите кнопку "EDIT APP", затем нажмите кнопку "SAVE AND CONTINUE" внизу.

  1. Нажмите кнопку "ADD OR REMOVE SCOPES", чтобы выбрать области прав (permission scopes) пользователей.

  1. Найдите "Gmail API" и отметьте "Gmail API" (убедитесь, что значение Scope равно "https://mail.google.com/").

  1. Нажмите кнопку UPDATE внизу, чтобы сохранить.

  1. На каждой странице нажимайте кнопку "SAVE AND CONTINUE" внизу, а в конце нажмите "BACK TO DASHBOARD", чтобы вернуться на страницу dashboard.

  1. Нажмите кнопку PUBLISH APP — появится страница подтверждения публикации с информацией, необходимой для публикации. Затем нажмите кнопку CONFIRM.

  1. Снова вернитесь в консоль — вы увидите, что статус публикации "In production".

  1. Нажмите кнопку "PREPARE FOR VERIFICATION", заполните требуемую информацию и нажмите кнопку "SAVE AND CONTINUE" (данные на изображении приведены только как пример).

  1. Продолжайте заполнять необходимую информацию (данные на изображении приведены только как пример).

  1. Нажмите кнопку "SAVE AND CONTINUE".

  1. Нажмите кнопку "SUBMIT FOR VERIFICATION", чтобы отправить Verification.

  1. Дождитесь результата одобрения.

  1. Если одобрение ещё не получено, пользователи могут нажать небезопасную ссылку, чтобы авторизоваться.