Расширение Typo3 OAuth 2.0 для аутентификации и авторизации с единым входом (SSO) позволяет пользователям интерфейса и бэкэнда (администраторам и клиентам) беспрепятственно входить на сайт Typo3, используя учетные данные Azure Active Directory (Azure AD). Интеграция входа в Azure AD (единый вход Azure Active Directory OAuth) с Typo3 с использованием протокола OAuth 2.0.
Расширение Typo3 OAuth & OpenID Connect Single Sign-On (SSO) позволяет безопасно входить в Typo3, используя любой поставщик OAuth и OpenID Connect, такой как Azure B2C, Okta, Keycloak, Salesforce и т. д. В этом расширении также поддерживаются расширенные функции единого входа (SSO), такие как сопоставление атрибутов профиля пользователя, сопоставление ролей и т. д. Нажмите здесь, чтобы узнать больше о премиум-функциях расширения Typo3 OAuth Single Sign-On (клиент OAuth & OpenID Connect).
В этом руководстве мы рассмотрим, как настроить единый вход (SSO) между Typo3 и Azure AD. К концу этого руководства пользователи должны иметь возможность входить в Typo3 через Azure AD.
Предварительные условия: загрузка и установка
Установка расширения 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) Azure AD OAuth и OpenID для входа в Typo3
1. Настройте Azure AD в качестве поставщика OAuth.
Выполните следующие шаги, чтобы настроить Azure AD в качестве поставщика OAuth.
Настройте Azure AD в качестве поставщика OAuth.
- Войдите в Лазурный портал.
- Выбрать Azure Active Directory.
- В левой навигационной панели нажмите кнопку Регистрация приложений обслуживание и нажмите Новая регистрация.
- Когда появится страница «Создать», введите регистрационные данные вашего приложения. (См. таблицу ниже)
| Имя: |
Название вашего приложения. |
| Тип приложения: |
- Выбрать "Веб-приложение / API" для клиентские приложения и ресурсные/API приложения которые установлены на защищенном сервере. Этот параметр используется для конфиденциальной аутентификации OAuth. веб-клиенты и общественность клиенты на основе пользовательских агентовОдно и то же приложение может предоставлять доступ как к клиенту, так и к ресурсам/API.
|
|
URI перенаправления: |
- Для приложений типа "Веб-приложение / API" укажите базовый URL-адрес вашего приложения. Например, https:// Это может быть URL-адрес веб-приложения, работающего на вашем локальном компьютере. Пользователи будут использовать этот URL-адрес для входа в веб-приложение.
|
- Скопируйте URL-адрес обратного вызова из расширения miniOrange OAuth Client и сохраните его в текстовом поле «URL-адрес переадресации».
- Убедитесь в том, "Предоставить администратору согласие на использование разрешений openid и offline_access" Эта опция включена. После завершения нажмите Зарегистрировать филиал.
- Azure AD присваивает вашему приложению уникальный идентификатор приложения. ID приложения Ваш идентификатор клиента и Идентификатор каталога Ваш Идентификатор арендатораСохраните эти значения, так как они понадобятся вам для настройки расширения miniOrange OAuth Client.
- Перейдите на Сертификаты и секреты из левой навигационной панели и нажмите на Секрет нового клиента. Введите описание и срок действия и нажмите ДОБАВИТЬ опцию.
- Скопировать секретный ключ "стоимость" и держите это значение под рукой, оно понадобится позже для настройки. Секрет клиента в рамках расширения miniOrange OAuth Client.
Вы успешно настроили Azure AD в качестве поставщика OAuth для обеспечения единого входа (SSO) Azure AD с использованием Typo3 для аутентификации пользователей.
2. Настройка Typo3 2 в качестве клиента OAuth.
3: Сопоставление атрибутов (необязательно). *Это функция премиум-класса.
- Сопоставление атрибутов можно осуществить на вкладке «Сопоставление атрибутов». В бесплатной версии расширения можно сопоставлять только имя пользователя и адрес электронной почты. Однако в премиум-версии расширения можно сопоставлять различные атрибуты, поступающие от вашего OAuth-провайдера, с атрибутами, присутствующими на вашем сайте Typo3.
4: Групповое сопоставление (необязательно). *Это функция премиум-класса.
- В бесплатном расширении можно указать роль по умолчанию, которая будет назначена всем пользователям, не являющимся администраторами, при проведении единого входа (SSO).
- Перейдите на вкладку «Сопоставление групп» и выберите раздел «Сопоставление групп».
- Выберите роль по умолчанию и нажмите кнопку «Сохранить».
Настроив Azure AD как Поставщик OAuth и Typo3 как OAuth-клиент Используя наше расширение Typo3 OAuth Client, вы успешно установили функцию единого входа (SSO) Typo3 Azure AD. Благодаря этому решению, всего за несколько минут вы сможете обеспечить безопасный доступ к вашему сайту Typo3, используя учетные данные Azure AD.
Дополнительные ресурсы
Если вы ищете что-то, чего не можете найти, пожалуйста, напишите нам по адресу magentosupport@xecurify.com.
