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

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

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

Выпуск интерфейса Edge Выпуск Edge Management

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

Обзор версии приложения

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

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

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

Подробнее о поддержке SAML в Edge для частного облака…

В этой версии также есть ряд других важных функций, в том числе:

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

Ниже описаны все новые функции, обновления и исправления ошибок, включенные в этот выпуск.

Прекращение поддержки

В этом выпуске были упразднены или удалены следующие функции: Подробнее о правилах прекращения поддержки Microsoft Edge…

Прекращение поддержки

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

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

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

Прекращение поддержки добавления путей на вкладке "Эффективность" прокси-сервера API

До этого выпуска вы могли перейти к прокси-серверу API в интерфейсе управления, открыть вкладку "Эффективность" и создать разные пути для сравнения на основе диаграмм на вкладке "Эффективность" прокси-сервера и на панели "Бизнес-транзакции". Эта функция больше не поддерживается и недоступна в интерфейсе. В качестве альтернативы можно использовать статью сообщества Apigee Alternative to Business Transactions API (Альтернатива API бизнес-транзакций). (EDGEUI-902)

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

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

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

Добавлена поддержка SAML для Edge, API BaaS и портала Developer Services

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

Подробнее о том, как поддерживать SAML в Edge для частного облака…

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

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

Подробнее о том, как использовать apigee-ssoadminapi.sh…

(DOS-5118)

Теперь портал Developer Services можно перенести с 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 и портал Developer Services на Red Hat/CentOS версии 7.4.

Подробнее о том, какое ПО и какие версии поддерживаются…

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

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

ENABLE_SYSTEM_CHECK=y

Если указано значение "y", установщик проверяет, соответствует ли система требованиям к процессору и памяти для устанавливаемого компонента. Требования к каждому компоненту приведены в разделе Требования к установке. По умолчанию проверка отключена (значение "n").

Подробнее о файле конфигурации Edge…

(DOS-4772)

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

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

ENABLE_DYNAMIC_HOSTIP=y

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

Подробнее о файле конфигурации Edge…

(DOS-5117)

Новые параметры интерфейса и API для настройки TLS

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

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

Документация по бета-версии этих функций доступна в формате PDF по следующей ссылке:

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

(EDGEUI-1058)

Добавлена команда для обфускации пароля

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

> /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…

(DBS-1733)

Добавление команды для отключения TLS в интерфейсе Edge

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

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

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

(EDGEUI-1114)

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

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

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

Пример:

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

Чтобы задать формат, используйте свойство conf_system_apigee.syslogger.dateFormat в процессоре сообщений Edge.

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

(APIRT-4196)

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

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

Подробнее о файле конфигурации BaaS…

(APIBAAS-2103)

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

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

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

Изменились свойства, используемые для настройки уровня ведения журнала для интерфейса Edge. Новые свойства и процедура описаны в разделе Как задать уровень ведения журнала для компонента Edge.

(EDGEUI-886)

Сервисы API

Правила именования идентификаторов клиента и секретных ключей

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

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

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

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

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

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

Private Cloud 4.17.09

Идентификатор проблемы Описание
APIRT-4346

Пограничный маршрутизатор теперь работает на сервере с поддержкой FIPS

Теперь пограничный маршрутизатор можно развернуть на сервере, который поддерживает FIPS (федеральные стандарты обработки информации).

APIRT-4726

ScriptableHttpClient не должен предполагать, что контекст сообщения по-прежнему присутствует во время отправки

Теперь ScriptableHttpClient считывает контекст сообщения во время запуска.

DBS-1529

Скрипт резервного копирования Cassandra больше не останавливает и не перезапускает Cassandra

Ранее скрипт резервного копирования Cassandra останавливал, а затем перезапускал сервер Cassandra в рамках процесса резервного копирования. Скрипт больше не выполняет остановку и перезапуск и оставляет сервер Cassandra запущенным во время процесса резервного копирования.

DOS-5100

Установщик теперь задает пароль Postgres на основе значения, указанного в переменной PG_PWD

В предыдущих версиях пароль Postgres не устанавливался правильно на основе значения PG_PWD в файле конфигурации.

EDGESERV-7

Обновлены свойства Node.js по умолчанию

Теперь в Node.js используются следующие значения по умолчанию для свойств установки в частном облаке:

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

Это означает, что Edge для частного облака больше не запрещает коду Node.js доступ к определенным IP-адресам по умолчанию. Подробнее о поддержке модулей Node.js в Edge…
EDGEUI-1110

