Интеграция Lucid с Azure позволяет твоим пользователям проходить аутентификацию с помощью SAML single-sign on через Azure. Azure также предлагает SCIM-соединение, которое позволяет тебе предоставлять пользователей в IDP. В следующем руководстве рассматривается процесс интеграции Azure с Lucidchart и Lucidspark. Тебе понадобятся права администратора как в Azure, так и в Lucid, чтобы настроить эту интеграцию.

Эта интеграция доступна только для аккаунтов Enterprise. Инструкции по обновлению см. в статье Обновление твоего аккаунта Lucid .

Настрой интеграцию SAML для Lucid через Azure Portal

Чтобы настроить интеграцию SAML для Lucid через Azure Portal, выполни следующие шаги:

В Азуре:

Войди в систему Azure.
На главной странице перейди по ссылке Azure Active Directory в навигационном меню с левой стороны.
Выбери Enterprise Applications в навигационном меню с левой стороны.
Нажми +Новое приложение в левом верхнем углу страницы.
Набери в поисковике "Lucid" и выбери плитку Lucid (All Products) .
Нажмите Создать.
В приложении перейди в раздел "Настройка единого входа".
Under Single Sign-on Mode, выберите SAML.
Выберите «Изменить » в базовой конфигурации SAML. Ваши настройки в Azure должны выглядеть так, как показано в примере ниже:
- ID сущности: lucidchart.com
- URL-ссылка для ответа по умолчанию: https://lucid.app/saml/sso/<yourdomainnamehere>
- Вторичная ссылка URL Reply: https://www.lucidchart.com/saml/sso/<yourdomainnamehere>
- Ссылка URL для входа: https://lucid.app/saml/sso/<yourdomainnamehere>
Щелкните Сохранить .
Подтвердите, что идентификатор пользователя — «user.userprincipalname».
- Все основные атрибуты и утверждения должны быть настроены уже по умолчанию.
Нажмите Сохранить .
Uв разделе "Federation Metadata XML" выбери Download , чтобы получить метаданные IDP.
- Не открывайте файл XML (метаданные). Вы загрузите сохраненный файл в Lucid.

В Люсиде:

Выберите Админ .
Щелкните Управление идентификацией в меню слева.
Выберите Configure справа от опции "Allow SAML authentication", чтобы перейти на страницу активации SAML в Lucid.
- Ты не сможешь включить SAML, пока не заполнишь свой домен и не загрузишь метаданные.
В разделе "Lucidchart Sign in URL" введи свое доменное имя.
Щелкните Сохранить изменения.
Sпрокрути вниз на странице SAML Activation в Lucidchart и нажми Add Identity Provider.
Загрузите XML-файл (метаданные), загруженный из Azure.
Нажмите «Проверить соединение SAML» , чтобы убедиться, что Lucid правильно взаимодействует с Azure.
- Подключение будет работать только в том случае, если приложение Lucid (All Products) было назначено твоему тестовому пользователю в Azure. Ты можешь назначить приложение пользователям в разделе "Назначения" на странице приложения. Для этого перейди в раздел "Пользователи и группы" с левой стороны и нажми Назначить.
Вернитесь на страницу управления идентификацией.
Установите флажок рядом с «Разрешить аутентификацию SAML».
Щелкните Сохранить изменения .

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

Создание пользователей при входе в систему с помощью SAML

После того, как вы настроили SAML с Azure для своей учетной записи Lucid, вы можете настроить своевременную подготовку, чтобы пользователи, которым назначен доступ Lucid в Azure, у которых нет учетной записи Lucid, имели учетную запись, созданную для них при первом входе в систему. .

Примечание. Чтобы этот тип подготовки работал, у вас должен быть включен контроль домена.

Чтобы разрешить создание новых пользователей для пользователей, назначенных приложению:

Перейди на вкладку "Свойства" на странице твоего приложения Lucid (All Products) в Azure.
Прокрутите страницу вниз и выберите «Требуется назначение пользователя?» на «Нет».
Щелкните Сохранить .
Выбери Пользователи и группы в меню "Управление".
Выберите и назначьте пользователей и / или группы для доступа к приложению Lucid (Все продукты) .

