Расширение Typo3 OAuth 2.0 для аутентификации и авторизации с единым входом (SSO) позволяет пользователям фронтенда и бэкенда (администраторам и клиентам) беспрепятственно входить на сайт Typo3, используя учетные данные Keycloak. Расширение Typo3 OAuth / OpenID Connect для единого входа (SSO) упрощает использование OAuth2 для настройки входа Keycloak в Typo3 (единый вход Keycloak).
Расширение 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).
В этом руководстве мы рассмотрим, как настроить единый вход (SSO) между Typo3 и Keycloak. К концу этого руководства пользователи должны иметь возможность входить в Typo3 через Keycloak.
Предварительные условия: загрузка и установка
Установка расширения OAuth Client / OpenID Connect в TYPO3
- Для установки расширения с помощью Composer используйте следующую команду:
composer req miniorange/miniorange_oidc
- Теперь найдите "miniOrange OpenIDConnect" В разделе «Установленные расширения» активируйте расширение, нажав кнопку «Активировать».
- После установки нажмите на только что установленное расширение. "miniOrange OpenIDConnect" Для входа в TYPO3 SSO используйте зарегистрированные учетные данные miniOrange.
- После ввода имени пользователя и пароля вам потребуется лицензионный ключ, если вы являетесь премиум-клиентом. (Вы получите этот ключ от команды miniOrange. После ввода лицензионного ключа вы сможете активировать лицензию и продолжить.)
- Если вы не являетесь премиум-клиентом, вы можете легко войти в систему, введя учетные данные miniOrange.
- После успешного входа в систему вы сможете просмотреть подробную информацию о своем аккаунте.
- Теперь вы готовы настроить свой поставщик идентификации (IdP). Но важно сначала интегрировать фронтенд.
- Загрузите zip-архив расширения OAuth/OIDC с торговой площадки TYPO3.
- Перейдите в панель управления TYPO3 и нажмите на раздел «Расширения» в левой части экрана.
- Загрузите ZIP-файл, как показано на изображении ниже.
- Теперь найдите "miniOrange OpenIDConnect" В разделе «Установленные расширения» активируйте расширение, нажав кнопку «Активировать».
- После установки нажмите на только что установленное расширение. "miniOrange OpenIDConnect" Для входа в TYPO3 SSO используйте зарегистрированные учетные данные miniOrange.
- После ввода имени пользователя и пароля вам потребуется лицензионный ключ, если вы являетесь премиум-клиентом. (Вы получите этот ключ от команды miniOrange. После ввода лицензионного ключа вы сможете активировать лицензию и продолжить.)
- Если вы не являетесь премиум-клиентом, вы можете войти в систему напрямую, используя учетные данные miniOrange.
- После успешного входа в систему вы сможете просмотреть подробную информацию о своем аккаунте.
- Теперь вы готовы настроить свой поставщик идентификации (IdP). Но важно сначала интегрировать фронтенд.
Интеграция расширения с TYPO3
- Нажмите на Страницы из левой навигации.
- Затем вам нужно создать папку для хранения данных пользователей фронтенда, щелкнув по ней правой кнопкой мыши. Главная страницу и выберите Новая подстраница.
- Выбрать Папка Выберите нужный тип из выпадающего списка.
- Назовите папку как Пользователи веб-сайта и нажмите на Сохранить.
- Перейдите на вкладку «Поведение» и добавьте Пользователи веб-сайта в нем.
- Если рядом с созданной папкой вы видите красный дефис, это означает, что папка не активирована. Вы можете активировать её, щёлкнув правой кнопкой мыши по этой папке и выбрав соответствующий пункт. Включите.
- Вам нужно добавить два STANDARD страницы внутри Главная страница. Если вы используете премиум-плагин, вы можете создать три страницы.
- Здесь мы будем рассматривать названия страниц следующим образом: FEOIDC, ОТВЕТ, ВЫХОД (Выход из системы необязателен для клиентов с премиум-подпиской).
- Чтобы создать FEIODC страница, щелкните правой кнопкой мыши на Главная затем выберите страницу Новая подстраница и STANDARD Выберите тип из выпадающего списка.
- Добавить заголовок страницы как FEIODC и нажмите Сохранено.
- И снова нажмите Страница FEIODC и нажмите на Добавить счастливымПерейдите в раздел плагинов и добавьте Плагин FEIODC и нажмите на Сохранено.
- Перейдите на вкладку «Плагины» и выберите плагин FEIODC.
- Добавить пользователей сайта Страница хранения записей и сохраните настройки.
- Вы можете включить FEIODC страницу, щелкнув правой кнопкой мыши и выбрав Включите опцию.
- Если вам необходимо внести изменения в сегмент URL, который также будет вашим исходным URL для единого входа (SSO), щелкните правой кнопкой мыши на странице FEOIDC, выберите «Редактировать» и нажмите кнопку «Переключить URL», чтобы установить URL в соответствии с вашими предпочтениями.
- Выполните те же действия для создания и настройки стандартных страниц ответа.
- Убедитесь, что для страницы ответа вы выберете плагин Response.
- Держите FEIODC и ОТВЕТ URL-адреса страниц пригодятся, так как они понадобятся вам при настройке расширения OAuth/OpenID Connect.
Шаги по настройке единого входа (SSO) Keycloak OAuth и OpenID для входа в Typo3
1. Настройте Keycloak в качестве поставщика OAuth.
Выполните следующие шаги, чтобы настроить Keycloak в качестве поставщика OAuth.
Настройте Keycloak как поставщик OAuth
- Прежде всего, Скачать Keycloak и установить его.
- Запуск сервера: Запустите сервер Keycloak, выполнив файл _standalone.sh_.
Корневой каталог файла keycloak/bin/standalone.sh
- Добавить Realm: Теперь войдите в консоль администрирования Keycloak и перейдите к нужному вам домену. Добавить новый домен можно, выбрав соответствующий пункт. Добавить область опцию.
- Создать королевство: Введите название королевства и нажмите СОЗДАТЬ для добавления области.
- Создать роль: Роль будет использоваться вашими приложениями для определения того, какие пользователи будут иметь право доступа к приложению. Нажмите на кнопку. роли и выберите Добавить Роли.
- Добавить пользователя: Нам необходимо добавить в Realm пользователей, которые смогут получить доступ к ресурсам Realm. Нажмите на кнопку. Пользователи и выбрать Добавление нового пользователя.
- Конфигурация пользователя: После создания пользователя необходимо выполнить над ним следующее действие.
- Пользователь карты: Нам нужно сопоставить пользователя с ролью. Нажмите здесь. Сопоставление ролей и назначьте пользователю желаемую роль из доступных ролей и нажмите на добавить выбранное.
- Создать группы: Нажмите на Группы , а затем выбрать Новое чтобы создать новую группу.
- Назначить пользователя в группу: Выберите пользователя, которого хотите добавить в группу. На вкладке «Группы» выберите пункт «Группы», затем выберите название группы и нажмите на него. присоединиться.
- Создать клиент OpenID: Нажмите на Наши клиенты , а затем выбрать Создайте Для создания нового клиента введите любую случайную строку. идентификатор клиента И держите его под рукой, потому что он понадобится вам на следующем шаге. Выберите протокол клиента. openeid-connect и Сохранено.
- Enter Изменить тип доступа: После создания клиента измените его тип доступа на конфиденциальный
- Введите действительные URL-адреса перенаправления: Скопируйте URL-адрес обратного вызова (Введите из miniOrange Typo3 OAuth Single Sign On (SSO) плагин, который вы скопировали на предыдущем шаге), на предыдущем шаге, а затем нажмите на СПАСТИ.
Пример: https://oauth/callback
- Групповой картограф Keycloak: Чтобы получить сведения о группе, нам нужно выполнить сопоставление клиента с членством в группе, иначе сведения о группе не будут получены. Поэтому в разделе выбора клиента... Картографы а затем нажмите СоздайтеВыберите тип картографа. Членство в группах и введите имя и имя токена, то есть имя атрибута, соответствующее группам, которые будут получены, и нажмите Сохранено
Примечание: — Если полный путь указан в пути к группе, будет получен путь к группе, в противном случае будет получено имя группы.
- Получить секрет клиента: Теперь нам нужно получить секрет клиента. Выберите Наши клиенты и выберите учетные данные и скопируйте свой секрет отсюда.
Вы успешно настроили Keycloak в качестве поставщика OAuth для реализации единого входа (SSO) Keycloak с использованием Typo3 для аутентификации пользователей.
2. Настройка Typo3 в качестве клиента OAuth.
3: Сопоставление атрибутов (необязательно). *Это функция премиум-класса.
- Сопоставление атрибутов можно осуществить на вкладке «Сопоставление атрибутов». В бесплатной версии расширения можно сопоставлять только имя пользователя и адрес электронной почты. Однако в премиум-версии расширения можно сопоставлять различные атрибуты, поступающие от вашего OAuth-провайдера, с атрибутами, присутствующими на вашем сайте Typo3.
4: Групповое сопоставление (необязательно). *Это функция премиум-класса.
- В бесплатном расширении можно указать роль по умолчанию, которая будет назначена всем пользователям, не являющимся администраторами, при проведении единого входа (SSO).
- Перейдите на вкладку «Сопоставление групп» и выберите раздел «Сопоставление групп».
- Выберите роль по умолчанию и нажмите кнопку «Сохранить».
Настроив Плащ как Поставщик OAuth и Typo3 как OAuth-клиент Используя наше расширение Typo3 OAuth Client, вы успешно установили систему единого входа (SSO) Typo3 Keycloak. Благодаря этому решению, всего за несколько минут вы сможете обеспечить безопасный доступ к вашему сайту Typo3, используя учетные данные Keycloak.
Дополнительные ресурсы
Если вы ищете что-то, чего не можете найти, пожалуйста, напишите нам по адресу info@xecurify.com.