Вы просматриваете документацию по Apigee Edge.
Перейдите к
документации по Apigee X. info
В среду, 25 января 2017 г., мы выпустили новую версию Apigee Edge для частного облака.
С момента предыдущего выпуска функций Edge для частного облака произошли следующие выпуски, которые включены в этот выпуск функций:
- Cloud: 16.08.24.01 (UI), 16.10.05 (UI), 16.09.21, 16.09.21_9, 16.10.26 (UI)
Чтобы узнать, включен ли определенный облачный выпуск в вашу версию 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 можно показывать баннер с запросом согласия.
Вы можете показывать баннер с запросом согласия, когда пользователь впервые открывает 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, выполните следующие действия:
- На каждом узле Message Processor отредактируйте файл /etc/nscd.conf.
- Задайте следующее свойство:
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 |