Примечания к выпуску Edge Microgateway

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

Версия 3.3.x

Исправления ошибок и улучшения в версии 3.3.x

3.3.11

19 августа 2026 г. – обновление образа контейнера Docker (тег: 3.3.11-sec.1)

19 августа 2026 г. Apigee выпустила следующие исправления и улучшения для Edge Microgateway.

Обновления контейнеров

Уязвимости, устраненные в обновлении контейнера Docker

• GHSA-5p4m-2wfm-xmqj
• CVE-2026-13595
• CVE-2026-27456
• CVE-2026-12590
• CVE-2026-53614
• CVE-2026-53612
• CVE-2025-14104
• CVE-2026-53615
• CVE-2026-53613
• CVE-2026-34743

1 июля 2026 г. – первый выпуск

1 июля 2026 г. Apigee выпустила следующие исправления для Edge Microgateway 3.3.11.

Версии компонентов

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.3.11. Обратите внимание, что поскольку каждый компонент является отдельным проектом, номера версий могут не совпадать с номером основной версии продукта:

Устранены проблемы с безопасностью

• CVE-2026-7383
• CVE-2026-9076
• CVE-2026-34180
• CVE-2026-34181
• CVE-2026-34182
• CVE-2026-34183
• CVE-2026-42764
• CVE-2026-42766
• CVE-2026-42767
• CVE-2026-42769
• CVE-2026-45445
• CVE-2026-45446
• CVE-2026-45447
• CVE-2026-53550

3.3.10

27 мая 2026 г. в Apigee были выпущены следующие исправления для Edge Microgateway.

Версии компонентов

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.3.10. Обратите внимание, что поскольку каждый компонент является отдельным проектом, номера версий могут не совпадать с номером основной версии продукта:

Устранены проблемы с безопасностью

• CVE-2026-41907
• CVE-2026-4800
• CVE-2026-2950
• CVE-2026-42338

3.3.9

1 апреля 2026 г. Apigee выпустила следующие исправления и улучшения для Edge Microgateway.

Исправления ошибок и улучшения:

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.3.9. Обратите внимание, что поскольку каждый компонент является отдельным проектом, номера версий могут не совпадать с номером основной версии продукта:

Устранены проблемы с безопасностью

• CVE-2025-13465
• CVE-2026-24842
• CVE-2026-26996
• CVE-2026-2391
• CVE-2026-27904
• CVE-2026-27601
• CVE-2026-27903
• CVE-2026-26960
• CVE-2024-22365
• CVE-2026-24001
• CVE-2025-15284
• CVE-2025-64756
• CVE-2026-31802
• CVE-2026-29786
• CVE-2026-25547

3.3.8

16 декабря 2025 г. в Apigee были выпущены следующие исправления и улучшения для Edge Microgateway.

Исправления ошибок и улучшения:

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.3.8. Обратите внимание, что поскольку каждый компонент является отдельным проектом, номера версий могут не совпадать с номером основной версии продукта:

Устранены проблемы с безопасностью

• CVE-2025-59343
• CVE-2025-64756

3.3.7

17 июля 2025 г. Apigee выпустила следующие исправления и улучшения для Edge Microgateway.

Исправления ошибок и улучшения:

edgemicro:
  plugins:
    excludeUrls: '/hello,/proxy_one/*' # global exclude urls
    sequence:
      -oauth
      -json2xml
      -quota
      -json2xml:
          excludeUrls: '/hello/xml/*'  # plugin level exclude urls

Устранены проблемы с безопасностью

• CVE-2024-12905
• CVE-2025-46653

3.3.6

16 апреля 2025 г. в микрошлюз Edge были добавлены следующие исправления и улучшения.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.3.6. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Устранены проблемы с безопасностью

• CVE-2025-27789
• CVE-2024-21538
• CVE-2024-12133

3.3.5

20 декабря 2024 г. Apigee выпустила следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.3.5. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

current nodejs version is  18.x.x Note, v18.x.x will be out of support soon, see https://docs.apigee.com/release/notes/edge-microgateway-release-notes-0

You are using a version of NodeJS that is not supported

Устранены проблемы с безопасностью

• CVE-2024-21538
• CVE-2024-45590
• CVE-2019-3844
• CVE-2019-12290
• CVE-2020-1751
• CVE-2018-12886
• CVE-2023-50387
• CVE-2019-3843
• CVE-2022-4415
• CVE-2021-3997

3.3.4

18 сентября 2024 г. в Apigee были выпущены следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.3.4. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

Устранены проблемы с безопасностью

• CVE-2021-23337
• CVE-2024-4068
• CVE-2020-28469
• CVE-2020-28503

3.3.3

25 апреля 2024 г. Apigee выпустила следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.3.3. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

Устранены проблемы с безопасностью

• CVE-2023-0842
• CVE-2023-26115
• CVE-2022-25883
• CVE-2017-20162
• CVE-2022-31129
• CVE-2022-23539
• CVE-2022-23541
• CVE-2022-23540
• CVE-2024-21484
• CVE-2022-46175
• CVE-2023-45133
• CVE-2020-15366
• CVE-2023-26136
• CVE-2023-26115

3.3.2

18 августа 2023 г. в Apigee были выпущены следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.3.2. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

Устранены проблемы с безопасностью

Нет.

3.3.1

7 июня 2022 г. в Apigee были выпущены следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.3.1. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

Устранены проблемы с безопасностью

3.3.0

4 февраля 2022 г. Apigee выпустила следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.3.0. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

npm install apigeetool@0.15.1

Версия 3.2.x

Исправления ошибок и улучшения в версии 3.2.x

3.2.3

17 сентября 2021 г. в Apigee были выпущены следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.2.3. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

Устранены проблемы с безопасностью

3.2.2

15 июля 2021 г. в Apigee были выпущены следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.2.2. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

Устранены проблемы с безопасностью

3.2.1

5 марта 2021 г. Apigee выпустила следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.2.1. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

edgemicro:
 enable_GET_req_body: true

3.2.0

21 января 2021 г. в Apigee были выпущены следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.2.0. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

Версия 3.1.x

Исправления ошибок и улучшения в версии 3.1.x

3.1.8

16 ноября 2020 г. Apigee выпустила следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.1.8. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

3.1.7

24 сентября 2020 г. в Apigee были выпущены следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.1.7. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

{"message":"write after end","code":"ERR_STREAM_WRITE_AFTER_END"}

3.1.6

20 августа 2020 г. Apigee выпустила следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.1.6. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

3.1.5

26 июня 2020 г. Apigee выпустила следующие исправления и улучшения для Edge Microgateway.

Исправлена проблема с зависимостями в версии 3.1.3. Версия 3.1.3 отмечена как устаревшая в репозитории npm. В противном случае все исправления ошибок и улучшения, описанные в примечаниях к выпуску версии 3.1.3, применяются и к этому выпуску.

3.1.3

15 апреля 2020 г. Apigee выпустила следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.1.3. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

