Расширение Typo3 OAuth 2.0 для аутентификации и авторизации с единым входом (SSO) позволяет пользователям фронтенда и бэкенда (администраторам и клиентам) беспрепятственно входить на сайт Typo3, используя любой поставщик услуг, соответствующий стандартам OAuth 2.0 и OpenID Connect 1.0.
Расширение Typo3 OAuth & OpenID Connect Single Sign-On (SSO) позволяет безопасно входить в Typo3, используя любой поставщик OAuth и OpenID Connect, такой как Azure AD, Azure B2C, Okta, Keycloak, Salesforce и т. д. В этом расширении также поддерживаются расширенные функции единого входа (SSO), такие как сопоставление атрибутов профиля пользователя, сопоставление ролей и т. д. Открыть Чтобы узнать больше о премиум-функциях расширения Typo3 OAuth Single Sign-On (OAuth & OpenID Connect Client), перейдите по ссылке.
В этом руководстве мы рассмотрим шаги по настройке расширения единого входа miniOrange OAuth / OpenID Connect SSO.
Процедура установки
1. Установка расширения OAuth Client / OpenID Connect в TYPO3
- Загрузите zip-архив расширения OAuth/OIDC с торговой площадки TYPO3.
- Перейдите в панель управления TYPO3 и нажмите на раздел «Расширения» в левой части экрана.
- Загрузите ZIP-файл, как показано на изображении ниже.
- Теперь найдите "miniOrange OpenIDConnect" В разделе «Установленные расширения» активируйте расширение, нажав кнопку «Активировать».
- После установки нажмите на только что установленное расширение. "miniOrange OpenIDConnect" Для входа в TYPO3 SSO используйте зарегистрированные учетные данные miniOrange.
- После ввода имени пользователя и пароля вам потребуется лицензионный ключ, если вы являетесь премиум-клиентом. (Вы получите этот ключ от команды miniOrange. После ввода лицензионного ключа вы сможете активировать лицензию и продолжить.)
- Если вы не являетесь премиум-клиентом, вы можете войти в систему напрямую, используя учетные данные miniOrange.
- После успешного входа в систему вы сможете просмотреть подробную информацию о своем аккаунте.
- Теперь вы готовы настроить свой поставщик идентификации (IdP). Но важно сначала интегрировать фронтенд.
2. Интеграция расширения с TYPO3
- Теперь вам нужно разработать дизайн своего интерфейса, щелкнув левой кнопкой мыши по вкладке «Главная», а затем нажав на Новая подстраница
- Вам необходимо добавить две СТАНДАРТНЫЕ страницы на главную страницу. Если вы используете Премиум-плагин, вы можете создать три страницы.
- Здесь мы будем рассматривать названия страниц следующим образом: FEOIDC, ОТВЕТ, ВЫХОД (Выход из системы необязателен для клиентов с премиум-подпиской).
- Введите стандартное название страницы следующим образом: FEIODC.
- Нажмите на Страница FEIODC и нажмите на Добавить счастливымПерейдите в раздел плагинов и добавьте Плагин FEIODC.
- Перейдите на вкладку «Плагины» и выберите плагин FEOIDC. Добавьте пользователей сайта в Страница хранения записей и сохраните настройки.
- Если вам нужно внести изменения в сегмент URL, который также будет вашим исходным URL для единого входа (SSO), щелкните правой кнопкой мыши. Страница FEIODCВыберите «Редактировать» и нажмите на "переключить URL" кнопка для установки URL-адреса в соответствии с вашими предпочтениями.
- Выполните те же действия для создания и настройки стандартных страниц ответа.
- Убедитесь, что для страницы ответа вы выберете плагин Response, а для страницы выхода — плагин Logout.
- Ваша директория TYPO3 должна выглядеть примерно так.
- Кроме того, необходимо создать хотя бы одну группу, поскольку TYPO3 не позволяет создавать пользователей, если нет хотя бы одной группы пользователей.
- Чтобы создать группу, перейдите на вкладку «Список» в левой панели, щелкните папку «Пользователи веб-сайта» и нажмите кнопку «+» в верхней части экрана.
- Теперь выберите Группа пользователей сайта? из списка.
- В поле «Название группы» введите «Group Name» и нажмите кнопку «Сохранить» вверху. Будет создана группа пользователей.
- Вы также можете создать кнопку единого входа (SSO) на странице авторизации. Нажмите «Главная», перейдите на страницу входа. +Содержание опцию.
- Перейдите на вкладку «Специальные элементы» и выберите Простой HTML.
- Здесь вы будете добавлять кнопку входа через SSO, URL-адрес которой в разделе кнопки будет соответствовать странице стандарта FEIODC.
- Код для этого приведен на изображении. Введите код и нажмите кнопку «Сохранить» вверху.
- Теперь вы можете настроить плагин в административной панели.
3. Настройка поставщика OAuth
4. Настройка TYPO3 в качестве клиента OAuth.
5. Тестовая конфигурация
- Эта функция поможет вам определить, корректны ли отправленные конфигурации. В ответ вы также получите настроенные вами атрибуты.
- Чтобы включить проверку конфигурации, перейдите в плагин OpenID Connect, затем во вкладку «Клиент OpenID Connect», внизу вы найдете кнопку «Проверить конфигурацию», нажмите на нее, и отобразятся результаты, как показано на приведенной диаграмме.
6. Сопоставление атрибутов
- Сопоставление атрибутов можно осуществить на вкладке «Сопоставление атрибутов». В бесплатной версии расширения можно сопоставлять только имя пользователя и адрес электронной почты. Однако в премиум-версии расширения можно сопоставлять различные атрибуты, поступающие от вашего OAuth-провайдера, с атрибутами, присутствующими на вашем сайте Typo3.
7. Составление групповых карт
- В бесплатном расширении можно указать роль по умолчанию, которая будет назначена всем пользователям, не являющимся администраторами, при проведении единого входа (SSO).
- Перейдите на вкладку «Сопоставление групп» и выберите раздел «Сопоставление групп».
- Выберите роль по умолчанию и нажмите кнопку «Сохранить».
Вы успешно настроили Typo3 в качестве клиента OAuth. На вашем сайте появится кнопка SSO. Нажмите на кнопку и протестируйте SSO.
Дополнительные ресурсы
Если вы ищете что-то, чего не можете найти, пожалуйста, напишите нам по электронной почте. info@xecurify.com
