Интеграция Lucid SAML SSO с Active Directory Federation Services (ADFS)

Автор:  Shanna S
Обновлено:  

Интеграция Lucid с ADFS позволяет вашим пользователям аутентифицироваться с помощью единого входа SAML через ADFS. В следующем руководстве описывается процесс интеграции ADFS с Lucid.

Доступность плана: Только корпоративный.

Загрузи метаданные федерации и импортируй их в Lucid

  1. Загрузите метаданные федерации. 
    • Метаданные федерации можно получить на сервере ADFS по следующему URL-адресу, заменив [myserver.domain] на URL-адрес вашего сервера ADFS:
      https://[myserver.domain].com/FederationMetadata/2007-06/FederationMetadata.xml
  2. Перейди в панель администратора Lucid.
  3. Выбери вкладку App Integration .
  4. В выпадающем списке App integration выбери General.
  5. Кликни Settings в плитке интеграции "SAML".
  6. Загрузи метаданные XML в Lucid с помощью программы выбора файлов.
    • Примечание: Если у тебя есть это в текстовом формате, пожалуйста, сохрани это как XML-файл, а затем загрузи его в Lucid.

Настрой доверие доверенной стороны Lucid в ADFS

Далее создай и настройте Relying Party Trust, используя метаданные Lucid. 

Примечание: Используй эти точные инструкции независимо от того, используешь ли ты Lucidchart, Lucidspark или и то, и другое.

  1. На странице Lucid SAML выбери Download Metadata , чтобы загрузить метаданные Lucid.
  2. Сохраните метаданные в месте, доступном для сервера ADFS.
    section-of-the-admin-panel-app-integration-tab-to-save-metadata.png
  3. Открой ADFS и щелкни правой кнопкой мыши Relying Party Trust.
  4. Чтобы открыть мастер добавления доверенного лица , выберите в меню пункт «Добавить доверенное лицо».
    add-relying-party-selection-in-adfs.png
  5. Пройдись по подсказкам экрана приветствия.
  6. На экране "Выбор источника данных" выбери Импорт данных о полагающейся стороне из файла.
  7. Выбери Browse и найди файл метаданных Lucid.
  8. Завершите оставшиеся настройки в соответствии с предпочтениями вашей организации.
    add-relying-party-trust-wizard-in-adfs.png
  9. Откройте конфигурацию конечных точек для доверия между сторонами, использующими Lucid. 
    • Тебе нужно будет добавить еще одну конечную точку, чтобы ADFS хранил входящий URL входа в систему в сравнении с предоставленным ACS/ответным URL. Настройки должны быть такими:
      • Тип = SAML Consumer Assertion
      • Связывание = POST
      • Индекс = 1
      • Доверенный URL-адрес =https://www.lucidchart.com/saml/sso/ идентификатор сущности IDP

      • После завершения конфигурация будет выглядеть следующим образом:
        example-of-an-adfs-endpoint.png
  10. Щелкни правой кнопкой мыши на Lucid Relying Party Trust и выбери Edit Claim Rules.
  11. Добавьте правило обработки утверждений с использованием LDAP и настройте его в соответствии с атрибутами и типами утверждений, указанными ниже.
    example-of-how-to-add-a-claim-rule-in-adfs.png
  12. Нажмите Готово.

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

У вас есть возможность использовать зашифрованные утверждения для поставщиков идентификации, которые вы добавляете для SAML в свою учетную запись Lucid. Чтобы узнать больше, обратитесь к нашей статьес обзором SAML.

Помощь всё ещё нужна

Устранение неполадок

Неверный ответ SAML

Эта ошибка соответствует неправильному ответу SAML от IDP. Обычно это означает, что алгоритм хеширования необходимо переключить с «SHA-1» на «SHA-256» в ADFS. Перейдите к Lucid Relying Party Trust, щелкните правой кнопкой мыши и выберите «Свойства». Перейдите на вкладку «Дополнительно» и переключите алгоритм хеширования с «SHA-1» на «SHA-256».

SAML не настроен для вашей команды. Запросите приглашение от команды с поддержкой SAML.

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

Недействительный атрибут идентичности

Эта ошибка указывает на то, что в ответе SAML был получен недопустимый атрибут идентификации. Настройте атрибут утверждения для Lucid Relying Party Trust, где «адреса электронной почты» соответствуют «идентификатору имени» в ADFS.

Не удалось проанализировать XML

Эта ошибка указывает на неправильный синтаксис в метаданных XML поставщика удостоверений. Это может произойти при загрузке метаданных из окна Internet Explorer. Internet Explorer будет добавлять тире к тегам XML для разворачивания и сворачивания. Вы можете решить эту проблему, открыв XML-данные в текстовом редакторе или удалив все тире в скопированном XML-тексте.

username_12345@example.com Создаваемые пользователи

Интеграция Lucid SAML принимает 3 атрибута: имя, фамилию и адрес электронной почты. Когда от поставщика удостоверений SAML передается недействительный адрес электронной почты, для создания пользователя будет создан действительный адрес электронной почты: «переданное значение» + «SAML ID» + «@ example.com». Это часто происходит, когда имя пользователя или данное имя передается в атрибут адреса электронной почты вместо действительного адреса электронной почты. Вы можете решить эту проблему, настроив правило утверждения для отправки действительного адреса электронной почты в атрибуте «Адрес электронной почты».

ADFS не возвращает ответ в Lucid

Проверьте конечные точки, чтобы убедиться, что вы выполнили шаги, перечисленные в шагах настройки ADFS. Если у вас всего одна конечная точка или ваш www. конечная точка проиндексирована до вашего приложения. конечная точка, ответ не вернется в Lucid.

Оставьте отзыв об этой статье

Хотите поделиться мнением об этой статье? Расскажи нам о своем опыте здесь. 

Вы нашли то, что искали?

Остались вопросы или хотите поделиться тем, что узнали? Посетите наше сообщество для получения помощи и совместной работы с другими.