• 153509313 – устранена проблема, из-за которой модуль отладки Node.js приводил к утечкам памяти. Проблема наблюдается в версиях 3.1.0, 3.1.1 и 3.1.2.
• 153509313 – устранена проблема, из-за которой в выходных данных журнала печатался один и тот же идентификатор сообщения для двух разных транзакций.
• 151673570 – устранена проблема, из-за которой Edge Microgateway не обновлялся для использования новых API Apigee KVM. Теперь Edge Microgateway использует новые команды для добавления и обновления значений KVM.
• 152822846 – в предыдущих версиях Edge Microgateway был обновлен таким образом, чтобы обработка сопоставления пути к ресурсу соответствовала Apigee Edge. В этой версии устранена проблема, из-за которой шаблон /literal_string/* обрабатывался неправильно. Пример:/*/2/*. Также ознакомьтесь со статьей Как настроить поведение пути к ресурсу '/', '/*' и '/**'.
• 152005003 – внесены изменения, позволяющие использовать идентификаторы с областью действия на уровне организации и среды для квот.
• 152005003 – внесены изменения, позволяющие использовать идентификаторы с областью действия на уровне организации и среды для квот. Сочетание org + env + appName + productName используется в качестве идентификатора квоты.

3.1.2

16 марта 2020 г. в Apigee были выпущены следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.1.3. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

• 151285018 – добавлена поддержка HTTP-прокси для трафика между Edge Microgateway и целевыми серверами. Кроме того, были исправлены проблемы с поддержкой HTTP-прокси между Edge Microgateway и Apigee Edge. Подробнее:
  • Используйте HTTP-прокси для связи с Apigee Edge
  • Используйте HTTP-прокси для целевой коммуникации
• 149101890 – код уведомления журнала для случаев, когда целевой сервер или балансировщик нагрузки закрывает подключение, был изменен с ERROR на INFO.
• 150746985 – устранена проблема, из-за которой команда edgemicro verify работала неправильно, если в файле конфигурации присутствовали redisBasedConfigCache: true или quotaUri: https://%s-%s.apigee.net/edgemicro-auth.
• 151284716 – улучшена скорость закрытия серверных подключений при перезапуске рабочих процессов во время перезагрузки.
• 151588764 – обновите версию Node.js в образе Docker, используемом для запуска Edge Microgateway в контейнере Docker, до 12, поскольку версия 8 устарела.
• 151306049 – в документацию добавлена информация о том, какие API управления Apigee Edge используются командами Edge Microgateway CLI. Подробнее о том, какие API управления использует Edge Microgateway…

3.1.1

20 февраля 2020 г. Apigee выпустила следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.1.1. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

• 146069701 – устранена проблема, из-за которой модуль microgateway-core не учитывал переменные среды HTTP_PROXY и HTTPS_PROXY. Теперь настройки прокси-сервера в файле конфигурации YAML, если они указаны, игнорируются. Для указания прокси-сервера используются только переменные среды.

  Если вы хотите указать конфигурацию прокси-сервера в файле конфигурации, вам также необходимо указать переменную HTTP_PROXY, в которой будет тот же URL прокси-сервера, что и в файле конфигурации. Например, если вы зададите следующую конфигурацию:

  edge_config:
    proxy: http://10.128.0.20:3128
    proxy_tunnel: true

  Также необходимо указать следующую переменную среды:

  HTTP_PROXY=http://10.128.0.20:3128

• 146320620 – добавлен новый параметр конфигурации edgemicro.headers_timeout. Этот атрибут ограничивает время (в миллисекундах), в течение которого HTTP-парсер будет ожидать получения полных заголовков HTTP. Пример:

  edgemicro:
  keep_alive_timeout: 6000
  headers_timeout: 12000

  Внутренне параметр задает атрибут Node.js Server.headersTimeout в запросах. (По умолчанию: на 5 секунд больше, чем время, заданное с помощью edgemicro.keep_alive_timeout.) Это значение по умолчанию предотвращает ошибочное отключение соединения балансировщиками нагрузки или прокси-серверами.

• 149278885 – добавлена новая функция, позволяющая задавать целевой тайм-аут API на уровне прокси API, а не использовать один глобальный тайм-аут.

  Если вы зададите свойство TargetEndpoint io.timeout.millis в прокси-сервере API, Edge Microgateway сможет получить это свойство и применить тайм-ауты, относящиеся к конечной точке целевого сервиса. Если этот параметр не применяется, Edge Microgateway использует глобальный тайм-аут, заданный с помощью edgemicro.request_timeout.

3.1.0

21 января 2020 г. Apigee выпустила следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.1.0. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

• 144187500 – при срабатывании флага quotas.failOpen будет зарегистрировано новое событие уровня WARNING. Этот флаг активируется, если при обработке квоты возникает ошибка или если запрос на применение квоты к Edge не может обновить счетчики удаленной квоты. В этом случае квота будет обрабатываться только на основе локальных данных до следующей успешной синхронизации с удаленным сервером. Ранее это событие регистрировалось только при уровне ведения журнала DEBUG.

  Пример:

  2020-01-20T02:52:53.040Z [warn][localhost:8000][5][foo-eval][test][hello/][]
  [DbpGIq9jKfzPX8jvXEivhA0LPwE][f372cc30-3b2f-11ea-845f-a627f][quota][remote quota not
  available so processing locally, setting quota-failed-open for identifier: AppQuota60.Quota60]
  [GET][][][][]

• 145023519 – устранена проблема, из-за которой на выполняющиеся или новые транзакции влияли изменения, обнаруженные Edge Microgateway в прокси API. Теперь при изменении прокси-сервера Edge Microgateway обновляет кеш и перезапускает рабочие узлы. Это изменение не повлияет на выполняемые транзакции и новые вызовы API, отправляемые в микрошлюз.
• 146378327 – уровень журнала sourceRequest, targetRequest и targetResponse был изменен на INFO.
• 146019878 – устранено расхождение между задержкой, рассчитанной для параметра "Эффективность прокси API" в аналитике Edge, и событиями журнала sourceResponse/targetResponse Edge Microgateway. Теперь задержка в аналитике Edge и событиях журнала Microgateway одинакова.
• Изменения в логике сопоставления с образцом:
  • 147027862 – плагин OAuth был обновлен, чтобы поддерживать следующие шаблоны сопоставления путей к ресурсам, указанные в продуктах API:
    • /{literal}**
    • /{literal}*
    • Любая комбинация двух описанных выше шаблонов

    Теперь плагин Edge Microgateway использует те же шаблоны, что и Apigee Edge. Подробнее об этом рассказывается в статье Как настроить поведение пути к ресурсу с помощью символов "/", "/*" и "/**".

  • 145644205 – обновить логику сопоставления шаблонов плагина apiKeys, чтобы она соответствовала плагину oauth.
• 143488312 – исправлена проблема, из-за которой пробелы в начале или конце параметра идентификатора клиента приводили к тому, что список товаров JWT был пустым для запросов токена OAuth и ключа API.
• 145640807 и 147579179 – добавлена новая функция, которая позволяет специальному экземпляру Edge Microgateway, называемому синхронизатором, получать данные конфигурации из Apigee Edge и записывать их в локальную базу данных Redis. Другие экземпляры микрошлюза можно настроить так, чтобы они считывали данные конфигурации из базы данных. Эта функция повышает устойчивость Edge Microgateway. Это позволяет экземплярам микрошлюза запускаться и работать без связи с Apigee Edge. Подробнее об использовании синхронизатора…

  Функция синхронизации в настоящее время поддерживается для работы с Redis 5.0.x.

Версия 3.0.x

Исправления ошибок и улучшения в версии 3.0.x

3.0.10

8 ноября 2019 г. Apigee выпустила следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.0.10. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

• 142677575 – в API-продукте для Edge Microgateway изменена функция сопоставления шаблонов для путей к ресурсам, чтобы она соответствовала функции сопоставления шаблонов для путей к ресурсам, используемой в Apigee Edge, как описано в разделе Настройка поведения пути к ресурсу "/", "/*" и "/**".

  Примечание. Если вы используете сложный шаблон ресурса, например /*/2/**, убедитесь, что прокси-сервер edgemicro_auth добавлен в отдельный продукт API. Затем добавьте этот продукт в приложение разработчика прокси-сервера, как показано на скриншоте ниже.

  

  Примечание. Свойство конфигурации features.isSingleForwardSlashBlockingEnabled, описанное в разделе Настройка поведения пути к ресурсу "/", "/*" и "/**", не поддерживается для Edge Microgateway.

• 143740696 – изменена структура конфигурации quotas (см. также примечания к выпуску версии 3.0.9). Свойство quotas используется для настройки плагина квот. Структура была изменена, чтобы сделать элементы конфигурации более понятными. Чтобы настроить плагин квот, используйте следующую конфигурацию YAML. Обратите внимание, что свойство конфигурации называется quotas. Подробную информацию об отдельных свойствах конфигурации quotas можно найти в разделе Варианты конфигурации квот.

  edgemicro:
    home: ../gateway
    port: 8000
    max_connections: -1
    max_connections_hard: -1
    logging:
      level: info
      dir: /var/tmp
      stats_log_interval: 60
    plugins:
      dir: ../plugins
      sequence:
        - oauth
        - quota
  quotas:
    bufferSize:
      hour: 20000
      minute: 500
      default: 10000
    useDebugMpId: true
    failOpen: true
  ...

• 141750056 – добавлена новая функция, позволяющая использовать Redis в качестве хранилища квот. Если useRedis имеет значение true, используется модуль volos-quota-redis. Если задано значение true, квота будет ограничена только теми экземплярами Edge Microgateway, которые подключаются к Redis. Если значение равно false, в качестве хранилища используется модуль volos-quota-apigee, а счетчик квот является глобальным. Подробнее о параметрах конфигурации квот… Пример:

  edgemicro:
  ...
  quotas:
    useRedis: true
    redisHost: localhost
    redisPort: 6379
    redisDb: 1

• 140574210 – срок действия токенов, сгенерированных прокси-сервером edgemicro-auth, по умолчанию изменен с 108 000 миллисекунд (1,8 минуты) на 1800 секунд (30 минут).
• 143551282 – чтобы поддерживать организации с включенным протоколом SAML, команда edgemicro genkeys была обновлена и теперь включает параметр ‑‑token. Этот параметр позволяет использовать для аутентификации токен OAuth вместо имени пользователя и пароля. Подробнее о создании ключей…

3.0.9

11 октября 2019 г. Apigee выпустила следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.0.9. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

• 141989374 – в плагин квот добавлена новая функция "fail open". Если эта функция включена, то при возникновении ошибки обработки квоты или если запрос на применение квоты к Edge не сможет обновить счетчики удаленной квоты, квота будет обрабатываться только на основе локальных счетчиков до следующей успешной синхронизации удаленной квоты. В обоих случаях в объекте запроса устанавливается флаг quota-failed-open.

  Чтобы включить функцию "fail open" для квоты, задайте следующие настройки:

  quotas :
   failOpen : true

  Примечание. Кроме того, флаг объекта запроса fail-open плагина OAuth был переименован в oauth-failed-open.

• 142093764 – в прокси-сервер edgemicro-auth внесены изменения конфигурации, чтобы предотвратить превышение квоты. Изменение заключается в том, чтобы задать для типа квоты значение calendar. Чтобы воспользоваться улучшением, обновите edgemicro-auth до версии 3.0.7 или более поздней.
• 142520568 – добавлена новая функция, позволяющая регистрировать идентификатор обработчика сообщений в ответах на запросы квоты. Чтобы использовать эту функцию, обновите прокси-сервер edgemicro-auth до версии 3.0.7 или более поздней и задайте следующие настройки:

  quotas:
    useDebugMpId: true

  Если задано значение useDebugMpId, ответы Edge, связанные с квотами, будут содержать идентификатор MP и будут регистрироваться Edge Microgateway. Пример:

  {
      "allowed": 20,
      "used": 3,
      "exceeded": 0,
      "available": 17,
      "expiryTime": 1570748640000,
      "timestamp": 1570748580323,
      "debugMpId": "6a12dd72-5c8a-4d39-b51d-2c64f953de6a"
  }

3.0.8

26 сентября 2019 г. в Apigee были выпущены следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.0.8. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

• 140025210 – добавлена новая функция "fail open". Эта функция позволяет продолжить обработку API, если срок действия токена JWT истек и его не удается обновить из-за ошибки подключения, которая препятствует успешному вызову для проверки ключа API к прокси-серверу edgemicro-auth.

  Эта функция позволяет задать льготный период, в течение которого старый токен остается в кеше и используется повторно. Эта функция позволяет Edge Microgateway продолжать обрабатывать запросы в случае временного сбоя подключения. Когда подключение восстановится и вызов API для проверки ключа будет выполнен успешно, будет получен новый токен JWT, который заменит старый в кеше.

  Чтобы настроить новую функцию "открытый отказ", выполните следующие действия:

  1. Задайте следующие свойства в разделе oauth файла конфигурации Edge Microgateway:

     oauth:
       failOpen: true
       failopenGraceInterval: time_in_seconds
       cacheKey: true
       ...

     Пример:

     oauth:
       failOpen: true
       failopenGraceInterval: 5
       cacheKey: true
       ...

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

• 141168968 – в выходные данные всех журналов плагинов добавлена переменная correlation_id. Кроме того, уровни журналов для некоторых журналов были изменены на error.
• 140193349 – в прокси-сервер edgemicro-auth было внесено изменение, согласно которому ключ и секрет Edge Microgateway должны проверяться при каждом запросе Verify API Key. Edge Microgateway теперь всегда отправляет ключ и секретный код в каждом запросе Verify API Key. Это изменение не позволит клиентам получать JWT, используя только ключ API.
• 140090250 – добавлено ведение журнала диагностики для обработки квот. Благодаря этому изменению теперь можно сопоставлять выходные данные журнала квот с остальными журналами Edge Microgateway.

3.0.7

12 сентября 2019 г. компания Apigee выпустила следующие исправления и улучшения для Edge Microgateway.

Версии компонентов:

В таблице ниже перечислены номера версий отдельных проектов компонентов, связанных с Edge Microgateway 3.0.7. Обратите внимание, что каждый компонент является отдельным проектом, поэтому номера версий могут не совпадать с номером основной версии продукта:

Исправления ошибок и улучшения:

• 140075602 – в плагин OAuth внесены изменения, чтобы в подходящих случаях возвращался код статуса 5xx. Раньше плагин возвращал коды статуса 4xx во всех случаях, кроме 200. Теперь для любого ответа, код статуса которого не равен 200, будет возвращаться точный код 4xx или 5xx в зависимости от ошибки.

  По умолчанию эта функция отключена. Чтобы включить эту функцию, добавьте свойство oauth.useUpstreamResponse: true в конфигурацию Edge Microgateway. Пример:

  oauth:
    allowNoAuthorization: false
    allowInvalidAuthorization: false
    gracePeriod: 10
    useUpstreamResponse: true

• 140090623 – в версии 3.0.6 добавлено новое свойство конфигурации quota.quotaUri. Задайте это свойство конфигурации, если вы хотите управлять квотами через прокси-сервер edgemicro-auth, развернутый в вашей организации. Если это свойство не задано, конечная точка квоты по умолчанию будет внутренней конечной точкой Edge Microgateway. Пример:

  edge_config:
    quotaUri: https://%s-%s.apigee.net/edgemicro-auth

  В версии 3.0.7 edgemicro-auth был обновлен, чтобы принимать эту новую конфигурацию. Чтобы использовать свойство quotaUri, необходимо обновить прокси-сервер edgemicro-auth до последней версии. Подробнее об обновлении прокси-сервера edgemicro-auth…

• 140470888 – в вызовы квот добавлен заголовок Authorization для аутентификации. Кроме того, прокси-сервер edgemicro-auth был изменен, чтобы удалить "organization" из идентификатора квоты. Поскольку конечная точка квоты находится в организации клиента, идентификатор квоты больше не нужен.
• 140823165 – следующее название ресурса:

  edgemicro:
      keepAliveTimeout

  неправильно описан в версии 3.0.6. Правильное название ресурса:

  edgemicro:
      keep_alive_timeout

• 139526406 – исправлена ошибка, из-за которой неправильно рассчитывалась квота, если у приложения разработчика было несколько продуктов. Теперь квота корректно применяется к каждому продукту в приложении, в котором их несколько. Сочетание appName + productName используется в качестве идентификатора квоты.

3.0.6

29 августа 2019 г. компания Apigee выпустила следующие исправления и улучшения для Edge Microgateway.

• 138633700 – добавлено новое свойство конфигурации keepAliveTimeout. Это свойство позволяет задать время ожидания Edge Microgateway (в миллисекундах). Значение по умолчанию: 5000 мс.

  Пример:

  edgemicro:
    keep_alive_timeout: 600

• 140090623 – добавлено новое свойство конфигурации quotaUri. Укажите это свойство конфигурации, если хотите управлять квотами через прокси-сервер edgemicro-auth, развернутый в вашей организации. Если это свойство не задано, конечная точка квоты по умолчанию будет внутренней конечной точкой Edge Microgateway. Пример:

  edge_config:
    quotaUri: https://your_org-your_env.apigee.net/edgemicro-auth
  

  Чтобы использовать эту функцию, сначала разверните последнюю версию прокси-сервера edgemicro-auth в организации. Подробнее об обновлении прокси-сервера edgemicro-auth…

• 138722809 – добавлено новое свойство конфигурации stack_trace. Это свойство позволяет управлять тем, будут ли трассировки стека появляться в файлах журналов. Пример:

  stack_trace: false

  Если для параметра stack_trace задано значение true, в журналах будет напечатан трассировщик стека. Если задано значение false, трассировка стека не будет записываться в журналы.

3.0.5

15 августа 2019 г. в Apigee были выпущены следующие исправления и улучшения для Edge Microgateway.

• 139005279 – устранена проблема, из-за которой команда edgemicro status возвращала неверное количество рабочих процессов.
• 138437710 – исправлена ошибка в классе ExitCounter, из-за которой не удавалось правильно записать журнал.

• 139064652 – добавлена возможность задавать уровни ведения журналов trace и debug для журналов событий и системных журналов. Пока добавлена только возможность добавлять эти уровни. В настоящее время доступны следующие уровни ведения журнала: info, warn и error.
• 139064616 – стандартизирован вывод журнала для всех операторов журнала консоли. В операторы ведения журнала консоли теперь входят следующие атрибуты:
• Временная метка
• Название компонента
• Идентификатор процесса
• Сообщение в журнале консоли

• 138413755 – улучшены сообщения журнала, связанные с ключом и секретом JWT, для следующих команд CLI: cert, verify, upgradekvm, token, genkeys, revokekeys, rotatekey и configure.

• 138413577 – добавление и улучшение обработки ошибок при истечении времени ожидания бэкенд-службы.
• 138413303 – добавлены и улучшены обработка ошибок для времени ожидания ответа и сокета.
• 138414116 – добавлены и улучшены средства обработки ошибок "Подключение отклонено".

3.0.4

1 августа 2019 г. компания Apigee выпустила следующие исправления и улучшения для Edge Microgateway.

• 134445926 – улучшения внутренней аутентификации Edge Microgateway.
• 137582169 – устранена проблема, из-за которой запускались нежелательные процессы. Из-за дополнительных процессов плагины перезагружались и использовалось слишком много памяти. Теперь Edge Microgateway поддерживает количество процессов в пределах ожидаемого лимита.
• 137768774 – улучшение сообщений в журнале:
  • Очищены журналы транзакций (запросов).
  • Добавлены дополнительные сообщения журнала, где это необходимо.
  • Перемещены сообщения журнала транзакций (запросов) из вывода консоли в соответствующий файл журнала.
  • Обновлены журналы консоли, чтобы использовать централизованную функцию ведения журналов.
• 138321133, 138320563 – внутренние изменения буфера квоты, необходимые для ее дальнейшего улучшения.

3.0.3

23 июля 2019 г. компания Apigee выпустила следующие исправления и улучшения для Edge Microgateway.

• Улучшения в ведении журналов. В существующих журналах времени выполнения используется новая функция eventLog(), которая собирает и регистрирует данные времени выполнения в едином формате. Информация в журнале включает:
  • Временная метка (ISO 8601: ГГГГ-ММ-ДДTЧЧ:мм:сс.сссZ).
  • Уровень ведения журнала (ошибка, предупреждение или информация).
  • Имя хоста – имя хоста, указанное в заголовке запроса.
  • Идентификатор процесса. Если вы используете кластер процессов Node.js, это идентификатор процесса, в котором выполнялось ведение журнала.
  • Название организации Apigee.
  • Название среды в организации.
  • Название прокси-сервера API.
  • IP-адрес клиента.
  • ClientId.
  • Идентификатор корреляции (в настоящее время не задан).
  • Название компонента Edge Microgateway.
  • Пользовательское сообщение – некоторые объекты могут печатать дополнительную информацию, которая передается этому свойству ошибки.
  • Метод запроса (если это HTTP-запрос).
  • Код статуса ответа (если запрос HTTP).
  • Сообщение об ошибке.
  • Код ошибки. Если объект содержит код ошибки, он будет указан в этом свойстве.
  • Время.
  • Операционная система маркер конца строки.

  Если значение свойства равно null, то в скобках ничего не будет: [].

  Ниже приведен пример формата журнала:

  Timestamp [level][hostname][ProcessId][Org][Environment][APIProxy][ClientIp][ClientId][][component][customMessage][reqMethod][respStatusCode][errMessage][errCode][timeTaken]

  (137770055)

• Производительность. Продукты API не фильтровались по среде. Проблема устранена. (135038879)
• Различные интеграции функциональных тестов и улучшения качества кода.

3.0.2

3 июля 2019 г. компания Apigee выпустила следующие исправления и улучшения для микрошлюза Edge.

Качество кода. Код был проверен на качество, и в него были внесены изменения, чтобы соответствовать стандартам качества, запрошенным пользователями. Мы исправили ошибки и предупреждения, связанные с качеством кода, которые были получены с помощью JSHint. В результате были обнаружены и исправлены некоторые ошибки в коде. Все модули Apigee Edge Microgateway прошли этот процесс. Посмотрите изменения от 28 июня и 2 июля для microgateway-config, microgateway-core, microgateway-plugins и microgateway. Все модули, в которых были внесены изменения, связанные с качеством кода, протестированы с помощью внутренних инструментов, которые проверяют выполнение Edge Microgateway для клиентских вариантов использования.

3.0.1

21 июня 2019 г. в микрошлюз Edge были добавлены следующие исправления и улучшения.

• 134834551 – изменение поддерживаемых версий Node.js для Edge Microgateway
  (поддерживаемые версии Node.js: 8 и 12; версии 7, 9 и 11 являются экспериментальными)
• 134751883 – Edge Microgateway дает сбой при перезагрузке под нагрузкой
• 134518428 – конечная точка Products для Edge Microgateway возвращает код ошибки 5XX, если шаблон фильтра неправильный
• 135113408 – рабочие процессы должны перезапускаться, если они неожиданно завершаются
• 134945852 – tokenCacheSize не используется в плагине OAuth
• 134947757 – задать cacheTTL в плагине OAuth
• 135445171 – неправильный расчет льготного периода в OAuth
• Используйте модуль memored, который поставляется вместе с Edge Microgateway.
• 135367906 – проверка безопасности

Версия 2.5.x

Новые функции и улучшения версии 2.5.x

(Исправлено в версии 2.5.38 от 07.06.2019)

Неправильно отформатированные JWT могут приводить к сбоям в работе рабочих процессов при использовании кеша токенов. Исправлено в модуле микрошлюза Edge microgateway-plugins. (b/134672029)

(Добавлено в версии 2.5.37) Добавлен параметр командной строки edgemicro-cert -t.

Вариант edgemicro cert -t позволяет указать токен OAuth для аутентификации API управления. Подробнее об управлении сертификатами…

(Добавлено в версии 2.5.35) Добавлена поддержка отладки Edge Microgateway с помощью edgemicroctl.

Флаг mgdebug можно использовать с командой edgemicroctl. Также ознакомьтесь с задачами по интеграции Kubernetes.

(Добавлено в версии 2.5.35) Включите сборку Windows для edgemicroctl.

(Добавлено в версии 2.5.31) Новый API edgemicro-auth/token

Добавлен новый API edgemicro-auth/token, который позволяет передавать клиента/секретный код в виде заголовка базовой авторизации, закодированного в Base64, а grant_type – в виде параметра формы. Подробнее о том, как получить токены носителя напрямую…

(Исправлено в версии 2.5.31) Приватная конфигурация не учитывает флаг токена

Исправлена проблема, из-за которой при настройке Edge Microgateway на использование токена доступа OAuth2 в Edge для частного облака токен не учитывался.

Docker: поддержка использования самозаверяющих сертификатов

(Добавлено в версии 2.5.29) Если вы используете центр сертификации (ЦС), который по умолчанию не является доверенным для Node.js, при запуске контейнера Docker с Edge Microgateway можно использовать параметр NODE_EXTRA_CA_CERTS. Подробнее о том, как использовать ЦС, которому не доверяет Node.js…

Docker: поддержка TLS

(Добавлено в версии 2.5.29) Edge Microgateway, работающий в контейнере Docker, теперь поддерживает TLS для входящих запросов к серверу Edge Microgateway (запросы в северном направлении) и для исходящих запросов от Edge Microgateway к целевому приложению (запросы в южном направлении).

Ниже приведены подробные примеры настройки TLS:

• Пример конфигурации TLS для исходящего трафика
• Пример конфигурации TLS для исходящего трафика

В этих примерах показано, как использовать точку подключения контейнера /opt/apigee/.edgemicro для загрузки сертификатов, на которые затем ссылается файл конфигурации Edge Microgateway.

Docker: поддержка проксирования запросов

(Добавлено в версии 2.5.27) Если вы запускаете Edge Microgateway в контейнере Docker, то можете использовать следующие параметры, чтобы управлять поведением прокси, когда микрошлюз работает за межсетевым экраном:

• HTTP_PROXY
• HTTPS_PROXY
• NO_PROXY

Подробнее о том, как запустить Edge Micro в контейнере Docker…

Docker: обновленные инструкции по работе с плагином

(Добавлено 25.05.2027) Если вы используете Edge Microgateway в контейнере Docker, теперь у вас есть два варианта развертывания плагинов. Один из вариантов, с использованием точки подключения Docker, является новым. Второй вариант существовал и раньше, и в нем почти ничего не изменилось. Однако мы обновили файл Dockerfile. Подробную информацию можно найти по ссылкам ниже.

• Вариант А. Подключите каталог плагинов к тому (новый)
• Вариант Б. Встройте плагины в контейнер (обновлено)

Поддержка нового токена OAuth для команды обновления KVM

(Добавлено в версии 2.5.27) Вы можете использовать токен OAuth с командой upgradekvm. Подробнее об обновлении KVM…

Разделение API в Edge Analytics

(Добавлено 2.5.26) Новые флаги плагина аналитики позволяют выделить определенный путь API, чтобы он отображался как отдельный прокси на страницах статистики Edge. Например, вы можете разделить API проверки работоспособности, чтобы не путать их с фактическими вызовами API. Подробнее о том, как исключить пути из аналитики…

Настройка локального прокси-сервера

(Добавлено 2.5.25) При использовании локального прокси-сервера вам не нужно вручную создавать прокси-сервер с поддержкой микрошлюза в Apigee Edge. Вместо этого микрошлюз будет использовать базовый путь локального прокси. Подробнее о локальном режиме прокси…

Как использовать автономный режим

(Добавлено 25.05.2025) Вы можете запустить Edge Microgateway, полностью отключенный от любых зависимостей Apigee Edge. В этом случае Edge Microgateway работает в автономном режиме. Это позволяет запускать и тестировать его без подключения к интернету. Подробнее об автономном режиме Edge Microgateway…

Отзыв ключей

(Добавлено в версии 2.5.19) Добавлена новая команда CLI, которая отзывает ключ и секретные учетные данные для конфигурации Edge Microgateway.

edgemicro revokekeys -o [organization] -e [environment] -u [username] -k [key] -s [secret]

Поддержка Docker

(Добавлено в версии 2.5.19) Теперь вы можете скачать последнюю версию Edge Microgateway в виде образа Docker:

docker pull gcr.io/apigee-microgateway/edgemicro:latest

Поддержка Kubernetes

(Добавлено 2.5.19) Вы можете развернуть Edge Microgateway как сервис или как дополнительный шлюз перед сервисами, развернутыми в кластере Kubernetes. Подробнее об интеграции Edge Microgateway с Kubernetes…

Поддержка параметра TCP nodelay

(Добавлено в версии 2.5.16) В конфигурацию Edge Micro добавлена новая настройка nodelay.

По умолчанию TCP-подключения используют алгоритм Нагла для буферизации данных перед их отправкой. Если задать для параметра nodelay значение true, этот алгоритм будет отключен (данные будут отправляться сразу после каждого вызова socket.write()). Подробная информация приведена в документации по Node.js.

Чтобы включить nodelay, измените файл конфигурации Edge Micro следующим образом:

edgemicro:
  nodelay: true
  port: 8000
  max_connections: 1000
  config_change_poll_interval: 600
  logging:
    level: error
    dir: /var/tmp
    stats_log_interval: 60
    rotate_interval: 24

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

(Добавлено в версии 2.5.12) В команду edgemicro forever добавлены новые параметры. Эти параметры позволяют указать местоположение файла forever.json и запустить или остановить фоновый процесс Forever. Подробнее о постоянном мониторинге…

Примеры:

Чтобы начать пользоваться Forever:

edgemicro forever -f ~/mydir/forever.json -a start

Чтобы остановить Forever:

edgemicro forever -a stop

Ротация ключей JWT

Добавлена новая функция, позволяющая менять пары открытых и закрытых ключей, используемые для создания токенов JWT, которые применяются для защиты OAuth в Edge Microgateway. Подробнее о том, как проводить ротацию токенов JWT…

Как фильтровать скачанные прокси API

По умолчанию Edge Microgateway скачивает все прокси-серверы в организации Edge, названия которых начинаются с префикса "edgemicro_". Вы можете изменить это значение по умолчанию, чтобы скачивать прокси-файлы, названия которых соответствуют определенному шаблону. Подробнее о том, как фильтровать скачанные прокси…

Как указывать товары без прокси API

В Apigee Edge можно создать продукт API, который не содержит прокси API. Эта конфигурация продукта позволяет использовать ключ API, связанный с этим продуктом, с любым прокси-сервером, развернутым в вашей организации. Начиная с версии 2.5.4 Edge Microgateway поддерживает эту конфигурацию продукта.

Поддержка постоянного мониторинга

В Edge Microgateway есть файл forever.json, который можно настроить, чтобы указать, сколько раз и с какими интервалами следует перезапускать Edge Microgateway. Этот файл настраивает сервис forever-monitor, который управляет Forever программным способом. Подробнее о постоянном мониторинге…

Централизованное управление файлом конфигурации Edge Micro

Если вы используете несколько экземпляров Edge Microgateway, вам может понадобиться управлять их конфигурациями из одного места. Для этого нужно указать HTTP-адрес, по которому Edge Micro может скачать файл конфигурации. Подробнее о том, как указать конечную точку файла конфигурации…

Поддержка параметра forever CLI

(Добавлено в версии 2.5.8) Используйте команду edgemicro forever [package.json], чтобы указать местоположение файла forever.json. Добавление этой команды позволило отказаться от требования, чтобы файл config находился в корневом каталоге Edge Microgateway.

Пример:

edgemicro forever ~/mydir/forever.json

Добавление параметра configUrl в команду reload

(Добавлено в версии 2.5.8) Теперь с командой edgemicro reload можно использовать параметр --configUrl или -u.

Льготный период для расхождений во времени JWT

(Добавлено в версии 2.5.7) Атрибут gracePeriod в конфигурации OAuth помогает предотвратить ошибки, вызванные небольшими расхождениями между системными часами и временем, указанным в параметрах "Не ранее" (nbf) или "Выдано" (iat) в токене авторизации JWT. Укажите в этом атрибуте количество секунд, в течение которых допускаются расхождения. Подробнее об атрибутах OAuth…

(Добавлено в версии 2.5.7) Атрибут gracePeriod в конфигурации OAuth помогает предотвратить ошибки, вызванные небольшими расхождениями между системными часами и временем, указанным в параметрах "Не ранее" (nbf) или "Выдано" (iat) в токене авторизации JWT. Укажите в этом атрибуте количество секунд, в течение которых допускаются расхождения. Подробнее об атрибутах OAuth…

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

• (Проблема № 236) Исправлена опечатка в инструкции по очистке кеша.
• (Проблема № 234) Перезагрузка приводит к сбоям в Edge Microgateway 2.5.35.
• (Проблема № 135) При использовании параметра -v возникает ошибка "Недопустимая ссылка на виртуальный хост "secure"". Это исправление изменяет прокси-сервер edgemicro-auth перед развертыванием, чтобы виртуальные хосты точно соответствовали тому, что указано во флаге "-v". Кроме того, вы можете указать любое количество виртуальных хостов с любыми названиями (больше не нужно ограничиваться вариантами default и secure).
• (Проблема № 141) Команда edgemicro reload не поддерживает параметр файла конфигурации -c. Наши специалисты уже устранили эту проблему.
• (Проблема № 142) При установке Edge Microgateway появляется сообщение об устаревшем криптографическом алгоритме. Наши специалисты уже устранили эту проблему.
• (Проблема № 145) Квота не работает с Edge Microgateway. Наши специалисты уже устранили эту проблему.
• (Проблема сообщества Apigee: EMG - JWT token validated against both API Proxies and Resource URI in OAUTH) Токен JWT проверяется на соответствие как прокси API, так и URI ресурса в OAUTH. Проблема устранена.
• (Проблема сообщества Apigee: микрошлюз работает даже без токена OAuth в заголовке) Микрошлюз не работает с OAuth. Наши специалисты уже устранили эту проблему.
• Исправлена ошибка pidPath в Windows.
• (Проблема № 157) Исправлена проблема, из-за которой появлялось следующее сообщение об ошибке: "ReferenceError: deployProxyWithPassword не определено".
• (Проблема № 169) Обновление зависимостей Node.js (npm audit)
• Прокси-сервер edgemicro-auth теперь использует правила JWT Edge. Прокси-сервер больше не зависит от Node.js для поддержки JWT.

Версия 2.4.x

Новые функции и улучшения версии 2.4.x

1. Настройте собственный псевдоним для прокси-сервера edgemicro-auth (PR 116)

Вы можете изменить базовый путь по умолчанию для прокси-сервера edgemicro-auth. По умолчанию базовый путь – /edgemicro-auth. Чтобы изменить его, используйте флаг -x в команде edgemicro configure.

Пример:

edgemicro configure -x /mypath …

2. Поддержка подстановочных знаков для базовых путей (PR 77)

В базовом пути прокси-сервера edgemicro_* можно использовать один или несколько подстановочных знаков "*". Например, базовый путь /team/*/members позволяет клиентам вызывать https://[host]/team/blue/members и https://[host]/team/green/members без необходимости создавать новые прокси API для поддержки новых команд. Обратите внимание, что /**/ не поддерживается.

