4.17.01 - Edge for Private Cloud release notes

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

В среду, 25 января 2017 г., мы выпустили новую версию Apigee Edge для частного облака.

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

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

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

В этом выпуске есть несколько важных функций, которые помогут вам лучше контролировать и защищать свои API.

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

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

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

Функция "Лимиты монетизации" была упразднена.

Ниже приведены подробные сведения обо всех новых функциях, обновлениях и исправлениях ошибок, содержащихся в выпуске.

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

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

Прекращено: лимиты монетизации (интерфейс Cloud 16.10.26)

Функция "Лимиты монетизации" удалена из интерфейса управления (Администратор > Лимиты). Подробную информацию, в том числе о том, что использовать вместо этого, можно найти в уведомлении о прекращении поддержки: http://docs.apigee.com/monetization/content/limit-feature-deprecation-notice. (DEVRT-3259)

Прекращена поддержка RedHat/CentOS версии 6.5.

Если вы используете RedHat/CentOS версии 6.5, то перед обновлением до Edge 4.17.01 вам необходимо обновить операционную систему до версии 6.6 или более поздней.

Изменения и новые функции

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

Подробные сведения и инструкции можно найти в документации по Edge для частного облака.

Private Cloud

Вы можете показывать баннер с запросом согласия, когда пользователь впервые открывает Edge UI. На баннере показывается текст в формате HTML и кнопка, которую пользователь нажимает, чтобы перейти к экрану входа. Подробнее о том, как включить баннер с запросом согласия…

API BaaS поддерживает несколько центров обработки данных

Теперь вы можете установить API BaaS в нескольких центрах обработки данных. Подробную информацию можно найти в статье Установка API BaaS в нескольких центрах обработки данных.

Новые параметры конфигурации установки API BaaS

В файл конфигурации API BaaS добавлены два новых параметра:

  • BAAS_CASS_DC_LIST – указывает названия регионов центров обработки данных BaaS. Для одного центра обработки данных укажите то же значение, что и для BAAS_CASS_LOCALDC.
  • BAAS_CLUSTER_SEEDS – указывает узлы стека BaaS, используемые для определения начальных значений кластера BaaS.

Подробнее о том, как обновить Apigee Edge 4.16.09 до версии 4.17.01…

Больше не запускайте параметр deploy с командой apigee-service для API BaaS.

Параметр deploy для команды apigee-service больше не поддерживается для API BaaS Stack и Portal. Вместо этого используйте параметры configure и restart. Подробную информацию можно найти в статье Установка API BaaS.

Новое требование к портам для API BaaS

Теперь на всех узлах BaaS Stack должен быть открыт порт 2551 для доступа со всех остальных узлов Stack. Если у вас несколько центров обработки данных BaaS, порт должен быть доступен со всех узлов стека во всех центрах обработки данных.

Подробную информацию можно найти в статьях Установка API BaaS и Требования к установке.

Портал Developer Services теперь использует Postgres в качестве базы данных и Nginx в качестве веб-сервера.

Для всех новых установок портал использует Postgres в качестве базы данных вместо MySQL и MariaDB. Клиенты, которые переходят на версию 4.17.01 с предыдущей версии, продолжают использовать MySQL или MariaDB.

При установке версии 4.17.01 в качестве веб-сервера также устанавливается Nginx. Клиенты, которые переходят на версию 4.17.01 с предыдущей версии, продолжают использовать Apache.

На портале Developer Services больше не включается SmartDocs по умолчанию

Вам нужно включить SmartDocs на портале. Дополнительную информацию о SmartDocs можно найти в статье Использование SmartDocs для документирования API.

Портал Developer Services теперь устанавливается из RPM

Портал Developer Services версии 4.17.01 устанавливается из RPM-пакетов с использованием того же репозитория и инструментов, что и Edge и API BaaS. Подробнее об установке портала Developer Services…

Установщик на основе RPM и средство обновления на основе TAR используют разные компоненты:

Установка на основе RPM

Установка на основе tar-архива

Веб-сервер

Nginx

Apache

Корневой каталог сайта

/opt/apigee/apigee-drupal

/var/www/html

Порт

8079

80

Database

PostgreSQL

MySQL

PHP

php-fpm (FastCGI)

mod_php (внутрипроцессный с Apache)

Qpid обновлен до версии 1.35.

В этот выпуск включена версия Qpid 1.35.

Cassandra обновлена до версии 2.1.16.

В этот выпуск включена версия Cassandra 2.1.16.

Версия Google Play обновлена до 2.4

В этом выпуске используется фреймворк Play 2.4 UI.

Добавлена поддержка RedHat/CentOS версии 7.3.

Edge теперь поддерживает RedHat/CentOS версии 7.3.

Обновления на панели мониторинга бета-версий

Бета-версия панели мониторинга Edge обновлена:

  • Добавлены новые панели управления для Cassandra, Zookeeper, OpenLDAP, Postgres и Qpid.
  • Версия Influx в 4.16.09 обновлена с 0.11 до 1.0.2.
  • Устранены некоторые проблемы со стабильностью работы.

Подробнее о бета-версии панели мониторинга Apigee…

Теперь в файле конфигурации установки можно задать пароль Postgres

Используйте свойство PG_PWD, чтобы задать пароль Postgres в файле конфигурации установки. Подробную информацию можно найти в справочнике по файлу конфигурации Edge.

Включите репозиторий EPEL

Чтобы установить или обновить Edge, необходимо включить дополнительные пакеты для Enterprise Linux (EPEL). Подробнее о требованиях к установке…

Команда зависит от версии RedHat/CentOS:

  • Для RedHat/CentOS 7.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
  • Для RedHat/CentOS 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

Отключить DNS-запрос по IPv6 при использовании NSCD (Name Service Cache Daemon)

Если вы установили и включили NSCD (Name Service Cache Daemon), Message Processor выполняет два DNS-запроса: один для IPv4 и один для IPv6. При использовании NSCD необходимо отключить DNS-запросы по протоколу IPv6. Подробнее о требованиях к установке…

Чтобы отключить DNS-запрос по IPv6, выполните следующие действия:

  1. На каждом узле Message Processor отредактируйте файл /etc/nscd.conf.
  2. Задайте следующее свойство:
    enable-cache hosts no

Сервисы API

Общие потоки и хуки потоков для операционализации прокси-серверов API (Cloud 16.09.21)

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

Общие потоки определяются в интерфейсе управления (APIs > Shared Flows (API > Общие потоки)), а затем на них можно ссылаться двумя разными способами:

  • С помощью нового правила Flow Callout в прокси-сервере API.
    или
  • В новом артефакте Flow Hooks, который находится в следующих местах:

    Эти точки подключения позволяют выполнять операционную логику до или после основных точек потока отдельного прокси-сервера. Вы назначаете общие потоки этим расположениям Flow Hook в интерфейсе управления (APIs > Environment Configuration > Flow Hooks).

    • Запрос: до PreFlow в ProxyEndpoint, после PostFlow в TargetEndpoint.
    • Ответ. Перед PreFlow целевой конечной точки, после PostFlow конечной точки прокси.

Дополнительную информацию можно найти в статьях Многократно используемые общие потоки и Прикрепление общего потока с помощью хука потока.

Зашифрованные карты пар "ключ-значение" (Cloud 16.09.21)

Вы можете создавать зашифрованные карты ключей и значений (KVM) для хранения конфиденциальной информации, например учетных данных или информации, позволяющей идентифицировать личность, или данных, защищенных законом HIPAA. Эта функция отличается от существующего защищенного хранилища Edge (хранилища) и предназначена для его замены, поскольку доступ к значениям хранилища можно получить только с помощью Node.js (в дополнение к Management API). Вы можете получить доступ к зашифрованным значениям KVM с помощью Node.js или политики Key Value Map Operations.

Создание зашифрованных KVM

  • Используйте существующие API управления KVM. Если при создании KVM вы включите “encrypted”: “true” в определение полезной нагрузки, Edge сгенерирует ключ шифрования, который имеет ту же область действия, что и KVM, и зашифрует KVM с помощью этого ключа.
  • Вы не можете использовать правило Key Value Map Operations для создания зашифрованного KVM. Прежде чем использовать зашифрованный KVM в правилах, его нужно создать с помощью KVM Management API.
  • Зашифровать существующую незашифрованную карту KVM нельзя.

Использование зашифрованных KVM

  • Используйте правило Key Value Map Operations, чтобы получать и обновлять зашифрованные значения KVM.
  • При получении зашифрованного значения ключа добавьте к переменной, которая будет содержать это значение, ключевое слово private. Пример: <Get assignTo="private.secretVar">. Переменная private.secretVar содержит расшифрованное значение.
  • При обновлении значения с помощью правила вам не нужно выполнять никаких специальных действий. В зашифрованных KVM значение будет зашифровано автоматически.
  • Вы также можете получить доступ к расшифрованному значению, используя модуль apigee-access в коде Node.js. Используйте функцию getKeyValueMap(), чтобы получить KVM на основе названия и области действия. Для возвращенного объекта доступны две функции: getKeys(callback) для получения массива названий ключей и get(key, callback) для получения значения определенного ключа. Например, следующий код получает KVM с областью действия apiproxy под названием VerySecureKVM и извлекает зашифрованное значение key1:
    var apigee = require('apigee-access');
      var encryptedKVM = apigee.getKeyValueMap('VerySecureKVM', 'apiproxy');
      encryptedKVM.get('key1', function(err, secretValue) {
      // use the secret value here
    });

Дополнительную информацию можно найти в статьях Работа с сопоставлениями пар "ключ-значение" и Доступ к сопоставлениям пар "ключ-значение" в Node.js.

(APIRT-1197)

Создание зашифрованных карт "ключ-значение" в интерфейсе (интерфейс 16.10.26)

При создании карты "ключ-значение" (KVM) на уровне среды в пользовательском интерфейсе управления (APIs > Environment Configuration > Key Value Maps) новый флажок Encrypted позволяет создать зашифрованную KVM. После добавления ключей в KVM их зашифрованные значения будут отображаться в интерфейсе управления в виде звездочек (*****). Ключи и значения добавляются в зашифрованное KVM так же, как и в незашифрованное. Полная поддержка зашифрованных KVM на стороне сервера была реализована в облачной версии 160921. (EDGEUI-764)

Включение URL спецификации OpenAPI в метаданные прокси-сервера API (Cloud 16.09.21)

Когда вы создаете прокси-сервер API на основе спецификации OpenAPI, ее местоположение сохраняется в метаданных прокси-сервера API. Например, если вы используете Management API, чтобы получить сведения о версии прокси, метаданные будут включать путь к спецификации OpenAPI в следующем формате:

"spec" : "https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget.yaml"

Это улучшение поддерживает версию Edge следующего поколения, которая связывает спецификации OpenAPI с прокси-серверами API, продуктами API и справочной документацией по API на новом портале для разработчиков. (MGMT-2913)

Генерация спецификации OpenAPI для прокси SOAP (интерфейс Cloud 16.10.05)

Когда вы создаете прокси-сервер "REST-SOAP-REST" на основе WSDL, Edge автоматически генерирует размещенную спецификацию OpenAPI на основе ресурсов прокси-сервера. Спецификация доступна по адресу http(s)://[edge_domain]/[proxy_base_path]/openapi.json. Однако преобразование не всегда является точным, поскольку не все правила XML-схемы могут быть представлены в спецификации OpenAPI. (EDGEUI-718)

WSDL, размещенный на Edge, для сквозных прокси-серверов SOAP (интерфейс Cloud 16.10.05)

Когда вы создаете прокси-сервер "Pass-Through SOAP" на основе WSDL, Edge размещает WSDL и создает поток в прокси-сервере, чтобы вы могли получить к нему доступ. Размещенный WSDL-файл доступен по адресу http(s)://[edge_domain]/[proxy_base_path]?wsdl. Это новый URL конечной точки сервиса для клиентов, вызывающих сервис SOAP через прокси-сервер. (EDGEUI-718)

Новый пример WSDL-файла с котировками акций в мастере прокси-сервера API (Cloud 16.08.24.01)

При создании API сервиса SOAP с помощью мастера прокси-сервера API в примерах доступен заменяющий WSDL котировок акций: https://ws.cdyne.com/delayedstockquote/delayedstockquote.asmx?WSDL. (EDGEUI-655)

Сервисы для разработчиков

Улучшения в интерфейсе управления приложениями для разработчиков (Cloud 16.10.05 UI)

Управление приложениями разработчиков в интерфейсе Edge стало более эффективным благодаря ряду улучшений:

  • Вы можете отзывать и одобрять приложения (в режиме редактирования) в новом поле "Статус приложения". В режиме просмотра в этом поле также отображается текущий статус приложения. Если приложение отозвано, ни один из его ключей API не будет действителен для вызовов API. Сами ключи не отзываются и снова становятся доступны для использования, если разработчик повторно получает одобрение. Пока приложение находится в состоянии "Отозвано", ярлык "Одобрено" для ключей API отображается зачеркнутым текстом.
  • Теперь на странице сведений о приложении разработчика показываются даты окончания срока действия ключей API. Ключи упорядочены по этим датам в разделе "Учетные данные". Например, ключ без срока действия показывается в одной группе со связанными продуктами API, а ключ, срок действия которого истекает через 90 дней, – в другой группе со связанными продуктами. Изменить срок действия существующих учетных данных нельзя.
  • С помощью новой кнопки "Добавить учетные данные" в режиме редактирования приложения разработчика можно генерировать ключи API с определенным сроком действия или без него. При создании учетных данных или после этого вы можете добавить в них продукты API.
    Эта функция заменяет кнопку "Создать ключ заново" на странице сведений о приложении разработчика. Эта кнопка была удалена.

Эти улучшения добавляют в интерфейс функции, которые уже были доступны в Management API. (EDGEUI-104)

Активация и деактивация разработчика приложения в интерфейсе (Cloud 16.10.05 UI)

Вы можете изменить статус разработчика приложения с активного на неактивный в пользовательском интерфейсе Edge (страница сведений о разработчике, режим редактирования, кнопка «Активировать/Деактивировать»). Если разработчик неактивен, ни один из ключей API его приложений или токенов OAuth, сгенерированных с помощью этих ключей, не будет действителен при вызовах прокси-серверов API. (EDGEUI-304)

Индикаторы неактивных разработчиков в интерфейсе (16.10.26 UI)

Если разработчик приложений имеет статус "Неактивно", его приложения и учетные данные больше не действительны, даже если они остаются в статусе "Одобрено". Теперь при просмотре приложений и учетных данных неактивного разработчика в интерфейсе управления статус "Одобрено" будет зачеркнут, а при наведении указателя мыши на него будет появляться подсказка о том, что разработчик неактивен. Если статус разработчика снова станет "Активный", ее одобренные приложения и учетные данные снова станут действительными, а зачеркивание на ярлыке "Одобрено" будет удалено. (EDGEUI-728)

Сервисы аналитики

Переименована панель "Анализ кодов ошибок" (интерфейс 16.10.26)

Панель "Анализ ошибок" переименована в "Анализ кодов ошибок". На панели управления представлены вызовы API с кодами статуса HTTP 4xx и 5xx. (EDGEUI-738)

Данные TPS на панелях управления прокси-серверами (интерфейс 16.10.26)

На главную панель управления трафиком прокси-сервера добавлены данные о среднем количестве транзакций в секунду. Кроме того, если навести указатель мыши на отдельные элементы на диаграммах "Трафик прокси-сервера" и "Эффективность прокси-сервера", в подсказке будет показано количество транзакций в секунду за этот интервал времени. (EDGEUI-668)

Отображение ошибки в Аналитике (интерфейс 16.10.26)

Когда панель управления аналитикой получала ошибку 500, в интерфейсе управления отображалось сообщение "Время ожидания отчета истекло" независимо от ошибки. Чтобы упростить устранение неполадок, в интерфейсе теперь показывается фактическая ошибка. (EDGEUI-753)

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

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

Edge for Private Cloud 4.17.01

