К основному содержимому

Настройка SSO через Google Workspace

Подключите Google Workspace к Tomba, чтобы ваша команда могла входить через свои аккаунты Google.

Автор: Tomba.io Team

Подключите Google Workspace к Tomba, и ваша команда сможет входить через аккаунты Google, которыми уже пользуется. Google Workspace выступает поставщиком удостоверений (identity provider) — сервисом, который управляет логинами вашей компании.

Перед началом работы

Вам понадобятся:

  • Тариф Tomba Enterprise

  • Роль Owner или Admin в вашем рабочем пространстве Tomba

  • Права Super administrator в вашем Google Workspace

Если вы не управляете Google Workspace сами, попросите свой IT-отдел пройти эти шаги вместе с вами.

Шаг 1: добавьте приложение в Google Admin

  1. Откройте admin.google.com.

  2. Перейдите в Apps > Web and mobile apps.

  3. Нажмите Add app > Add custom SAML app.

  4. Введите название приложения, например Tomba.

  5. Нажмите Continue.

Шаг 2: скачайте метаданные Google

Метаданные — это небольшой файл с расширением .xml, который сообщает Tomba, что входам через Google можно доверять.

  1. На экране Google Identity Provider details скачайте метаданные.

  2. Сохраните файл на компьютере. Вы загрузите его в Tomba на шаге 4.

  3. Нажмите Continue.

Шаг 3: скопируйте данные Tomba в Google

  1. В новой вкладке браузера откройте в Tomba страницу Settings > SAML SSO.

  2. Найдите раздел Service provider details.

  3. Скопируйте каждое значение в Google Admin по таблице ниже.

  4. Нажмите Continue, а затем Finish.

Поле в Google Admin

Что ввести

ACS URL

ACS URL (Reply URL) из Tomba

Entity ID

Entity ID (Audience URI) из Tomba

Name ID format

EMAIL

Name ID

Basic Information > Primary email

Шаг 4: загрузите метаданные в Tomba

  1. На той же странице Tomba нажмите Configure SAML SSO.

  2. На вкладке Upload file выберите файл, сохранённый на шаге 2.

  3. Убедитесь, что появилось сообщение Metadata looks good, а под ним — Entity ID и SSO URL.

  4. Нажмите Save and enable SSO.

Шаг 5: включите приложение для команды

Google оставляет новое приложение выключенным, пока вы его не включите.

  1. В Google Admin откройте Apps > Web and mobile apps и выберите приложение Tomba.

  2. Нажмите User access.

  3. Выберите On for everyone или только отдельные группы людей. В Google такие группы называются организационными подразделениями.

  4. Нажмите Save.

По словам Google, изменения могут вступать в силу до 24 часов, но обычно это происходит быстрее.

Шаг 6: подтвердите домен email-адресов

Ваша команда сможет входить через SSO только после подтверждения домена email-адресов. Перед проверкой выполните инструкцию Подтверждение домена для SSO.

Шаг 7: проверьте подключение

  1. Откройте окно браузера в приватном режиме или режиме инкогнито.

  2. Перейдите на страницу входа в Tomba и нажмите Sign in with SSO.

  3. Введите Work email и нажмите Continue.

  4. Нажмите Continue with SSO, а затем войдите через свой аккаунт Google.

В результате вы должны оказаться в Tomba.

💡 Совет: когда всё заработает, выберите способ входа для команды. См. Режимы входа через SSO.

Частые вопросы

Что проверить, если появилось сообщение «Authentication failed»?

Проверьте три вещи:

  • Приложение включено для вашего пользователя в Google Admin.

  • Entity ID и ACS URL в Google точно совпадают с данными в Tomba.

  • Для Name ID выбрано значение Primary email.

Почему я вижу сообщение «SSO not configured»?

Для этого домена email-адресов SSO ещё не настроен. Проверьте, что домен подтверждён в разделе Verified domains на странице Settings > SAML SSO.

Что делать, если появилась ошибка сертификата?

Скачайте метаданные из Google заново. Затем нажмите Replace metadata на странице Settings > SAML SSO и загрузите новый файл.

Статьи по теме

Нашли ответ на свой вопрос?