3. В CLI добавлен пользовательский путь конфигурации для конфигурации частного облака (PR 99)

По умолчанию файл конфигурации микрошлюза находится в каталоге ./config/config.yaml. В командах init, configure и start теперь можно указать собственный путь к файлу конфигурации в командной строке с помощью флагов -c или --configDir. Устранена проблема, из-за которой не распознавался специальный каталог конфигурации для установок частного облака.

Пример:

edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config

4. Учитывать переменные *_PROXY (PR 61)

Если Edge Microgateway установлен за брандмауэром и не может взаимодействовать с Apigee Edge в общедоступном облаке, можно выбрать один из двух вариантов:

Вариант 1

Первый вариант – задать для параметра edgemicro: proxy_tunnel значение true в файле конфигурации микрошлюза:

edge_config:
   proxy: http://10.224.16.85:3128
   proxy_tunnel: true

Если для параметра proxy_tunnel задано значение true, Edge Microgateway использует метод HTTP CONNECT для туннелирования HTTP-запросов через одно TCP-подключение. (То же самое верно, если переменные среды для настройки прокси-сервера поддерживают TLS.)

Вариант 2

Второй вариант – указать прокси и задать для параметра proxy_tunnel значение false в файле конфигурации микрошлюза. Пример:

edge_config:
   proxy: http://10.224.16.85:3128
   proxy_tunnel: false

