Переход на новый интерфейс Edge

Начиная с версии Apigee Edge для Private Cloud 4.54.00 классический интерфейс (edge-ui) удален, а новый интерфейс Edge (edge-management-ui) используется по умолчанию. В этом разделе приведены инструкции по переходу с классического интерфейса на новый интерфейс Edge, в том числе для развертываний, в которых используется IDP, например LDAP или SAML.

Статьи по теме

Кто может выполнить перенос

Чтобы перейти на новый интерфейс Edge, необходимо войти в систему как пользователь, который изначально установил Edge, или как пользователь root. После запуска установщика для New Edge UI любой авторизованный пользователь может настроить его.

Подготовка

Прежде чем переходить с классического интерфейса на новый интерфейс Edge, ознакомьтесь со следующими общими рекомендациями:

  • Как создать резервную копию существующей конфигурации классического интерфейса

    Перед обновлением до версии 4.54.00 Apigee рекомендует создать резервную копию существующих файлов конфигурации классического интерфейса, чтобы вы могли перенести пользовательские настройки (такие как SMTP, TLS, время ожидания сеанса и свойства брендинга) в /opt/apigee/customer/application/management-ui.properties.

  • Порты и брандмауэры

    По умолчанию в классическом интерфейсе использовался порт 9000. Новый интерфейс Edge использует порт 3001 (настраивается с помощью conf_uebe_port).

  • Удаление классического интерфейса

    Если вы устанавливаете New Edge UI на узел, на котором ранее размещался Classic UI, удалите Classic UI (edge-ui) перед установкой New Edge UI (edge-management-ui).

  • Аутентификация (базовая аутентификация, LDAP или SAML)

    В Edge for Private Cloud 4.54.00 новый интерфейс Edge поддерживает как базовую аутентификацию (AUTH_MODE=basic), так и аутентификацию через внешнего поставщика идентификационной информации с помощью Apigee SSO (AUTH_MODE=sso).

    • Базовая аутентификация. Использует внутреннюю реализацию OpenLDAP (apigee-openldap) без необходимости в системе единого входа.
    • Поставщик идентификационной информации LDAP (с использованием системы единого входа Apigee). Использует внешний поставщик идентификационной информации LDAP или внутреннюю реализацию OpenLDAP (apigee-openldap) с системой единого входа Apigee.
    • SAML IDP (с использованием системы единого входа Apigee). Использует внешний SAML IDP с системой единого входа Apigee.

    Подробнее о том, как установить и настроить поставщиков идентификационной информации…

  • Тот же поставщик идентификационной информации

    В этом разделе предполагается, что после переноса вы будете использовать того же поставщика идентификационной информации. Например, если вы ранее использовали внешний поставщик идентификационной информации LDAP с классическим интерфейсом, то вы продолжите использовать внешний поставщик идентификационной информации LDAP с новым интерфейсом Edge.

Перенос с помощью внутреннего поставщика идентификационной информации LDAP

Если вы используете внутреннюю реализацию OpenLDAP (apigee-openldap), вы можете использовать базовую аутентификацию непосредственно в новом интерфейсе Edge (см. Как настроить новый интерфейс Edge) или настроить систему единого входа Apigee с внутренним LDAP, следуя приведенным ниже инструкциям.

  • Конфигурация LDAP и New Edge UI

    Установите и настройте New Edge UI и Apigee SSO, следуя инструкциям в статьях Configure the New Edge UI (Настройка New Edge UI), Install and configure Apigee SSO (Установка и настройка Apigee SSO) и Configure your LDAP IDP (Настройка поставщика идентификационной информации LDAP).

  • Базовая аутентификация для Management API

    По умолчанию базовая аутентификация для API продолжает работать для всех пользователей LDAP, когда включена система единого входа Apigee. При желании вы можете отключить базовую аутентификацию, как описано в разделе Как отключить базовую аутентификацию в Edge.

  • Аутентификация OAuth2 для Management API

    Аутентификация на основе токенов включается, когда вы включаете Apigee SSO.

Как выполнить перенос с внешним поставщиком идентификационной информации LDAP

При переносе данных из классического интерфейса в новый интерфейс Edge в конфигурации, в которой в качестве поставщика идентификационной информации используется внешняя реализация LDAP, следуйте приведенным ниже рекомендациям.

Перенос с внешним поставщиком идентификационной информации SAML

При переходе на новый интерфейс Edge инструкции по установке поставщика идентификационной информации SAML не меняются. Подробнее о настройке поставщика идентификационной информации SAML…