---
title: "Использование Google в качестве поставщика единого входа"
id: "ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda"
project: "Руководство пользователя Документерры"
url: "https://docs.documenterra.ru/articles/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda"
updated: 2026-11-16T06:44:55Z
---

# Использование Google в качестве поставщика единого входа

| ![](/resources/Storage/manual/documenterra_baselang/Images/quick-parts/icon-info-important.svg) | Важно |
| --- | --- |
| При использовании технологии единого входа (SSO) необходимо создать учетные записи пользователей в системе Документерра для каждого пользователя SSO, который авторизуется в стороннем сервисе. Это необходимо для того, чтобы система Документерра могла применять определенные права доступа к авторизованному пользователю. Эти права доступа настраиваются в профиле пользователя Документерры. [REST API Документерры](/articles/manual/api-dokumenterry) можно использовать для массового создания пользователей или для создания нового пользователя Документерры каждый раз, когда с вашей стороны создается новый пользователь приложения.<br><br>Учётные записи авторизованных читателей могут [создаваться автоматически](/articles/manual/avtomaticheskoe-sozdanie-polzovateley-pri-vkhode-cherez-sso) при их первом входе через единый вход (SSO). Функционал доступен как часть аддона [Корпоративная безопасность](https://documenterra.ru/price/), и для его включения напишите нам в [службу поддержки](https://documenterra.ru/tehpodderzhka/). |

Вы можете войти в систему Документерра, используя **Google** в качестве поставщика **OpenID Connect.** Ниже приведены инструкции по настройке веб-приложения Google и интеграции с порталом Документерры для использования Google в качестве поставщика OpenID Connect.

* [Настройка веб-приложения Google](/articles/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/a/h2_0)
* [Настройка Документерры](/articles/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/a/h2_1)
* [Использование Google в качестве поставщика OpenID](/articles/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/a/h2_2)

##  Настройка веб-приложения Google

Прежде всего, для настройки **веб-приложения Google** вам нужно зарегистрировать портал **Документерра** в консоли [Google Developer Console](https://console.developers.google.com) в качестве веб-приложения. При первом открытии консоли вам будет предложено создать новый проект.

![Создание нового проекта в Google Developer Console.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/sozdat-noviy-proekt.png)

* Укажите имя нового проекта и нажмите **Create (Создать)**. 
 ![Название нового проекта.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/nazvanie_novogo_proekta.png)
* После создания нового проекта откройте экран **APIs & Services** и нажмите **Credentials (Учетные данные)**, чтобы продолжить настройку. 
 ![Раздел Credentials в APIs &amp; Services.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/credentials.png)
* На экране **Credentials** (Учётные данные) нажмите кнопку **Create credentials** (Создать учётные данные) и выберите опцию **OAuth client ID**. 
 ![Создать учетные данные.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/sozdaniye-dannyh.png)
* Следующий шаг — настройка экрана подтверждения, который определяет, что будет отображаться пользователю на экране входа Google при авторизации в только что созданном проекте. Этот шаг можно пропустить, если экран подтверждения уже настроен. Нажмите кнопку **Configure consent screen** (Настроить экран подтверждения). 
 ![Настройка экрана подтверждения.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/nastroyka-ekrana-podtverzhdeniya.png)
* Выберите подходящий вам **тип пользователя**: 
 ![Выбор подходящего типа пользователя.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/vybrat-podhodyashiy-tip-polzovatelya.png)

* Укажите название приложения, адрес электронной почты ответственного лица, список авторизованных доменов и, при необходимости, некоторые дополнительные параметры. 
 ![Указание данных.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/ukazat-dannye.png)

* Требуется добавить авторизованный домен **documenterra.net**. Если для вашего портала настроен собственный домен, возможно, его также потребуется включить в этот список. 
 ![Добавление авторизованного домена.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/avtorizovannyi-domen.png)

* На следующем шаге вы сможете добавить или удалить области. Для начала убедитесь, что список областей определения для Google API включает области **электронной почты** и **openid**. 
 ![Список областей определения.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/spisok-oblastey-opredeleniya.png)

* Вы можете сгенерировать **идентификатор клиента** и **секрет клиента** для приложения, когда будет настроен экран подтверждения. Для этого укажите тип приложения как **веб-приложение**, введите внутреннее имя приложения и укажите URL-адрес перенаправления авторизации приложения. Он должен быть следующим (косая черта в конце обязательна): https://&lt;YOUR\_PORTAL\_NAME&gt;.documenterra.net/oauth2/ 
 ![Выбрать веб-приложение как тип приложения.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/vybrat-tip-prilozheniya.png) 
 ![Указать URL-адрес перенаправления авторизации приложения.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/adres-perenapravleniya-avtorizatsii.png)

* Google сгенерирует для вас идентификатор и секрет клиента: 
 ![Идентификатор и секретный ключ клиента.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/identifikator-i-sekret-klienta.png)
* Чтобы перейти к настройкам  **** Документерры, необходимо получить **авторизацию и URL-адреса токенов** от Google. Этот шаг можно пропустить, если вы настраиваете заранее заданного поставщика Google в системе Документерра. Для получения этих данных нажмите кнопку **Скачать** рядом с названием только что созданного приложения и скачайте файл **JSON**, содержащий все необходимые данные. 
 ![Скачать файл JSON приложения.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/knopka-skachat.png)

## Настройка Документерры

Теперь давайте настроим **Документерру** для работы с  **** Google в качестве **** поставщика OpenID Connect**.** Выполните следующие действия:

* Чтобы портал **Документерра** работал с поставщиком **OpenID Connect**, необходимо зарегистрировать клиента на портале. Это может сделать пользователь с правами администратора через **Настройки** → **Безопасность → Единый вход**: 
 ![Настройки единого входа в Документерре.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/nastroyki-edinogo-vhoda.png)
* На странице настроек Единого входа выберите предопределенное подключение через Google, укажите **идентификатор** ****и **секретный ключ клиента**, полученные от Google ранее. Включите подключение и сохраните настройки. 
 ![Конфигурация единого входа через Google.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/nastroyki-podklyucheniya-google.png)
* После сохранения настроек подключения вы можете установить этого поставщика в качестве поставщика по умолчанию. Для этого выберите имя клиента в поле **Авторизация через**. 
 ![Меню выбора поставщика.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/vybor-postavshika-po-umolchaniyu.png)

Если вы хотите продолжить использовать диалоговое окно входа Документерры, оставьте поле **Авторизация через** без изменений. Вы сможете войти в свой портал, используя учетные данные Google, из диалогового окна входа, нажав соответствующую кнопку:

![Кнопка &quot;Войти с помощью Google&quot; на странице логина.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/login-with-google.png)

##  Использование Google в качестве поставщика OpenID

Чтобы проверить работу автоматической авторизации через **OpenID Connect**, необходимо убедиться, что в системе существует пользователь с адресом электронной почты, который соответствует действующей учетной записи Google.

* Перейдите в **Настройки → Управление пользователями → Авторы** и нажмите **Создать автора**, чтобы добавить нового пользователя. 
 ![Создание нового пользователя.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/sozdat-polzovatelya.png)

* Укажите информацию о новом пользователе, указав адрес электронной почты, привязанный к действующей **учётной записи Google**.![Укажите данные нового пользователя в диалоговом окне создания пользователя.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/create_new_user_dialog.png)
* После создания пользователя рекомендуется выйти из учетной записи администратора или открыть новое окно браузера в режиме инкогнито. Также следует проверить, что в текущем сеансе браузера не выполнен вход с тестовой учетной записи Google. Вы можете открыть страницу **учётной записи Google**, чтобы проверить, что в системе нет активных входов. ![Выход из учетной записи Google.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/google-sign-out.png)
* Предположим, вы указали Google как способ входа по умолчанию. В таком случае при открытии страницы из публикации с ограниченным доступом по прямой ссылке, например, это может быть ссылка, которую ваш портал или приложение предоставляет в качестве ссылки на страницу справки или статью с часто задаваемыми вопросами, система перенаправляет на страницу входа в **учетную запись Google,** так как **** вход в **Google** еще не выполнен.![Вход в учетную запись Google](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/google-account-sign-in.png)
* После ввода действительных учетных данных осуществляется вход в систему Документерра. При повторном открытии этой страницы после выхода из Документерры, если в текущем сеансе браузера выполнен вход в Google, **Документерра** выполняет автоматический вход без запроса учетных данных.
* Чтобы **поставщик OpenID Connect всегда отображал подсказку для входа в систему**, можно изменить параметр **Поведение авторизации**, установив его на значение **Требуется подсказка логина**. 
 ![Выбор поведения авторизации.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/povedeniye-avtorizatsii.png)
* На этот раз, даже если вы вошли в **Google**, при входе в **Документерру** вы всё равно увидите запрос на вход от Google:![Окно выбора аккаунта для входа с помощью Google.](/resources/Storage/manual/ispolzovaniye-google-v-kachestve-postavshchika-yedinogo-vkhoda/choose-google-account.png)
* Даже если Google выбран в качестве поставщика единого входа по умолчанию, вы все еще можете войти на портал Документерры, используя собственные учетные данные (учетную запись пользователя Документерры, без SSO). Для этого перейдите по специальной ссылке: https://&lt;YOUR\_PORTAL\_NAME&gt;.documenterra.net/login/**?error=no&no-sso=true**

Отлично! Вы успешно настроили **Google** в качестве поставщика **OpenID Connect** для своего портала онлайн-документации.