В этом случае вы можете задать следующие переменные, чтобы указать хосты для каждого HTTP-прокси, который вы хотите использовать, или хосты, которые не должны обрабатывать прокси Edge Microgateway: HTTP_PROXY, HTTPS_PROXY и NO_PROXY. Вы можете задать для параметра NO_PROXY список доменов, разделенных запятыми, для которых Edge Microgateway не должен использовать прокси. Пример:

export HTTP_PROXY='http://localhost:3786'
export HTTPS_PROXY='https://localhost:3786'

Дополнительную информацию об этих переменных можно найти в следующих статьях:

https://www.npmjs.com/package/request#controlling-proxy-behaviour-using-environment-variables

5. Задайте собственное время ожидания для целевых запросов (PR 57)

Вы можете задать собственное время ожидания для запросов целевых страниц, используя следующую конфигурацию:

edgemicro:
    request_timeout: 10

Время ожидания указывается в секундах. Если время ожидания истекает, Edge Microgateway отвечает кодом статуса 504.

6. Учитывать специальные сообщения о статусе HTTP в целевом ответе (PR 53).

Edge Microgateway учитывает специальные сообщения о статусе HTTP, заданные в целевом ответе. В предыдущих версиях сообщения о статусе, отправленные из целевого объекта, переопределялись значениями по умолчанию Node.js.