Не удается посмотреть названия ресурсов при создании прокси-сервера с помощью OpenAPI

Теперь при создании прокси-сервера с помощью OpenAPI названия ресурсов отображаются правильно.
MGMT-4021

Вызов API "Сервер управления запущен" теперь возвращает ответ в правильном формате

Вызов API /v1/servers/self/up теперь возвращает правильно отформатированный XML или JSON, а не всегда текст.
MGMT-4294

Названия прокси-серверов и продуктов, содержащие пробелы или дефисы, из-за которых возникают проблемы с разрешениями

Названия прокси-серверов и продуктов теперь работают корректно, если в названии есть пробел или дефис.

Cloud 17.08.16 (UI)

Идентификатор проблемы Описание
64530444 Возможность редактировать YAML-файлы в редакторе прокси-сервера API
Теперь YAML-файлы можно редактировать в редакторе прокси-сервера API. При открытии файла YAML в редакторе больше не появляется сообщение об ошибке.
64479253 Кнопка "Исправить журналы" на вкладке "Трассировка"
Кнопка "Журналы Node.js" будет показываться на странице "Трассировка", только если у прокси-сервера API есть исходные файлы Node.
64441949 Исправлена проблема со скачиванием на панели управления аналитикой GeoMap
Устранена неполадка, из-за которой не удавалось скачать CSV-файл на панели управления аналитикой GeoMap.
64122687 Спецификации OpenAPI без operationID создают потоки с названиями "undefined"
Теперь при создании прокси-сервера API на основе спецификации OpenAPI без определенных operationID для названия условного потока используются путь и глагол.

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

Идентификатор проблемы Описание
APIRT-4584 Нестабильное развертывание хука потока, проверка ZooKeeper не работает
APIRT-3081 Ошибка messaging.adaptors.http.flow.ServiceUnavailable с правилом Concurrent Rate Limit

Cloud 17.07.31 (управление API)

Идентификатор проблемы Описание
MGMT-4141
Зашифрованные значения в хранилище пар "ключ-значение" не расшифровываются, даже если они извлекаются с помощью закрытого префикса.

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

Идентификатор проблемы Описание
APIRT-4400 В ответе nginx отображается"Apigee Router"
APIRT-4155 Правило ExtractVariables не обрабатывает неправильно сформированные параметры формы в теле запроса POST
APIRT-3954 Проверка состояния по HTTP не должна выполняться чаще одного раза в секунду.

Исправлена проблема, из-за которой большое количество проверок состояния снижало производительность.
APIRT-3928 В сообщении, возвращенном по запросу, есть слово"nginx"
APIRT-3729 Apigee изменяет переменную proxy.client.ip после того, как правило AssignMessage удаляет заголовок x-forwarded-for
APIRT-3546 При использовании правила AssignMessage для создания нового сообщения Trace не указывает, что было назначено новое сообщение
APIRT-1873 При отсутствии настроенного хранилища доверенных сертификатов исходящий SSL-трафик не должен перенаправляться в хранилище доверенных сертификатов JDK
APIRT-1871 Южное направление : общее название сертификата не проверяется на соответствие имени хоста в URL

Cloud 17.06.20 (интерфейс)

Идентификатор проблемы Описание
EDGEUI-1087 Удаление предупреждений о цепочке сертификатов из интерфейса TLS
Предупреждения о цепочке сертификатов удалены из интерфейса. В строках псевдонимов, содержащих цепочки сертификатов, в столбцах "Срок действия" и "Общее название" теперь будут отображаться данные сертификата, срок действия которого истекает раньше других. Предупреждающий баннер под селектором сертификата на панели псевдонима был заменен на информационную аннотацию.

Cloud 17.06.14 (интерфейс)

Идентификатор проблемы Описание
EDGEUI-1092 Действия на панели псевдонимов хранилища ключей не работают
В бета-версии нового интерфейса хранилища ключей TLS при просмотре панели псевдонимов кнопки "Действия" не всегда работали. Наши специалисты уже устранили эту проблему.
EDGEUI-1091 После обновления сертификата псевдонима панель псевдонима не работает
В бета-версии нового интерфейса хранилищ ключей TLS после обновления сертификата псевдонима иногда возникала ошибка на панели псевдонима, и для отображения сведений о псевдониме требовалось обновить страницу. Наши специалисты уже устранили эту проблему.
EDGEUI-1088 При нажатии кнопки "Изменить" на странице настроек пользователя возникает ошибка 404
Теперь при изменении настроек аккаунта пользователя вы будете перенаправляться на страницу настройки двухэтапной аутентификации. Подробнее о том, как включить двухфакторную аутентификацию для аккаунта Apigee… Чтобы изменить пароль, выйдите из аккаунта и нажмите "Сбросить пароль" на странице входа.
EDGEUI-1082 Список хранилищ ключей не обрабатывает селектор *
Подстановочные селекторы не работали при фильтрации списка хранилищ ключей. Проблема устранена.
EDGEUI-1079 Скрыть поле ключей в информации о разработчике для организаций CPS
Для организаций CPS поле ключей не показывается на странице с информацией о разработчике.
EDGEUI-1074 При просмотре цепочки сертификатов значок действительности сертификата относится только к головному сертификату
Теперь значок действительности сертификата относится к выбранному сертификату, а не всегда к головному.
UAP-328 В раскрывающемся списке фильтра анализа задержки теперь показываются все прокси API
Прокси API больше не будут удаляться из раскрывающегося списка фильтра прокси, как это иногда происходило раньше. Если вы выберете прокси-сервер API, для которого нет данных за выбранный временной интервал, теперь будет показан значок No data to show.

Cloud 17.05.22.01 (монетизация)

Идентификатор проблемы Описание
DEVRT-3647 Улучшения в работе API статуса транзакций

В API статуса транзакций, описанном в статье Как посмотреть статус транзакции, улучшено удобство использования.

  • Если время окончания utctime2 не указано, диапазон времени будет следующим: (utctime - 5s) <= txTime < (utctime + 5s)
  • Если время начала или окончания не указано, по умолчанию будет выбран временной диапазон, равный текущему времени плюс или минус пять секунд.
  • Если временные метки utctime и utctime2 совпадают, временной диапазон будет равен полной секунде, указанной в метках.
  • Если значение utctime больше, чем utctime2, значения времени меняются местами.
  • Если временные метки отформатированы неправильно, появится сообщение с описанием нужного формата.

Кроме того, мы исправили ошибку в API статуса транзакций.

Cloud 17.05.22 (интерфейс)

Идентификатор проблемы Описание
EDGEUI-1027 На панели псевдонима хранилища ключей или доверенных сертификатов должны отображаться сведения о каждом сертификате в цепочке сертификатов
Если вы загрузите цепочку сертификатов в псевдоним, то на панели псевдонима сможете выбрать каждый сертификат из раскрывающегося списка и посмотреть его сведения.

Примечание. Цепочка сертификатов не рекомендуется. Apigee рекомендует хранить каждый сертификат в отдельном псевдониме.
EDGEUI-1003 Полный список приложений разработчика для клиентов CPS
Теперь клиенты CPS могут просматривать полный список приложений разработчика, когда открывают его страницу. В предыдущих версиях максимальное количество приложений разработчика, которые можно было посмотреть, составляло 100.

Cloud 17.05.22 (управление API)

Идентификатор проблемы Описание
MGMT-4059
MGMT-3517 Неправильная версия прокси в сообщении об ошибке при развертывании прокси

Cloud 17.05.08 (интерфейс)

Идентификатор проблемы Описание
EDGEUI-1041

Не удается обновить объекты с расширенными символами ASCII из-за неправильной кодировки
Не удавалось обновить объекты (например, псевдонимы ключей) с расширенными символами ASCII из-за проблемы с кодировкой. Наши специалисты уже устранили эту проблему.
EDGEUI-1033

В интерфейсе Edge для ошибок 403 больше не отображается сообщение "Время ожидания сеанса истекло"
Ошибки HTTP 403 (Доступ запрещен) больше не относятся к ошибкам с истекшим временем ожидания сеанса.
EDGEUI-1019

Сообщение об ошибке "Неизвестная ошибка" появляется, когда истекает время ожидания интерфейса Edge
Если время ожидания интерфейса Edge истекло, отображается сообщение Unknown error. Теперь показывается более подробное сообщение об ошибке, связанной с истечением времени ожидания.

Cloud 17.04.22 (управление API)

Идентификатор проблемы Описание
MGMT-3977 Исправлена ошибка безопасности, связанная с разрешениями пользователей.

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

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

Идентификатор проблемы Описание
67169830

Исключение NullPointerException в кеше ответов

Объект, который был сохранен в кеше предыдущей версии, может быть восстановлен из кеша некорректно.