4.17.01 - Edge for Private Cloud release notes

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

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

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

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

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

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

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

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

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

Мы также отключили функцию "Лимиты на монетизацию".

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

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

В этом выпуске были упразднены или удалены следующие функции: Подробнее о правилах прекращения поддержки Microsoft 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, вам необходимо обновить операционную систему до версии 6.6 или более поздней, прежде чем обновлять Edge до версии 4.17.01.

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

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

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

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

Вы можете показывать баннер с запросом согласия, когда пользователь впервые открывает интерфейс Edge. Баннер с запросом согласия содержит текст в формате 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 и портала. Вместо этого используются параметры 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-пакетов

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

При установке на основе RPM и обновлении на основе .tar используются разные компоненты:

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

Установка на основе файла TAR

Веб-сервер

Nginx

Apache

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

/opt/apigee/apigee-drupal

/var/www/html

Порт

8079

80

База данных

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.

Добавлена поддержка 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 можно задать в файле конфигурации установки

Чтобы задать пароль Postgres в файле конфигурации установки, используйте свойство PG_PWD. Подробнее о файле конфигурации 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 (демона кеширования службы имен)

Если вы установили и включили NSCD (демон кеширования службы имен), обработчики сообщений выполняют два поиска 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, защищать от скачков трафика и регистрировать данные.

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

  • С помощью новых правил Flow Callout в прокси-сервере API
    или

  • В новом артефакте под названием "Хуки процесса", который находится в следующих местах:

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

    • Запрос: до PreFlow ProxyEndpoint, после PostFlow TargetEndpoint
    • Ответ: до PreFlow TargetEndpoint, после PostFlow ProxyEndpoint.

Подробнее о повторно используемых общих процессах и подключении общего процесса с помощью хука процесса…

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

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

Как создавать зашифрованные KVM

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

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

  • Используйте правило Key Value Map Operations, чтобы получать и обновлять зашифрованные значения KVM.
  • При получении зашифрованного ключа-значения добавьте к переменной, в которой хранится значение, ключевое слово "private." Пример: <Get assignTo="private.secretVar">. В этой переменной private.secretVar хранится расшифрованное значение.
  • При обновлении значения с помощью правила не нужно предпринимать никаких специальных действий. Значение будет автоматически зашифровано в зашифрованных парах "ключ-значение".
  • Вы также можете получить доступ к расшифрованному значению с помощью модуля 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 UI)

При создании карты "ключ-значение" с областью действия на уровне среды в интерфейсе управления (API > Конфигурация среды > Карты "ключ-значение") можно установить флажок Зашифровано, чтобы создать зашифрованную карту. После того как вы добавите ключи в хранилище пар "ключ-значение", зашифрованные значения будут отображаться в интерфейсе управления в виде звездочек (*****). Добавлять ключи и значения в зашифрованное хранилище пар "ключ-значение" нужно так же, как и в незашифрованное. Полная поддержка зашифрованных KVM-переключателей на стороне сервера была реализована в облачной версии 160921. (EDGEUI-764)

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

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

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

Когда вы создаете прокси-сервер "Передача 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)

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

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

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

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

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

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

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

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

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

Когда на панели управления аналитикой возникала ошибка 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"

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

APIRT-3032

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

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

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

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

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

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

Cloud 16.09.21_9

Идентификатор проблемы Описание
MGMT-3674 Не удается создать зашифрованные хранилища KVM или Vaults для организаций, соответствующих требованиям 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 Учетные данные проверяются на соответствие другому приложению разработчика, опубликованному в Google Play
APIRT-3234 Приложение Node.js возвращает исключение NullPointerException
APIRT-3223 Проблема с устаревшим кешем Apigee
APIRT-3193 Целевой сервер Node.js зависает после перехода на ASG
APIRT-3152 Вызов управления cachedlogs приводит к разбиению сообщений журнала
APIRT-3117 Медиапроигрыватель достиг 100% загрузки ЦП и перестал обрабатывать трафик
APIRT-3064 Маршрутизатор – специальное сообщение об ошибке 503 от маршрутизатора
APIRT-2620 Отдельный пул потоков для некоторых блокирующих шагов, чтобы улучшить обработку нагрузки
CORESERV-774 Доступ с действительным ключом и недействительной ссылкой на apiproduct приводит к внутренней ошибке сервера

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

Идентификатор проблемы Описание
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, если выбран параметр "Включить CORS"
EDGEUI-648 Звонки из интерфейса, которые длятся от двух до трех минут, завершаются по тайм-ауту
EDGEUI-623 Кнопка "Изменить дату" в истории организации не работает в Firefox
Назад
4.17.01.01
Далее
4.16.09.04