Затем ты можешь настроить Just-In-Time provisioning в разделе License settings твоей административной панели Lucid.

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

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

Настрой SCIM с помощью приложения Lucid (все продукты)

Настрой интеграцию Lucid SCIM, используя приложение Lucid (All Products) из галереи Azure AD. Ты можешь использовать SCIM для создания пользователей Lucid до их первого входа в систему и для назначения им определённого типа лицензии.

Прежде чем настраивать SCIM, тебе нужно сделать следующее:

Подтверди, что у тебя учётная запись Enterprise с актуальным тарифным планом. Чтобы обновить его, обратись в наш отдел продаж.
Обратись к своему менеджеру по работе с клиентами Lucid или в службу поддержки, чтобы запросить включение SCIM для твоего аккаунта.

После того как ты выполнишь перечисленные выше шаги по предварительной настройке, сконфигурируй SCIM для Lucid в Azure, выполнив следующие действия:

Войди в систему Azure.
На главной странице перейди по ссылке Azure Active Directory в навигационном меню с левой стороны.
Выбери Enterprise Applications в навигационном меню с левой стороны.
Нажми +Новое приложение в левом верхнем углу страницы.
Набери в поисковике "Lucid" и выбери плитку Lucid (All Products) .
Нажмите Создать.

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

Чтобы создать роли приложений:

Выбери Azure Active Directory в навигационном меню в левой части главной страницы Azure.
В навигационном меню с левой стороны перейди по ссылке Регистрация приложений .
Выбери вкладку Все приложения .
Перейди в приложение Lucid (All Products) .

Настройка роли приложения "Licensed User"

Выбери App roles из меню с левой стороны.
Щелкни User из существующих ролей приложений.
Обнови следующие настройки. Текст должен быть набран точно так, как показано ниже:
- Отображаемое имя: изменить с "Пользователь" на "Licensed User"
- Значение: Введи значение "true".
- Описание: Изменить с "Пользователь" на "Licensed User"
Нажмите Применить.

Настройте роль приложения "Limited Access User"

Выбери App roles из меню с левой стороны.
Щелкни msiam_access из существующих ролей приложений.
Обнови следующие настройки. Текст должен быть набран точно так, как показано ниже:
- Отображаемое имя: изменить с "msiam_access" на "Limited Access".
- Значение: Введи значение "false".
- Описание: Измени с "msiam_access" на "Limited Access".
Нажмите Применить.

Создайте группы пользователей

Создай новые или дополнительные группы, выполнив следующие действия:

Выбери Azure Active Directory в навигационном меню в левой части главной страницы Azure.
В навигационном меню с левой стороны щелкни Groups .

Создай группу "Lucid Suite Licensed Users".

Нажмите Новая группа.
Обнови следующие настройки:
- Название группы: "Lucid Suite Licensed Users".
- Введите описание группы (необязательно).
Нажмите Создать.

Создай группу "Lucid Suite Limited Access Users".

Нажмите Новая группа.
Обнови следующие настройки:
- Название группы: "Lucid Suite Limited Access Users".
- Введите описание группы (необязательно).
Нажмите Создать.

Назначьте группы в приложении Lucid (все продукты)

Выбери Azure Active Directory в навигационном меню в левой части главной страницы Azure.
Выбери Enterprise Applications в навигационном меню с левой стороны.
Открой приложение Lucid (All Products) .
Щелкните Users and Groups.

Назначьте группу "Licensed User"

Нажмите Добавить пользователя/группу.
В разделе "Пользователи и группы" нажми None Selected.
Найди группу "Lucid Suite Licensed User".
Выберите группу и нажмите Выбрать.
В разделе "Выберите роль" щелкните None Selected.
Выберите Licensed User.
Нажмите Выберите.
Нажмите Assign.

Назначьте группу "Limited Access User"

Нажмите Добавить пользователя/группу.
В разделе "Пользователи и группы" нажми None Selected.
Найди группу "Lucid Suite Limited Access User".
Выберите группу и нажмите Выбрать.
В разделе "Выберите роль" щелкните None Selected.
Выберите Limited Access.
Нажмите Выберите.
Нажмите Назначить.

Создание отображений атрибутов выражения

Получите токен на предъявителя от Lucid

