16.09.21 - Apigee Edge для общедоступного облака: примечания к выпуску

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

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

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

Ниже перечислены новые функции и изменения в этом выпуске.

Общие потоки и точки подключения потоков для работы с прокси API (бета-версия, доступна по запросу)

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

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

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

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

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

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

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

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

Как создать зашифрованную виртуальную машину на основе ядра Linux

  • Используйте существующие KVM API. Если при создании KVM включить “encrypted”: “true” в определение полезной нагрузки, Edge зашифрует KVM и сгенерирует ключ шифрования с той же областью действия, что и KVM.
  • Правило Key Value Map Operations нельзя использовать для создания зашифрованной карты 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) для получения значения определенного ключа. Пример: 
    var apigee = require('apigee-access');
  var encryptedKVM = apigee.getKeyValueMap('VerySecureKVM', 'apiproxy');
  encryptedKVM.get('secret1', function(err, secretValue) {
  // use the secret value here
});

(APIRT-1197)

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

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

Управление IP-адресом клиента с помощью Sense

Чтобы точнее определять, где искать IP-адреса для обнаружения ботов Sense при использовании продуктов маршрутизации, таких как Akamai, Sense позволяет задать местоположение клиентского IP-адреса с помощью переменной additionalIPVars. Например, можно задать для атрибута additionalIPVars заголовок true-client-ip, который содержит правильный IP-адрес от Akamai для оценки в правилах для роботов. (APIRT-3332)

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

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

Идентификатор проблемы Описание
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 приводит к внутренней ошибке сервера