Руководство по интеграции единого входа Microsoft Entra с Documo
В этом руководстве вы узнаете, как интегрировать Documo с идентификатором Microsoft Entra. Интеграция Documo с идентификатором Microsoft Entra позволяет:
- Контроль доступа к Documo с помощью идентификатора Microsoft Entra.
- Включите автоматический вход пользователей в Documo с помощью учетных записей Microsoft Entra.
- Управление учетными записями в одном центральном расположении.
Необходимые компоненты
Чтобы приступить к работе, потребуется следующее.
- Подписка Microsoft Entra. Если у вас нет подписки, вы можете получить бесплатную учетную запись.
- Подписка Documo с поддержкой единого входа.
Описание сценария
В этом руководстве описана настройка и проверка единого входа Microsoft Entra в тестовой среде.
- Documo поддерживает вход, инициируемый поставщиком услуг и поставщиком удостоверений.
- Documo поддерживает автоматическую подготовку пользователей.
Примечание.
Идентификатор этого приложения — фиксированное строковое значение, поэтому в одном клиенте можно настроить только один экземпляр.
Добавление Documo из коллекции
Чтобы настроить интеграцию Documo с идентификатором Microsoft Entra, необходимо добавить Documo из коллекции в список управляемых приложений SaaS.
- Войдите в Центр администрирования Microsoft Entra как минимум облачные приложения Администратор istrator.
- Перейдите к приложениям>Identity>Applications>Enterprise. Новое приложение.
- В разделе Добавление из коллекции в поле поиска введите Documo.
- Выберите Documo на панели результатов и добавьте это приложение. Подождите несколько секунд, пока приложение не будет добавлено в ваш клиент.
Кроме того, можно также использовать мастер конфигурации корпоративных приложений. В этом мастере можно добавить приложение в клиент, добавить пользователей и группы в приложение, назначить роли, а также просмотреть конфигурацию единого входа. Подробнее о мастерах Microsoft 365.
Настройка и проверка единого входа Microsoft Entra для Documo
Настройте и проверьте единый вход Microsoft Entra в Documo с помощью тестового пользователя B.Simon. Для обеспечения работы единого входа необходимо установить связь между пользователем Microsoft Entra и соответствующим пользователем в Documo.
Чтобы настроить и проверить единый вход Microsoft Entra в Documo, выполните следующие действия:
- Настройте единый вход Microsoft Entra, чтобы пользователи могли использовать эту функцию.
- Создайте тестового пользователя Microsoft Entra для тестирования единого входа Microsoft Entra с помощью B.Simon.
- Назначьте тестового пользователя Microsoft Entra, чтобы разрешить B.Simon использовать единый вход Microsoft Entra.
- Настройка единого входа в Documo необходима для настройки параметров единого входа на стороне приложения.
- Создание тестового пользователя Documo требуется для того, чтобы в Documo был создан пользователь B.Simon, связанный с представлением пользователя Microsoft Entra.
- Проверка единого входа позволяет убедиться в правильности конфигурации.
Настройка единого входа Microsoft Entra
Выполните следующие действия, чтобы включить единый вход Microsoft Entra.
Войдите в Центр администрирования Microsoft Entra как минимум облачные приложения Администратор istrator.
Перейдите к приложениям>Identity>Applications>Enterprise Documo>Single sign-on.
На странице Выбрать метод единого входа выберите SAML.
На странице Настройка единого входа с помощью SAML щелкните значок карандаша, чтобы открыть диалоговое окно Базовая конфигурация SAML для изменения параметров.
В разделе Базовая конфигурация SAML не нужно выполнять никаких действий, так как приложение уже предварительно интегрировано с Azure. Если у вашей учетной записи Documo есть личный домен, для работы единого входа у вас также должен быть личный домен API. Замените значения по умолчанию своим личным доменом API, например
https://mycustomapidomain.com
иhttps://mycustomapidomain.com/assert
.Чтобы настроить приложение для работы в режиме, инициируемом поставщиком услуг, щелкните Задать дополнительные URL-адреса и выполните следующие действия.
В текстовом поле URL-адрес входа введите URL-адрес:
https://app.documo.com/sso
Нажмите кнопку Сохранить.
На странице Настройка единого входа с помощью SAML в разделе Сертификат подписи SAML найдите элемент XML метаданных федерации и выберите Скачать, чтобы скачать сертификат и сохранить его на компьютере.
Требуемые URL-адреса можно скопировать из раздела Настройка Documo.
Создание тестового пользователя Microsoft Entra
В этом разделе описано, как создать тестового пользователя B.Simon.
- Войдите в Центр администрирования Microsoft Entra как минимум пользователь Администратор istrator.
- Перейдите ко всем пользователям удостоверений>>.
- Выберите "Создать пользователя>" в верхней части экрана.
- В свойствах пользователя выполните следующие действия.
- В поле "Отображаемое имя" введите
B.Simon
. - В поле имени участника-пользователя введите username@companydomain.extensionимя пользователя. Например,
B.Simon@contoso.com
. - Установите флажок Показать пароль и запишите значение, которое отображается в поле Пароль.
- Выберите Review + create (Просмотреть и создать).
- В поле "Отображаемое имя" введите
- Нажмите кнопку создания.
Назначение тестового пользователя Microsoft Entra
В этом разделе описано, как разрешить пользователю B.Simon использовать единый вход, предоставив этому пользователю доступ к Documo.
- Войдите в Центр администрирования Microsoft Entra как минимум облачные приложения Администратор istrator.
- Перейдите к приложениям>Identity>Applications>Enterprise Documo.
- На странице обзора приложения выберите "Пользователи" и "Группы".
- Выберите Добавить пользователя или группу, а затем в диалоговом окне Добавление назначения выберите Пользователи и группы.
- В диалоговом окне Пользователи и группы выберите B.Simon в списке пользователей, а затем в нижней части экрана нажмите кнопку Выбрать.
- Если пользователям необходимо назначить роль, вы можете выбрать ее из раскрывающегося списка Выберите роль. Если для этого приложения не настроена ни одна роль, будет выбрана роль "Доступ по умолчанию".
- В диалоговом окне Добавление назначения нажмите кнопку Назначить.
Настройка единого входа Documo
Войдите на веб-сайт Documo в качестве администратора.
Последовательно выберите Account Settings ->Security (Параметры учетной записи > Безопасность).
На вкладке Security (Безопасность) нажмите кнопку Configure SSO (Настроить единый вход) в нижней части страницы.
На странице Setup SAML (Настройка SAML) выполните следующие действия.
a. В текстовое поле "Идентификатор сущности" вставьте значение идентификатора Microsoft Entra, скопированное ранее.
b. В текстовое поле URL-адрес единого входа (URL-адрес перенаправления) вставьте значение URL-адреса входа, скопированное ранее.
c. Присвойте значение параметру Email Domain (Домен электронной почты) в текстовом поле.
d. Введите значение в текстовое поле Field Name in SAML Token containing Identity email (Имя поля в токене SAML, содержащем удостоверение электронной почты).
д) Откройте скачанный XML-файл метаданных федерации в Блокнот. Найдите тег
<X509Certificate>
и вставьте его содержимое в текстовое поле Signer Certificate (Сертификат подписывающего).е) Щелкните Отправить.
Создание тестового пользователя Documo
В этом разделе описано, как в приложении Documo создать пользователя с именем B. Simon.
- Перейдите на страницу Users (Пользователи) в приложении Documo.
- Нажмите кнопку Add user (Добавить пользователя).
- Заполните форму пользователя, указав имя, адрес электронной почты, номер телефона, роль пользователя и пароль. Убедитесь, что поле электронной почты соответствует электронной почте для B.Simon в идентификаторе Microsoft Entra ID.
- Нажмите кнопку Создать.
Проверка единого входа
В этом разделе описана конфигурация единого входа Microsoft Entra с помощью следующих параметров.
Инициация поставщиком услуг:
Щелкните "Тестировать это приложение", вы будете перенаправлены по URL-адресу для входа в Documo, где можно инициировать поток входа.
Перейдите по URL-адресу для входа в Documo и инициируйте поток входа.
Вход, инициированный поставщиком удостоверений
- Щелкните "Тестировать это приложение", и вы автоматически войдете в приложение Documo, для которого настроили единый вход
Вы можете также использовать портал "Мои приложения" корпорации Майкрософт для тестирования приложения в любом режиме. Щелкнув элемент Documo на портале "Мои приложения", вы будете перенаправлены на страницу входа приложения для инициации потока входа (при настройке в режиме поставщика услуг) или автоматически войдете в приложение Documo, для которого настроен единый вход (при настройке в режиме поставщика удостоверений). Дополнительные сведения о портале "Мои приложения" см. в этой статье.
Следующие шаги
После настройки Documo вы можете применить функцию управления сеансами, которая в реальном времени защищает конфиденциальные данные вашей организации от хищения и несанкционированного доступа. Управление сеансом является расширением функции условного доступа. Узнайте, как применять управление сеансами с помощью приложений Defender для облака.
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по