Прежде чем создавать сопоставления атрибутов выражения в Azure, тебе необходимо получить от Lucid токен носителя. Для этого выполни следующие действия:

Войди в Lucid как владелец аккаунта или администратор команды.
Выбери Admin в навигационном меню с левой стороны.
В навигационном меню на левой стороне перейди по ссылке App Integration .
В разделе "SCIM" перейди по ссылке Settings.
Если токен на предъявителя еще не существует, нажми Generate Token.
- Если Generate Token не нажимается, убедись, что опция "Automatically upgrade account when no more licenses are available" отмечена, и повтори попытку.

Создайте отображение атрибутов выражения

Получив от Lucid токен на предъявителя, выполни следующие действия:

Открой приложение Lucid (All Products) .
Выбери Provisioning в навигационном меню с левой стороны.
Нажмите Начать работу.
Из выпадающего списка "Provisioning Mode" выбери Automatic.
В разделе "Учетные данные администратора" введите https://users.lucid.app/scim/v2/azure. в разделе "URL-адрес арендатора".
Введи токен на предъявителя в поле "Secret Token", используя токен, который ты получил от Lucid в шагах выше.
Нажмите Test Connection.
Если подключение прошло успешно, нажми Сохранить.
В разделе "Mappings" перейди по ссылке Provision Azure Active Directory Users.
Внизу страницы нажми Add New Mapping .
В диалоговом окне "Edit Attribute" введи следующие значения:
- Тип отображения: "Выражение"
- Выражение: "Switch(SingleAppRoleAssignment([appRoleAssignments]), , "Лицензированный пользователь", "True", "Ограниченный доступ", "False")"
- Целевой атрибут: "urn:ietf:params:scim:schemas:extension:lucid:2.0:User:productLicenses:Lucidchart"
Нажмите Ok.
Нажмите Сохранить.

Повтори шаги 12-15, чтобы создать дополнительное отображение выражений. Вместо того чтобы выбрать целевой атрибут Lucidchart, выбери атрибут, заканчивающийся на "Lucidspark".

Проведение испытаний

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

Назначь тестового пользователя в "Lucid Suite Licensed User Group".
Открой приложение Lucid (All Products) .
Выбери Provisioning в навигационном меню с левой стороны.
Выбери пункт Обеспечение по запросу из меню в верхней части страницы.
Введи имя тестового пользователя, которого ты назначил в Lucid Suite Licensed User Group
Нажмите Обеспечение.

Те же шаги можно выполнить для проверки "Limited Access User Group".

Если все работает так, как задумано, то ты увидишь:

Зеленые галочки напротив всех шагов
Целевые атрибуты Lucidchart и Lucidspark = "True"

Если ни того, ни другого не произошло, просмотри шаги по настройке, описанные выше.

Часто задаваемые вопросы

В чем разница между системой единого входа Microsoft и входом в Azure SAML?
Microsoft SSO и вход в Azure SAML управляются с портала Azure. SAML использует протокол SAML2.0, в то время как MS SSO использует OAuth2.0 OpenID. Как правило, настройки SAML считаются более безопасными, поскольку шифрование выполняется на транспортном уровне (SSL).

Что происходит с документами, когда я отменяю лицензию на пользователя через SCIM?
Когда ты делицензируешь или удаляешь пользователя через SCIM, ты должен передать его документы другому пользователю на твоей учетной записи Enterprise. Это не относится к случаям деактивации пользователей.

По умолчанию владелец аккаунта будет получателем документов, которые автоматически передаются при делицензировании или удалении пользователя. Ты можешь изменить получателя передаваемых документов, перейдя в настройки интеграции SCIM в панели администратора и выбрав Изменить владельца по умолчанию справа от адреса электронной почты. Для справки смотри скриншот ниже.

Щелчок на кнопке Изменить владельца по умолчанию перенаправляет тебя на страницу "Настройки документа & папки" панели администратора Lucid, где ты можешь изменить владельца документа по умолчанию в своей учётной записи. Обратись к статье Панель администрирования Lucid: Документ и папки статью для получения дополнительной информации.
change-recipient-of-documents-when-deleting-or-delicensing-users-via-SCIM.png

Похожие статьи