В этом разделе приведены инструкции по переходу с классического интерфейса на интерфейс Edge с использованием IDP, например LDAP или SAML.
Статьи по теме
Кто может выполнить перенос
Чтобы перейти на Edge UI, необходимо войти в систему как пользователь, который изначально установил Edge, или как пользователь root. После запуска установщика для Edge UI любой пользователь может настроить их.
Подготовка
Прежде чем переходить с классического интерфейса на Edge, ознакомьтесь со следующими общими рекомендациями:
- Как создать резервную копию узлов классического интерфейса
Перед обновлением Apigee рекомендует создать резервную копию существующего сервера классического интерфейса.
- Порты и брандмауэры
По умолчанию классический интерфейс использует порт 9000. Интерфейс Edge использует порт 3001.
- Новая виртуальная машина
Пользовательский интерфейс Edge нельзя установить на ту же виртуальную машину, что и классический пользовательский интерфейс.
Чтобы установить Edge UI, необходимо добавить в конфигурацию новую машину. Если вы хотите использовать тот же компьютер, что и для классического интерфейса, полностью удалите классический интерфейс.
- Поставщик идентификационной информации (LDAP или SAML)
Пользовательский интерфейс Edge выполняет аутентификацию пользователей с помощью SAML или LDAP IDP:
- LDAP. Вы можете использовать внешний поставщик идентификационной информации LDAP или внутреннюю реализацию OpenLDAP, которая устанавливается вместе с Edge.
- SAML. Поставщик идентификационной информации SAML должен быть внешним.
Подробнее о том, как установить и настроить поставщиков идентификационной информации…
- Тот же поставщик идентификационной информации
В этом разделе предполагается, что после переноса вы будете использовать того же поставщика идентификационной информации. Например, если вы сейчас используете внешний поставщик идентификационной информации LDAP с классическим интерфейсом, то вы продолжите использовать внешний поставщик идентификационной информации LDAP с интерфейсом Edge.
Перенос с помощью внутреннего поставщика идентификационной информации LDAP
При переходе с классического интерфейса на интерфейс Edge в конфигурации, в которой в качестве поставщика идентификационной информации используется внутренняя реализация LDAP (OpenLDAP), следуйте приведенным ниже рекомендациям.
- Конфигурация косвенной привязки
Установите Edge UI, следуя этим инструкциям, и внесите следующие изменения в файл конфигурации для автоматической установки:
Настройте LDAP для использования поиска и привязки (косвенной), как показано в следующем примере:
SSO_LDAP_PROFILE=indirect SSO_LDAP_BASE_URL=ldap://localhost:10389 SSO_LDAP_ADMIN_USER_DN=uid=admin,ou=users,ou=global,dc=apigee,dc=com SSO_LDAP_ADMIN_PWD=Secret123 SSO_LDAP_SEARCH_BASE=dc=apigee,dc=com SSO_LDAP_SEARCH_FILTER=mail={0} SSO_LDAP_MAIL_ATTRIBUTE=mail - Базовая аутентификация для Management API
Базовая аутентификация для API по умолчанию продолжает работать для всех пользователей LDAP, когда включена система единого входа Apigee. При желании вы можете отключить базовую аутентификацию, как описано в разделе Как отключить базовую аутентификацию в Edge.
- Аутентификация OAuth2 для Management API
Аутентификация на основе токенов включается вместе с системой единого входа.
- Новый процесс создания имени пользователя и пароля
Новых пользователей необходимо создавать с помощью API, поскольку в Edge UI больше не будут работать процессы, связанные с паролями.
Перенос с помощью внешнего поставщика идентификационной информации LDAP
При переходе с классического интерфейса на интерфейс Edge в конфигурации, в которой в качестве поставщика идентификационной информации используется внешняя реализация LDAP, следуйте приведенным ниже рекомендациям.
- Конфигурация LDAP
Установите Edge UI, следуя этим инструкциям. Вы можете настроить прямое или косвенное связывание в файле конфигурации для автоматической установки.
- Конфигурация сервера управления
После включения системы единого входа Apigee удалите все внешние свойства LDAP, определенные в файле
/opt/apigee/customer/application/management-server.properties, и перезапустите сервер управления. - Базовая аутентификация для Management API
Базовая аутентификация работает для пользователей компьютеров, но не для пользователей LDAP. Это будет критически важно, если в вашем процессе CI/CD для доступа к системе по-прежнему используется базовая аутентификация.
- Аутентификация OAuth2 для Management API
Пользователи LDAP могут получить доступ к Management API только с помощью токенов.
Перенос с помощью внешнего поставщика идентификационной информации SAML
При переходе на Edge UI инструкции по установке поставщика идентификационной информации SAML не меняются.