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

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

В указанные даты мы начали выпуск обновлений компонентов для Apigee Edge для публичного облака:

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

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

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

политика JWT

• JWT-шифрование

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

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

  (67165581)

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

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

• GenerateJWT: относительное время начала для токена

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

• Укажите открытый ключ/сертификат в VerifyJWT.

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

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

  (132918033)

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

Ниже перечислены новые функции шаблонов сообщений, доступные в этом выпуске:

• firstnonull - Возвращает значение первого (самого левого) ненулевого аргумента. (139698514)
• xpath — позволяет применять выражение XML-пути (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)

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

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

Политика ведения журнала сообщений: сообщение 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 запроса. В случаях, когда ревизия указана в API списка прокси, но фактически не может быть запрошена, этот параметр гарантирует удаление ревизии прокси. (111691721)

Например:

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

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

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

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

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