7. Заголовок X-Forwarded-For может задавать client_ip для аналитики.

Если заголовок X-Forwarded-For присутствует, он задает переменную client_ip, которая указывается в Edge Analytics. Эта функция позволяет узнать IP-адрес клиента, отправившего запрос в Edge Microgateway.

8. Изменения в плагине OAuth

Плагин OAuth поддерживает проверку ключа API и токена доступа OAuth. До этого изменения плагин принимал оба типа защиты. Теперь вы можете разрешить только одну из этих моделей безопасности (сохраняя обратную совместимость).

Плагин OAuth добавляет два новых флага:

• allowOAuthOnly – если задано значение true, каждый API должен содержать заголовок Authorization с токеном доступа на предъявителя.

• allowAPIKeyOnly – если задано значение true, каждый API должен иметь заголовок x-api-key (или специальное местоположение) с ключом API.

Эти флаги задаются в файле конфигурации Edge Microgateway следующим образом:

oauth:
    allowNoAuthorization: false
    allowInvalidAuthorization: false
    keep-authorization-header: false
    allowOAuthOnly: false
    allowAPIKeyOnly: false

9. Улучшен прокси-сервер edgemicro-auth (PR 40).

Улучшен прокси-сервер edgemicro-auth. До этих изменений прокси-сервер хранил ключи в Edge Secure Store – зашифрованном хранилище. Теперь прокси-сервер хранит ключи в зашифрованной карте "ключ-значение" (KVM) Edge.

