17.4.09 — Примечания к выпуску Edge для частного облака

Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация

Со времени предыдущего выпуска функций Edge for Private Cloud были выпущены следующие выпуски, которые включены в этот выпуск функций:

См. раздел «Нумерация выпусков» , чтобы понять, как определить, включен ли конкретный облачный выпуск в вашу версию Edge для частного облака.

Обзор выпуска

Наиболее важной новой функцией в этом выпуске является добавление поддержки языка разметки утверждений безопасности (SAML) 2.0 в качестве механизма аутентификации для Edge, API BaaS и портала служб разработчиков. Используя SAML с Edge, вы можете поддерживать единый вход для пользовательского интерфейса и API Edge в дополнение к любым другим службам, которые вы предоставляете и которые также поддерживают SAML.

Аутентификация SAML предлагает несколько преимуществ. Используя SAML, вы можете:

• Возьмите полный контроль над управлением пользователями. Когда пользователи покидают вашу организацию и централизованно деинициализируются, им автоматически отказывается в доступе к Edge.
• Контролируйте, как пользователи проходят аутентификацию для доступа к Edge. Вы можете выбрать разные типы аутентификации для разных пограничных организаций.
• Управляйте политиками аутентификации. Ваш поставщик SAML может поддерживать политики аутентификации, которые больше соответствуют стандартам вашего предприятия.
• Вы можете отслеживать входы в систему, выходы из системы, неудачные попытки входа и действия с высоким риском в вашем Edge-развертывании.
• Обратите внимание, что SAML используется только для аутентификации. Авторизация по-прежнему контролируется ролями пользователей Edge.

Дополнительную информацию см. в разделе «Поддержка SAML в Edge для частного облака» .

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

• Возможность перенести портал служб разработчиков с Apache/MySQL на Postgres/Nginx.
• Команда для отключения TLS в пользовательском интерфейсе Edge
• Новые свойства для настройки установки Edge
• Пользовательский ключ потребителя и правила секретного именования.
• Поддержка Red Hat/CentOS версии 7.4.

Оставшаяся часть этого раздела содержит подробную информацию обо всех новых функциях, обновлениях и исправлениях ошибок, содержащихся в выпуске.

Амортизация и выход на пенсию

Следующие функции в этом выпуске устарели или удалены из эксплуатации. Дополнительную информацию см. в политике прекращения поддержки Edge .

Устаревания

Прекращение поддержки защищенного хранилища Apigee (хранилища)

Безопасное хранилище Apigee, также известное как «хранилища», устаревает и будет прекращено в апреле 2018 года. Хранилища, которые обеспечивают зашифрованное хранение пар ключ/значение, создаются с помощью API управления, и доступ к ним во время выполнения осуществляется с помощью функций в Модуль apigee-access Node.js.

Вместо использования безопасного хранилища используйте зашифрованные карты значений ключей (KVM), как описано в разделе Работа с картами значений ключей . Зашифрованные KVM так же безопасны, как и хранилища, и предоставляют больше возможностей для создания и извлечения. (МГМТ-3848)

Прекращение поддержки добавления путей на вкладке «Производительность прокси-сервера API».

До этого выпуска вы могли перейти к прокси-серверу API в пользовательском интерфейсе управления, перейти на вкладку «Производительность» и создать различные пути для сравнения на основе диаграмм на вкладке «Производительность» прокси-сервера и на панели мониторинга «Бизнес-операции». Эта функция больше не доступна в пользовательском интерфейсе. Альтернативу этой функции см. в следующей статье сообщества Apigee: https://community.apigee.com/articles/23936/alternative-to-business-transactions-api.html . (ЭДГЕУИ-902)

Новые функции и обновления

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

Частное облако

Поддержка SAML добавлена ​​в Edge, API BaaS и портал служб разработчиков.

Edge теперь поддерживает язык разметки утверждений безопасности (SAML) 2.0 в качестве механизма аутентификации для Edge, API BaaS и портала служб разработчиков. SAML поддерживает среду единого входа (SSO). Используя SAML, вы можете поддерживать единый вход для Edge в дополнение к любым другим службам, которые вы предоставляете и которые также поддерживают SAML.