Идентификатор проблемы Описание
APIBAAS-1990 API BaaS Stack больше не пытается выполнить аутентификацию по SMTP, если для smtp.auth задано значение false
APIRT-3032

При выполнении команды apigee-service baas-usergrid restart теперь также запускается configure

Вам больше не нужно выполнять команды apigee-service baas-usergrid configure и apigee-service baas-usergrid restart для BaaS Stack.

APIRT-3032

Не выполнять DNS-запрос, если имя хоста является IP-адресом.

DOS-4070

Команда apigee-all -version теперь показывает версию RPM-пакетов edge-mint-*

DOS-4359

Добавлен параметр pdb для установки только базы данных Postgres.

Используется только при установке портала Developer Services. Подробнее об установке портала Developer Services…

Cloud 16.10.26 (UI)

Идентификатор проблемы Описание
EDGEUI-768 Не удается создать прокси-сервер с помощью StockQuote WSDL

Cloud 16.09.21_9

Идентификатор проблемы Описание
MGMT-3674 Невозможно создать зашифрованные KVM или хранилища для организаций, на которые распространяется действие закона HIPAA
MGMT-3647 Ошибка 403 при попытке доступа к ролям пользователей для пользователей с адресом электронной почты, содержащим заглавные буквы

Cloud 16.09.21

Идентификатор проблемы Описание
APIRT-3507 Периодические ошибки (например, ошибки SNI) при вызовах сервиса JavaScript
APIRT-3408 Выпуск MP 160817: модуль аналитики apigee-access обрабатывает сообщения по-другому
APIRT-3390

Изменение ответа на ошибку, возвращаемого правилом обновления токена доступа

APIRT-3389
APIRT-3381 Высокие задержки на рабочих прокси-серверах клиента
APIRT-3366 Правила JavaScript не работают во всех новых пробных организациях
APIRT-3363 При синтаксическом анализе недопустимого URL возвращается статус 500 с ошибкой ApplicationNotFound
APIRT-3356 Сообщение о недействительном токене OAuth
APIRT-3355 Периодическая ошибка 403 на прокси-сервере OAuth
APIRT-3285
APIRT-3261 Учетные данные проверяются в другом приложении разработчика в рабочей версии
APIRT-3234 Приложение Node.js возвращает NPE
APIRT-3223 Проблема с устаревшим кешем Apigee
APIRT-3193 Целевой сервер Node.js зависает после перехода на ASG
APIRT-3152 Вызов управления cachedlogs приводит к разбиению сообщений в журнале
APIRT-3117 Процессор MP загружен на 100 %, и трафик не обрабатывается
APIRT-3064 Специальное сообщение об ошибке 503 от маршрутизатора
APIRT-2620 Отдельный пул потоков для некоторых блокирующих шагов, чтобы улучшить обработку нагрузки.
CORESERV-774 Доступ с использованием действительного ключа с недействительной ссылкой на apiproduct вызывает внутреннюю ошибку сервера

Cloud 16.10.05 (UI)

Идентификатор проблемы Описание
EDGEUI-697 Кнопка экспорта на странице отчетов
Кнопка "Экспортировать" удалена с главной страницы специальных отчетов. Экспорт отчетов доступен на странице каждого специального отчета.

Cloud 16.08.24.01

Идентификатор проблемы Описание
EDGEUI-663 Прокси-сервер, созданный для порта WeatherHttpGet файла Weather.wsdl, во время выполнения выдает ошибку 500
При создании прокси-сервера API для сервиса SOAP порты WSDL без привязки протокола SOAP больше не видны в мастере прокси-сервера API. Это сделано намеренно, поскольку мастер генерирует только SOAP-запросы.
EDGEUI-658 Проблема с названием операции сквозной передачи SOAP WSDL
EDGEUI-653 Ошибка при создании прокси-сервера API node.js, когда выбран параметр Enable Cors (Включить CORS)
EDGEUI-648 Вызовы из интерфейса, которые занимают от 2 до 3 минут, завершаются по тайм-ауту
EDGEUI-623 Кнопка "Изменить дату" в истории организации не работает в Firefox