10. Перезапись целевого URL по умолчанию в плагине (PR 74)

Вы также можете переопределить целевой порт конечной точки и выбрать протокол HTTP или HTTPS. Измените следующие переменные в коде плагина: req.targetPort и req.targetSecure. Чтобы выбрать HTTPS, задайте для параметра req.targetSecure значение true, а для HTTP – false. Если вы задали для параметра req.targetSecure значение true, ознакомьтесь с этой темой на форуме.

11. Первоначальная поддержка аутентификации с помощью токена OAuth (PR 125)

Вы можете настроить Edge Microgateway так, чтобы для аутентификации использовался токен OAuth, а не имя пользователя и пароль. Чтобы использовать токен OAuth, укажите следующий параметр в команде edgemicro configure:

-t, --token <token>

Пример:

edgemicro configure -o docs -e test -t <your token>

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

• Исправлена проблема, из-за которой для правильной работы прокси-сервера edgemicro-auth требовалась платная организация. Теперь Edge Microgateway можно использовать и в пробных организациях. (PR 5)
• Исправлена проблема, из-за которой обработка данных потока не завершалась, но обработчики завершения все равно выполнялись. Из-за этого был отправлен частичный ответ. (PR 71)
• Исправлена ошибка, из-за которой не распознавался специальный каталог конфигурации для установок частного облака. (PR 110)
• Исправлена проблема с двусторонним SSL между клиентом и Edge Microgateway. (PR 70)
• Исправлена проблема, из-за которой для правильной работы проверки ключа API в базовом пути прокси требовался косой слеш в конце. Теперь косая черта в конце базового пути не нужна. (PR 48)