См. раздел «Поддержка SAML в Edge для частного облака» .

Добавлена ​​утилита apigee-ssoadminapi.sh.

После включения SAML вы теперь можете использовать новый файл apigee-ssoadminapi.sh для выполнения многих административных задач, таких как создание пользователей и организаций.

См. Использование apigee-ssoadminapi.sh .

(ДОС-5118)

Теперь можно перенести портал служб разработчиков с Apache/MySQL/MariaDB на Nginx/postgres.

При установке портала Developer Services на основе .tar используются Apache и MySQL или MariaDB. Теперь вы можете перенести существующую установку портала на использование Nginx и Postgres. Эта миграция необходима, если вы хотите обновить портал до версии 4.17.09.

См. Преобразование портала на основе tar в портал на основе RPM .

Добавлена ​​поддержка Red Hat/CentOS версии 7.4.

Теперь вы можете развернуть Edge для частного облака, API BaaS и портала служб разработчиков в Red Hat/CentOS версии 7.4.

См. раздел Поддерживаемое программное обеспечение и поддерживаемые версии .

Добавлено свойство, позволяющее установщику проверять требования к процессору и памяти во время установки.

Файл конфигурации установки Edge теперь поддерживает следующее свойство:

ENABLE_SYSTEM_CHECK=y 

Если «y», установщик проверяет, соответствует ли система требованиям к процессору и памяти для устанавливаемого компонента. Требования к каждому компоненту см. в разделе «Требования к установке» . Значение по умолчанию — «n», чтобы отключить проверку.

См. Справочник по файлам конфигурации Edge .

(ДОС-4772)

Добавлено свойство, позволяющее выбрать IP-адрес, используемый установщиком на сервере с несколькими интерфейсными картами.

Если на сервере имеется несколько интерфейсных карт, команда «hostname -i» возвращает список IP-адресов, разделенных пробелами. По умолчанию установщик Edge использует первый возвращенный IP-адрес, который может быть неверным во всех ситуациях. В качестве альтернативы вы можете установить следующее свойство в файле конфигурации установки:

ENABLE_DYNAMIC_HOSTIP=y

Если для этого свойства установлено значение «y», установщик предложит вам выбрать IP-адрес, который будет использоваться при установке. Значение по умолчанию — «n».

См. Справочник по файлам конфигурации Edge .

(ДОС-5117)

Доступны новые параметры пользовательского интерфейса и API для настройки TLS.

Бета-версия новой функции самообслуживания TLS/SSL для облака теперь доступна в частном облаке в виде бета-функции. Используя эту бета-версию, вы можете:

• Создание, изменение и удаление хранилищ ключей и хранилищ доверенных сертификатов в пользовательском интерфейсе, а также в API.
• Загрузите сертификаты TLS как PKCS12/PFX.
• Создание самозаверяющих сертификатов из пользовательского интерфейса или API.
• Проверьте достоверность хранилища ключей или хранилища доверенных сертификатов в пользовательском интерфейсе.

Бета-документация (PDF) для этих функций доступна по адресу:

• Использование пользовательского интерфейса Edge Cloud для создания хранилищ ключей и хранилищ доверенных сертификатов
• Использование Edge API для создания хранилищ ключей и хранилищ доверенных сертификатов

Полную информацию можно найти в дополнительной документации (PDF):

• Варианты настройки TLS
• Настройка доступа TLS к API для облака
• Настройка TLS от Edge до бэкэнда
• Обновите сертификат TLS для облака

(ЭДГЕУИ-1058)

Добавлена ​​запутанная команда пароля.

Добавлена ​​команда для генерации запутанного пароля, чтобы любой компонент мог генерировать зашифрованный пароль. Вы можете создать запутанный пароль, используя следующую команду на Edge Management Server:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server generate-obfuscated-password

Введите новый пароль, а затем подтвердите его при появлении запроса. В целях безопасности текст пароля не отображается. Эта команда возвращает пароль в виде:

OBF:58fh40h61svy156789gk1saj
MD5:902fobg9d80e6043b394cb2314e9c6

См. раздел Настройка TLS/SSL для Edge On Premises .

(TBD-250)

Добавлена ​​новая команда для скрытия нового пароля при изменении пароля пользователя организации.

Чтобы сбросить пароль для пользователя организации, вы теперь используете утилиту apigee-service для вызова apigee-openldap :

> /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-user-password -u userEmail

Вам будет предложено ввести пароль системного администратора, а затем новый пароль пользователя. В целях безопасности текст паролей не отображается при их вводе.

См. раздел «Сброс паролей Edge» .

(ДБС-1733)

Добавьте команду для отключения TLS в пользовательском интерфейсе Edge.

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

/opt/apigee/apigee-service/bin/apigee-service edge-ui disable-ssl

См. раздел Настройка TLS для пользовательского интерфейса управления .

(ЭДГЕУИ-1114)

Добавлено свойство для управления форматом отметки времени в сообщениях журнала.

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

yyyy-MM-dd'T'HH:mm:ss.sssZ

Например:

2017-05-08T13:33:00.000+0000

Вы можете использовать свойство conf_system_apigee.syslogger.dateFormat в Edge Message Processor для управления этим форматом.

См. политику ведения журнала сообщений .

(АПИРТ-4196)

Добавлен новый обязательный параметр конфигурации SMTP для установки API BaaS.

Теперь вам необходимо использовать параметр SMTPMAILFROM в файле конфигурации установки API BaaS. Этот параметр указывает адрес электронной почты, используемый, когда API BaaS отправляет автоматические электронные письма, например, когда пользователь запрашивает сброс пароля.

См. Справочник по файлу конфигурации BaaS .

(АПИБААС-2103)

Добавлена ​​поддержка, позволяющая Edge Router и веб-серверу Nginx портала получать доступ к портам ниже 1000.

Теперь вы можете использовать маршрутизатор и веб-сервер Nginx для портала для доступа к портам ниже 1000 без необходимости запускать их от имени другого пользователя. в предыдущих выпусках маршрутизатор и веб-сервер Nginx не могли получить доступ к портам ниже 1000, не запуская их от имени специального пользователя.

Изменен способ настройки уровня ведения журнала для пользовательского интерфейса Edge.

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

(EDGEUI-886)

API-сервисы

Пользовательский ключ потребителя и правила секретного именования.

Были обновлены правила именования и проверки для создания пользовательского ключа и секрета потребителя для приложения разработчика . Потребительские ключи и секреты могут содержать буквы, цифры, символы подчеркивания и дефисы. Никакие другие специальные символы не допускаются.

Процесс создания пользовательского ключа/секрета более подробно описан в разделе Импорт существующих потребительских ключей и секретов . (МГМТ-3916)

Проверка имени хранилища ключей и целевого сервера

Имена хранилищ ключей и целевых серверов могут состоять максимум из 255 символов и содержать буквы, цифры, пробелы, дефисы, символы подчеркивания и точки. Edge теперь проверяет это во время создания. (МГМТ-4098)

Исправлены ошибки

В этом выпуске исправлены следующие ошибки. Этот список предназначен в первую очередь для пользователей, проверяющих, исправлены ли их заявки в службу поддержки. Он не предназначен для предоставления подробной информации всем пользователям.

Частное облако 4.17.09

connect.ranges.denied=
connect.ranges.allowed=
connect.ports.allowed=

Облако 17.08.16 (UI)

Облако 17.08.14 (управление API и среда выполнения)

Облако 17.07.31 (управление API)

Облако 17.07.17 (управление API и среда выполнения)

Облако 17.06.20 (UI)

Облако 17.06.14 (UI)

Облако 17.05.22.01 (Монетизация)

Облако 17.05.22 (UI)

Облако 17.05.22 (управление API)

Облако 17.05.08 (UI)

Облако 17.04.22 (управление API)

Известные проблемы

В этом выпуске имеются следующие известные проблемы: