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

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

В следующие даты мы начали выпускать обновления компонентов 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, как описано в IETF RFC 7518 . (119856499)

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

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

• Ссылка на PublicKey/Certificate в VerifyJWT

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

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

  (132918033)

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

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

• firstnonull — возвращает значение первого (крайнего левого) аргумента, отличного от NULL. (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 for Public Cloud должны обратиться в службу поддержки , чтобы добавить это свойство. (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> / <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 списка прокси-серверов API , но фактически не может быть запрошена, этот параметр гарантирует, что версия прокси-сервера будет удалена. (111691721)

Например:

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

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

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

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

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