Версия 2.3.5

Новые функции и улучшения версии 2.3.5

Фильтрация прокси-серверов

Вы можете настроить фильтр, чтобы экземпляр Edge Microgateway обрабатывал только определенные прокси, поддерживающие микрошлюз. При запуске Edge Microgateway скачивает все прокси, поддерживающие микрошлюз, в организации, с которой он связан. Чтобы ограничить список прокси, которые будет обрабатывать микрошлюз, используйте следующую конфигурацию: Например, следующая конфигурация ограничивает количество прокси, которые будет обрабатывать микрошлюз, тремя: edgemicro_proxy-1, edgemicro_proxy-2 и edgemicro_proxy-3:

proxies:
  - edgemicro_proxy-1
  - edgemicro_proxy-2
  - edgemicro_proxy-3

Маскировка данных Аналитики

Новая конфигурация позволяет запретить показ информации о пути запроса в аналитике Edge. Чтобы замаскировать URI запроса и/или путь запроса, добавьте в конфигурацию микрошлюза следующее: Обратите внимание, что URI состоит из имени хоста и пути запроса.

analytics:
  mask_request_uri: 'string_to_mask'
  mask_request_path: 'string_to_mask'

Версия 2.3.3

Новые функции и улучшения версии 2.3.3

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

Как отключить автоматический опрос изменений

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

disabled_config_poll_interval: true

По умолчанию периодический опрос обнаруживает любые изменения, внесенные в Edge (изменения продуктов, прокси-серверов с поддержкой микрошлюза и т. д.), а также изменения, внесенные в локальный файл конфигурации. Интервал опроса по умолчанию составляет 600 секунд (пять минут).

Перезапись целевых URL в плагинах

Вы можете динамически переопределить целевой URL по умолчанию в плагине, изменив следующие переменные в коде плагина: req.targetHostname и req.targetPath.

Новая подпись функции плагина

Добавлена новая сигнатура функции плагина, которая предоставляет целевой ответ в качестве аргумента. Благодаря этому плагинам будет проще получить доступ к целевому ответу.

function(sourceRequest, sourceResponse, targetResponse, data, cb)

Упрощенный вывод журнала по умолчанию

По умолчанию сервис ведения журналов теперь пропускает JSON скачанных прокси, продуктов и JWT. Чтобы по умолчанию выводить эти объекты, задайте значение DEBUG=* при запуске Edge Microgateway. Пример:

DEBUG=* edgemicro start -o docs -e test -k abc123 -s xyz456

В CLI добавлен специальный путь конфигурации

По умолчанию файл конфигурации микрошлюза находится в каталоге ./config/config.yaml. В командах init, configure и start теперь можно указывать собственный путь к файлу конфигурации в командной строке. Пример:

edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config

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

• Устранена утечка памяти, которая происходила при обработке больших запросов и ответов.
• Исправлен порядок выполнения плагинов. Теперь он работает так, как описано в документации.
• Плагин accumulate-request больше не зависает при GET-запросах.
• В плагине accumulate-response устранена проблема, из-за которой отсутствие тела ответа приводило к ошибкам.

Версия 2.3.1

Примечание об установке

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

npm install -g edgemicro

Подробнее об установке…

Новые функции и улучшения версии 2.3.1

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

Фильтрация прокси-серверов

Новая конфигурация позволяет фильтровать прокси, которые Edge Microgateway будет загружать при запуске. Раньше микрошлюз загружал все прокси, поддерживающие микрошлюз (прокси с именами edgemicro_*), из организации/среды Edge, указанной в команде edgemicro configure. Эта новая функция позволяет фильтровать список прокси-серверов, чтобы Edge Microgateway загружал только указанные вами. Просто добавьте элемент proxies в файл конфигурации микрошлюза, как показано ниже:

edge micro:
proxies:
    - edgemicro_[name]
    - edgemicro_[name]
    ...

Предположим, что в вашей организации/среде Edge есть 50 прокси-серверов edgemicro_*, в том числе edgemicro_foo и edgemicro_bar. Вы можете указать микрошлюзу использовать только эти два прокси-сервера следующим образом:

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

После запуска микрошлюз сможет вызывать только указанные прокси. При попытке вызвать другие прокси-серверы, поддерживающие микрошлюз и скачанные из организации или среды Edge, возникнет ошибка.

Как задать целевые заголовки запросов в плагинах

Если вы хотите добавить или изменить заголовки целевого запроса, вам нужно учитывать два основных шаблона: один для входящего запроса, содержащего данные (например, запроса POST), и один для входящего запроса, не содержащего данные (например, простого GET-запроса).

Предположим, входящий запрос содержит данные, и вы хотите задать заголовки запроса в целевом запросе. В предыдущих версиях Edge Microgateway в этом случае нельзя было надежно задать целевые заголовки.

Ключевой момент в этом шаблоне – сначала собрать все входящие данные от клиента. Затем в функции onend_request() используйте новую функцию request.setOverrideHeader(name, value), чтобы настроить заголовки.

Ниже приведен пример кода плагина, в котором показано, как это сделать. Заголовки, заданные в onend_request, отправляются в целевой объект:

module.exports.init = function(config, logger, stats) {


  function accumulate(req, data) {
    if (!req._chunks) req._chunks = [];
    req._chunks.push(data);
  }

  return {

    ondata_request: function(req, res, data, next) {
      if (data && data.length > 0) accumulate(req, data);
      next(null, null);
    },

    onend_request: function(req, res, data, next) {
      if (data && data.length > 0) accumulate(req, data);
      var content = Buffer.concat(req._chunks);
      delete req._chunks;
      req.setOverrideHeader('foo', 'bar');
      req.setOverrideHeader('content-length', content.length);
      next(null, content);
    },


    onerror_request: function(req, res, data, next) {
      next(null, null);
    }

  };

}

Если запрос не содержит данных, вы можете задать целевые заголовки в обработчике onrequest(). Этот шаблон не новый. Он был описан ранее и использовался в примерах плагинов, поставляемых с Edge Microgateway.

onrequest: function(req, res, next) {
      debug('plugin onrequest');
      req.headers['x-foo-request-id'] = "bar";
      req.headers['x-foo-request-start'] = Date.now();
      next();
    }

Функция перезагрузки без простоя

После изменения конфигурации Edge Microgateway вы можете загрузить конфигурацию, не теряя сообщений. Теперь Edge Microgateway всегда запускается в режиме кластера, а параметр --cluster удален из команды edgemicro start.

Кроме того, добавлены три новые команды CLI. Выполнять эти команды нужно из того же каталога, в котором была запущена команда edgemicro start:

• edgemicro status – проверяет, запущен ли Edge Microgateway.
• edgemicro stop – останавливает кластер Edge Microgateway.
• edgemicro reload – перезагружает конфигурацию Edge Microgateway без простоя.

Автоматическая перезагрузка конфигурации без простоев

Edge Microgateway периодически загружает новую конфигурацию и выполняет перезагрузку, если что-то изменилось. При опросе учитываются все изменения, внесенные в Edge (в продукты, прокси, поддерживающие микрошлюз, и т. д.), а также изменения, внесенные в локальный файл конфигурации. Интервал опроса по умолчанию составляет 600 секунд (пять минут). Вы можете изменить значение по умолчанию в файле конфигурации микрошлюза следующим образом:

edgemicro:
    config_change_poll_interval: [seconds]

Добавлена информация о версии в интерфейс командной строки

В интерфейс командной строки добавлен флаг --version. Чтобы узнать текущую версию Edge Microgateway, используйте следующую команду:

edgemicro --version

Новые параметры SSL для сервера Edge Microgateway

Теперь Edge Microgateway поддерживает следующие варианты SSL-сервера в дополнение к key и cert:

Отправка файлов журнала в stdout

Вы можете отправлять данные журнала в стандартный вывод с помощью нового параметра конфигурации:

edgemicro:
  logging:
    to_console: true

Подробнее об управлении файлами журналов…

Версия 2.1.2

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

Разрешить использование пользовательской конечной точки API для конфигурации

Для прокси-сервера авторизации добавлены новые настраиваемые конечные точки, поддерживающие использование специального сервиса авторизации. Вот эти конечные точки:

• edgeconfig:verify_api_key_url
• edgeconfig:products

Подробнее об использовании настраиваемого сервиса аутентификации…

Версия 2.1.1

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

Развертывание кроссплатформенного прокси-сервера аутентификации

Команда, используемая для развертывания прокси-сервера авторизации Edge Microgateway в Edge, теперь совместима с системами Windows.

Версия 2.1.0

Новые функции и улучшения версии 21.0

Ниже перечислены новые функции и улучшения.

Как задать параметры SSL/TLS клиента

Вы можете указать параметры клиента для подключений SSL/TSL к целевым объектам, используя новый набор параметров конфигурации. Подробнее о параметрах клиента SSL/TLS…

Версия 2.0.11

Примечание об установке версии 2.0.11

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

npm install -g edgemicro

Подробнее об установке…

Новые функции и улучшения в версии 2.0.11

Ниже перечислены новые функции и улучшения.

Как указать порт при запуске

Команда start позволяет указать номер порта, который будет использоваться вместо номера, заданного в файле конфигурации. Вы также можете указать номер порта с помощью переменной среды PORT. Подробную информацию можно найти в разделе Команда запуска.

Как сохранить заголовки авторизации (необязательно)

Новый параметр конфигурации keepAuthHeader позволяет сохранить заголовок Authorization, отправленный в запросе. Если задано значение true, заголовок Auth передается целевому объекту. Подробнее об атрибутах OAuth…

Возможность использовать настраиваемый сервис авторизации

Если вы хотите использовать для аутентификации собственный сервис, измените значение authUri в файле конфигурации Edge Microgateway, чтобы оно указывало на ваш сервис. Подробнее о том, как использовать настраиваемый сервис аутентификации…

Версия 2.0.4

Версия Edge Microgateway 2.0.4 была выпущена 25 мая 2016 г.

Новые функции и улучшения в версии 2.0.4

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

Поддержка путей к ресурсам в продуктах

Edge Microgateway теперь поддерживает пути к ресурсам в продуктах. Пути к ресурсам позволяют ограничить доступ к API на основе суффикса пути прокси-сервера. Подробнее о том, как создавать продукты API и настраивать пути к ресурсам…

Поддержка глобальной установки npm

Теперь Edge Microgateway можно установить с помощью параметра npm -g (глобальный). Подробную информацию об этом варианте можно найти в документации npm.

Версия 2.0.0

Версия Edge Microgateway 2.0.0 была выпущена 18 апреля 2016 г.

Новые функции и улучшения в версии 2.0.0

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

Сервер с одним процессом

Edge Microgateway теперь представляет собой сервер с одним процессом. В нем больше не используется модель с двумя процессами, где один процесс (ранее известный как агент) запускает Edge Microgateway, а второй процесс. Новая архитектура упрощает автоматизацию и контейнеризацию.

Файлы конфигурации с пространством имен

Файлы конфигурации теперь используют пространства имен организации и среды, поэтому на одном хосте можно запустить несколько экземпляров Microgateway. Файлы конфигурации можно найти в каталоге ~/.edgemicro после выполнения команды конфигурации Edge Microgateway.

Новые переменные среды

Теперь есть четыре переменные среды: EDGEMICRO_ORG, EDGEMICRO_ENV, EDGEMICRO_KEY и EDGEMICRO_SECRET. Если вы задали эти переменные в своей системе, вам не нужно указывать их значения при использовании интерфейса командной строки (CLI) для настройки и запуска Edge Microgateway.

Кэшированная конфигурация

Edge Microgateway использует файл конфигурации из кеша, если перезапускается без подключения к Apigee Edge .

Режим кластеризации

Теперь Edge Microgateway можно запускать в режиме кластера. Кластерный режим позволяет использовать многоядерные системы. Для этой функции микрошлюз использует модуль кластера Node.js. Подробную информацию можно найти в документации по Node.js.

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

Жизненный цикл событий плагина теперь правильно обрабатывает асинхронный код, содержащий код с новым обратным вызовом.

Версия 1.1.2

Версия Edge Microgateway 1.1.2 была выпущена 14 марта 2016 г.

Новые функции и улучшения версии 1.1.2

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

Повышение эффективности

Теперь Edge Microgateway правильно использует HTTP-агент Node.js для более эффективного объединения подключений. Это улучшение повышает производительность и стабильность при высокой нагрузке.

Поддержка удаленной отладки

Вы можете настроить Edge Microgateway для работы с удаленным отладчиком, например node-inspector.

Новое местоположение файла конфигурации

При настройке Edge Microgateway файл agent/config/default.yaml теперь копируется в ~./edgemicro/config.yaml.

Ротация файлов журналов

Новый атрибут конфигурации позволяет задать интервал ротации журналов Edge Microgateway.

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

В версии 1.1.2 исправлены следующие ошибки: