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

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

Ниже указаны даты, когда мы начали выпускать обновления компонентов для Apigee Edge в общедоступном облаке:

• Message Processor: пятница, 1 мая 2020 г.
• Управление API: понедельник, 20 апреля 2020 г.
• Управление монетизацией: понедельник, 20 апреля 2020 г.
• Выпуск исправлений для API Management: понедельник, 22 июня 2020 г.
• Исправление для управления монетизацией: понедельник, 6 июля 2020 г.
• Обновление системы безопасности сервера управления: понедельник, 24 августа 2020 г.
• Выпуск исправления для Message Processor с исправлениями ошибок: четверг, 24 сентября 2020 г.
• Выпуск исправлений для Message Processor с исправлениями ошибок: понедельник, 26 октября 2020 г.
• Выпуск исправления для Message Processor с исправлениями ошибок: понедельник, 1 февраля 2021 г.

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

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

Правила JWT

• Шифрование JWT

  Правила JWT позволяют создавать, проверять и декодировать зашифрованные токены. Новые элементы правил:

  • <Type> – позволяет указать, должны ли токены быть подписаны или зашифрованы.
  • <EncryptionAlgorithms> – позволяет задать алгоритмы шифрования <Key> и <Content>.

  (67165581)

• Поддержка алгоритмов PSS в подписанных токенах

  Правила для создания и проверки JWT и JWS теперь поддерживают алгоритмы PS256, PS384 и PS512, как описано в IETF RFC 7518. (119856499)

• GenerateJWT relative start time for token

  При создании токена JWT с помощью правила GenerateJWT элемент <NotBefore> позволяет указать относительное время между созданием токена и моментом, когда он становится действительным. Например, если значение <NotBefore> равно 2h, токен будет действителен только через два часа после создания. Вы можете задать время <NotBefore> в миллисекундах (мс), секундах (с), минутах (м), часах (ч), днях (д) или неделях (н). (126261970)

• Как указать открытый ключ или сертификат в VerifyJWT

  В правиле VerifyJWT элемент <PublicKey> / <Certificate> позволяет ссылаться на сертификат в формате PEM, с помощью которого можно проверять входящие подписи JWT. Пример:

  <PublicKey>
    <Certificate ref='public.certificate_pem'/>
  </PublicKey>

  (132918033)

Функции шаблонов сообщений

В этом выпуске добавлены следующие новые функции шаблонов сообщений:

• firstnonull – возвращает значение первого (самого левого) аргумента, не являющегося нулевым. (139698514)
• xpath – позволяет применить выражение XML Path (XPath) для синтаксического анализа переменных XML. (123246424)

Правило AssignMessage: AssignVariable позволяет ссылаться на шаблон сообщения

В правиле AssignMessage элемент <AssignVariable> / <Template> позволяет использовать атрибут ref, чтобы во время выполнения вставлять заранее заданный шаблон, который можно изменить без необходимости модифицировать правило. (118396082)

Несколько псевдонимов сертификатов

При настройке TLS и использовании нескольких сертификатов в хранилище ключей, у каждого из которых свой псевдоним, Edge позволяет ссылаться на определенные псевдонимы сертификатов в конфигурации <SSLInfo><KeyAlias>. Чтобы включить обновленное поведение, задайте для нового свойства HTTPClient.choose.alias.by.keyalias значение true в файле http.properties на процессорах сообщений. Чтобы добавить это свойство, пользователям Edge для общедоступного облака необходимо обратиться в службу поддержки. (142141620)

Правило JSONtoXML: пропустить объявление XML, добавить отступы в выходных данных

Два новых логических параметра в правиле JSONtoXML позволяют более точно управлять выходными данными XML.

• <Options> <OmitXmlDeclaration> – если задано значение true (по умолчанию false), элемент <OmitXmlDeclaration> пропускает декларацию XML <?xml version="1.0" encoding="UTF-8"?>, сгенерированную правилом.

• <Options> <Indent> – если задано значение true (по умолчанию false), элемент <Indent> добавляет отступы в XML-код. Например, вместо следующих выходных данных:

  <Array><n>1</n><n>2</n><n>3</n></Array>

  Элемент Indent создает следующий результат:

  <Array>
   <n>1</n>
   <n>2</n>
   <n>3</n>
  </Array>

(65142394)

Ответы при сканировании виртуального хоста

Если запрос был отправлен на IP-адрес конечной точки Apigee (без указания виртуального хоста), Edge возвращал ответ HTTP 200 и пустой HTML-документ от виртуального хоста Apigee по умолчанию, связанного с этим IP-адресом. Чтобы избежать неправильного впечатления, что такой ответ может представлять собой потенциальную уязвимость, которую можно использовать, соединение разрывается и ответ не возвращается. (140005396)

Свойства целевого сервера в Trace для устранения неполадок

Следующие новые свойства трассировки помогают устранять неполадки с подключением к целевому серверу, показывая, был ли кеширован HTTPClient для целевого сервера: isHttpClientCached и isFromClientPool. (140574604)

Правило MessageLogging: сообщение Syslog

В правиле MessageLogging новый элемент <Syslog> / <PayloadOnly> (логическое значение) позволяет определить, нужно ли автоматически добавлять что-либо к элементу <Message>, который вы задаете. Если вы зададите для параметра <PayloadOnly> значение true, к определению сообщения ничего не будет добавлено (независимо от значения параметра <FormatMessage>). Если задано значение False (по умолчанию), параметр <FormatMessage> определяет, что добавляется в начало сообщения в журнале. (68722102)

Срок действия правил кеширования

Новый элемент <TimeoutInSeconds> для срока действия в правиле ResponseCache и правиле PopulateCache работает так, как изначально предполагалось для существующего элемента <TimeoutInSecs>. Используйте новый элемент. Устаревший элемент <TimeoutInSecs> по-прежнему существует для обеспечения обратной совместимости. Если настроены оба элемента – <TimeoutInSecs> и <TimeoutInSeconds>, Edge использует <TimeoutInSeconds>. (119172893)

Переменная потока virtualhost.aliases.values

Новая переменная потока сообщений virtualhost.aliases.values, доступная только для чтения, возвращает массив всех псевдонимов, назначенных виртуальному хосту, который был вызван во входящем запросе. Массив отформатирован в JSON. (128453178)

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

В API для удаления ревизии прокси добавлен новый параметр запроса force. Если ревизия указана в List API Proxies API, но ее нельзя запросить, этот параметр позволяет удалить ревизию прокси. (111691721)

Пример:

DELETE /v1/organizations/myorg/apis/myproxy/revisions/2?force=true

Новая переменная потока для значений псевдонимов виртуального хоста

Новая переменная потока сообщений virtualhost.aliases.values, доступная только для чтения, возвращает массив всех псевдонимов, назначенных виртуальному хосту, который был вызван во входящем запросе, в формате JSON. (128453178)

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

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