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

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

Версия 3.3.х

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

3.3.4

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

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

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

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

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

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

3.3.3

25 апреля 2024 г. мы выпустили следующие исправления и улучшения для 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 г. мы выпустили следующие исправления и улучшения для Edge Microgateway.

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

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

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

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

Никто.

3.3.1

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

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

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

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

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

3.3.0

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

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

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

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

npm install apigeetool@0.15.1

Версия 3.2.х

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

3.2.3

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

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

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

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

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

3.2.2

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

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

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

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

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

3.2.1

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

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

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

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

edgemicro:
 enable_GET_req_body: true

3.2.0

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

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

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

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

Версия 3.1.х

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

3.1.8

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

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

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

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

3.1.7

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

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

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

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

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

3.1.6

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

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

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

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

3.1.5

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

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

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

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

3.1.4

В пятницу, 23 апреля 2020 года, мы выпустили следующее исправление для Edge Microgateway.

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

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

3.1.3

В среду, 15 апреля 2020 года, мы выпустили следующие исправления и усовершенствования для Edge Microgateway.

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

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

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

• 153509313 - Проблема была исправлена, когда модуль отладки Node.js приводит к утечкам памяти. Проблема существует в версии V3.1.0, V3.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 года, мы выпустили следующие исправления и усовершенствования для Edge Microgateway.

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

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

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

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

3.1.1

В четверг, 20 февраля, мы выпустили следующие исправления и усовершенствования для 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 января, мы выпустили следующие исправления и усовершенствования для Edge Microgateway.

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

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

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

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

  Например:

  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, отправляемые в Microgateway, не влияют.
• 146378327 - Уровень журнала sourceRequest , targetRequest и targetResponse был изменен на информационный уровень.
• 146019878 - Расхождение между задержкой, которая была рассчитана для «производительности API -прокси» в аналитике Edge и Edge Microgateway SourcerSponse/TargetResponse Events был фиксирован. Теперь задержка в Edge Analytics и события журнала Microgateway выровнены.
• Изменения логики, связанные с подходящим шаблоном:
  • 147027862 - плагин OAuth был обновлен, чтобы поддержать следующие шаблоны соответствия пути ресурса, как указано в продуктах API:
    • /{literal}**
    • /{literal}*
    • Любая комбинация из двух шаблонов

    С этим изменением плагин Edge Microgateway теперь следует тому же, что и Apigee Edge, как объяснено при настройке поведения пути ресурса '/', '/*' и '/**' .

  • 145644205 - Обновление схемы соответствия плагина Apikeys в соответствии с плагином OAuth.
• 143488312 - Проблема была решена, когда ведущие или следственные места в параметре идентификатора клиента привели к тому, что создание списка продуктов JWT было пустым для запросов на токен OAuth и API.
• 145640807 и 147579179 - была добавлена ​​новая функция, которая позволяет специальному экземпляру Microgateway, называемому «синхронизатор» для извлечения данных конфигурации от Apigee Edge и записать его в локальную базу данных REDIS. Другие экземпляры Microgateway могут затем быть настроены для чтения данных их конфигурации из базы данных. Эта функция добавляет уровень устойчивости к Edge Microgateway. Это позволяет экземплярам Microgateway запускаться и функционировать без необходимости общения с Apigee Edge. Для получения подробной информации см. Использование синхронизатора .

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

Версия 3.0.x

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

3.0.10

В пятницу, 8 ноября, мы выпустили следующие исправления и усовершенствования для Edge Microgateway.

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

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

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

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

  ПРИМЕЧАНИЕ. Если вы используете шаблон составного ресурса, такой как /*/2/** , вы должны убедиться, что прокси edgemicro_auth добавляется в автономный продукт API. Затем вы должны включить этот продукт в приложение Developer Proxy, как показано на следующем скриншоте:

  

  ПРИМЕЧАНИЕ. features.isSingleForwardSlashBlockingEnabled .

• 143740696 - Структура конфигурации quotas изменилась (см. Также заметки о выпуске для версии 3.0.9). Свойство quotas используется для настройки плагина квот. Изменение в структуре было внесено для улучшения ясности элементов конфигурации. Чтобы настроить плагин Quata, используйте следующую конфигурацию 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 верен, то используемый модуль Volos-quota-redis . Когда это правда, квота ограничена только тем экземплярами Microgateway, которые соединяются с Redis. Если False, модуль Volos-quota-apigee используется в качестве хранилища поддержки, а счетчик квоты является глобальным. Подробнее см. Параметры конфигурации для квоты . Например:

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

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

3.0.9

В пятницу, 11 октября, мы выпустили следующие исправления и усовершенствования для 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 , чтобы предотвратить переполнения квот. Изменение состоит в том, чтобы установить тип квоты в календарь . Чтобы использовать это улучшение, вы должны обновить свой edgemicro-auth до версии 3.0.7 или выше.
• 142520568 - Была добавлена ​​новая функция, чтобы включить регистрацию идентификатора MP (процессор сообщений) в ответах квот. Чтобы использовать эту функцию, вы должны обновить свой прокси-сервер edgemicro-auth для версии 3.0.7 или выше и установить следующую конфигурацию:

  quotas:
    useDebugMpId: true

  При установке useDebugMpId ответы квот от Edge будут содержать MP ID и будут регистрироваться Edge Microgateway. Например:

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

3.0.8

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

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

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

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

• 140025210 - была добавлена ​​новая функция «Fail Open». Эта функция позволяет обработке API продолжаться, если истекший токен JWT не может быть обновлен из-за ошибки подключения, которая предотвращает успешный вызов проверки ключа API для прокси-сервера edgemicro-auth .

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

  Чтобы настроить новую функцию «Fail Open», сделайте следующее:

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

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

     Например:

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

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

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

3.0.7

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

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

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

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

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

  Эта функция отключена по умолчанию. Чтобы включить эту функцию, добавьте oauth.useUpstreamResponse: true Product в вашу конфигурацию Microgateway. Например:

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

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

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

  В выпуске 3.0.7 edgemicro-auth был обновлен, чтобы принять эту новую конфигурацию. Чтобы использовать свойство quotaUri , вы должны перейти на последний прокси-прокси edgemicro-auth . Для получения подробной информации см. Обновление прокси Edgemicro-Auth .

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

  edgemicro:
      keepAliveTimeout

  был задокументирован неправильно в выпуске 3.0.6. Правильное название свойства:

  edgemicro:
      keep_alive_timeout

• 139526406 - Была исправлена ​​ошибка, когда произошло неверное количество квот, если приложение разработчика имело несколько продуктов. Квота теперь правильно соблюдается для каждого продукта в приложении с несколькими продуктами. Комбинация «appname + productName» используется в качестве идентификатора квоты.

3.0.6

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

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

  Например:

  edgemicro:
    keep_alive_timeout: 600

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

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

  Чтобы использовать эту функцию, вы должны сначала развернуть последнюю версию edgemicro-auth Proxy в вашу организацию. Для получения подробной информации см. Обновление прокси Edgemicro-Auth .

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

  stack_trace: false

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

3.0.5

В четверг, 15 августа, мы выпустили следующие исправления и усовершенствования для Edge Microgateway.

• 139005279 - Проблема была исправлена, когда команда edgemicro status не вернула правильное количество рабочих процессов.
• 138437710 - Проблема была исправлена ​​в классе EdicitCounter, который предотвратил написание надлежащего журнала.

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

• 138413755 - Улучшение клавиш JWT и секретные сообщения журнала для этих команд CLI: CERT, проверка, обновленияквм, токен, генки, RevokeKeys, RotateKey и Configure.

• 138413577 - Добавьте и улучшайте обработку ошибок для тайм -аутов на бэкэнд.
• 138413303 - Добавьте и улучшайте обработку ошибок для тайм -аутов с откликом и розеткой.
• 138414116 - Добавить и улучшить обработку ошибок для ошибок «подключение».

3.0.4

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

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

3.0.3

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

• Усовершенствования журнала : существующие журналы времени выполнения используют новую функцию eventLog() , которая захватывает и регистрирует данные времени выполнения в постоянном формате. Информация о журнале включает в себя:
  • TimeStamp (ISO 8601: yyyy-mm-ddthh: mm: ss.sssz).
  • Уровень журнала (ошибка, предупреждение или информация).
  • Имя хоста - запрашивающее имя хоста из заголовка запроса.
  • Идентификатор процесса - если вы запускаете кластер процессов node.js, это идентификатор процесса, где произошло ведение журнала.
  • Название организации Apigee.
  • Название среды в организации.
  • API Proxy Name.
  • IP -адрес клиента.
  • ClientId.
  • Идентификатор корреляции (не установлен в настоящее время).
  • Edge Microgateway имя компонента.
  • Пользовательское сообщение - Некоторые объекты могут распечатать дополнительную информацию, которая передается в это свойство ошибки.
  • Метод запроса (если HTTP -запрос).
  • Код состояния ответа (если HTTP -запрос).
  • Сообщение об ошибке.
  • Код ошибки - если объект включает код ошибки, он напечатан в этом свойстве.
  • Время взято.
  • Операционная система конец линейного маркера.

  Новые значения свойства приводят к пустым кронштейнам, [] .

  В следующем примере показан формат журнала:

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

  (137770055)

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

3.0.2

В среду, 3 июля 2019 года, мы выпустили следующие исправления и усовершенствования для Edge Microgateway.

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

3.0.1

В пятницу, 21 июня 2019 года, мы выпустили следующие исправления и усовершенствования для Edge Microgateway.

• 134834551 - Измените поддерживаемые версии Node.js для Edge Microgateway
  (Node.js Поддерживаемые версии: 8 и 12; версии 7, 9 и 11 экспериментальны)
• 134751883 - Edge Microgateway сбои при перезарядке под нагрузкой
• 134518428 - Конечная точка продуктов для Edge Microgateway возвращает 5xx, если рисунок фильтра неверна
• 135113408 - Работники должны перезапустить, если они неожиданно прекратятся
• 134945852 - TokenCachesize не используется в плагине OAuth
• 134947757 - Установите Cachettl в плагине OAuth
• 135445171 - Расчет Graceperiod в OAuth неверен
• Используйте модуль, предоставленное с установкой Edge Microgateway
• 135367906 - Аудит безопасности

Версия 2.5.x

Новые функции и усовершенствования v.2.5.x

(Исправлено 2.5.38, 07/07/2019)

Неправильно отформатированные JWT могут привести к разбиту работников при использовании кеша токена. Исправлена ​​в модуле края микрогейвей-плугинса. (B/134672029)

(Добавлено 2.5.37) Добавьте опцию CLI 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) Новый Edgemicro-Auth/Token API

Был добавлен новый API Edgemicro-Auth/Token, который позволяет вам передавать клиент/секрет в качестве базового 64-кодируемого основного заголовка авторизации и Grant_type в качестве параметра формы. См . Получив токены носителя напрямую .

(Исправлена ​​2.5.31) Частная конфигурация не уважает токен.

Была решена проблема, когда настройка Edge Microgateway для использования токена доступа OAuth2 на краю для частного облака не работала должным образом (токен не был уважаемым).

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

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

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

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

Следующие примеры подробно объясняют, как настроить эти конфигурации TLS:

• Пример конфигурации TLS на север
• Пример конфигурации TLS на юг

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

Docker: Поддержка для прокси -запроса

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

• HTTP_PROXY
• HTTPS_PROXY
• NO_PROXY

Для получения подробной информации см. Run Edge Micro как контейнер Docker .

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

(Добавлено 2.5.27) Если вы запускаете Edge Microgateway в контейнере Docker, теперь у вас есть два варианта развертывания плагинов. Один из вариантов, используя точку монтирования Docker, является новым. Другой вариант существовал ранее, в основном не изменился; Тем не менее, DockerFile был обновлен. Для получения подробной информации обратитесь к следующим ссылкам:

• Вариант A: Установите каталог плагинов на томе (новый)
• Вариант B: Постройте плагины в контейнер (обновляется)

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

(Добавлено 2.5.27) Вы можете использовать токен OAuth с командой upgradekvm . Для получения подробной информации см. Обновление KVM .

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

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

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

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

Используя автономный режим

(Добавлено 2.5.25) Вы можете запустить Edge Microgateway полностью отключенным от любой зависимости от краев Apigee. Этот сценарий, называемый автономным режимом, позволяет запустить и проверять 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) Новая настройка конфигурации, nodelay , была добавлена ​​в краевую микро -конфигурацию.

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

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

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

Новые варианты CLI для вечного мониторинга

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

Примеры:

Начать навсегда:

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

Чтобы остановиться навсегда:

edgemicro forever -a stop

Jwt Key rowation

Была добавлена ​​новая функция, которая позволяет поворачивать пары публичных/частных ключей, используемые для генерации токенов JWT, используемых для безопасности OAuth On 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, которая управляет программно навсегда. Смотрите навсегда мониторинг .

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

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

Поддержка опции Forever CLI

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

Например:

edgemicro forever ~/mydir/forever.json

Добавление параметра Configurl для перезагрузки

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

Период ГРЕССИЯ ДЛЯ ДЕЙСТВИЯ ВРЕМЕНИ ВРЕМЕНИ

(Added 2.5.7) A gracePeriod attribute in OAuth configuration helps prevent errors caused by slight discrepancies between your system clock and the Not Before (nbf) or Issued At (iat) times specified in the JWT authorization token. Set this attribute to the number of seconds to allow for such discrepancies. See OAuth attributes .

(Added 2.5.7) A gracePeriod attribute in OAuth configuration helps prevent errors caused by slight discrepancies between your system clock and the Not Before (nbf) or Issued At (iat) times specified in the JWT authorization token. Set this attribute to the number of seconds to allow for such discrepancies. See OAuth attributes .

Bugs fixed v2.5.x

• (Issue #236) Fix typo in clearing the cache.
• (Issue #234) Reload crashes for Edge Microgateway 2.5.35.
• (Issue #135) Invalid virtual host reference "secure" error when using the -v option. This fix modifies the edgemicro-auth proxy before deployment to ensure the virtual hosts match exactly what is specified in the "-v" flag. In addition, you can specify any number of and any name for the virtual host (no longer restricted to default and secure).
• (Issue #141) The edgemicro reload command does not support the configuration file option -c . This issue has been fixed.
• (Issue #142) Edge Microgateway complains about deprecated crypto at install time. This issue has been fixed.
• (Issue #145) Quota not working with Edge Microgateway. This issue has been fixed.
• (Apigee Community issue: https://community.apigee.com/questions/33149/emg-jwt-token-validated-against-both-api-proxies-a.html#answer-33336 ) JWT token validated against both API Proxies and Resource URI in OAUTH. This issue has been fixed.
• (Apigee Community issue: https://community.apigee.com/questions/47846/microgateway-not-working-with-oauth.html ) Microgateway not working with OAuth. This issue has been fixed.
• Fix pidPath on Windows.
• (Issue #157) Problem that caused the following error message has been fixed: ReferenceError: deployProxyWithPassword is not defined.
• (Issue #169) Update Node.js dependencies (npm audit)
• The edgemicro-auth proxy now uses the Edge JWT policies. The proxy no longer depends on Node.js to provide JWT support.

Version 2.4.x

New features and enhancements v.2.4.x

1. Set a custom alias for the edgemicro-auth proxy (PR 116)

You can change the default basepath for the edgemicro-auth proxy. By default, the basepath is /edgemicro-auth . To change it, use the -x flag on the edgemicro configure command.

Пример:

edgemicro configure -x /mypath …

2. Wildcard support for base paths (PR 77)

You can use one or more " * " wildcards in the base path of an edgemicro_* proxy. For example, a base path of /team/*/members allows clients to call https://[host]/team/blue/members and https://[host]/team/green/members without you needing to create new API proxies to support new teams. Note that /**/ is not supported.

3. Custom config path added to CLI for Private Cloud configuration (PR 99)

By default, the microgateway configuration file is in ./config/config.yaml . On the init, configure, and start commands, you can now specify a custom config path on the command line using the -c or --configDir flags. Fixed an issue where a custom config directory for Private Cloud installations was not recognized.

Пример:

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

4. Respect *_PROXY variables (PR 61)

If Edge Microgateway is installed behind a firewall and is not able to communicate with Apigee Edge in the public cloud, there are two options to consider:

Option 1:

The first option is to set the edgemicro: proxy_tunnel option to true in the microgateway config file:

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

When proxy_tunnel is true , Edge Microgateway uses the HTTP CONNECT method to tunnel HTTP requests over a single TCP connection. (The same is true if the environment variables for configuring the proxy are TLS enabled).

Option 2:

The second option is to specify a proxy and set proxy_tunnel to false in the microgateway config file. Например:

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

In this case, you can set the following variables to control the hosts for each HTTP proxy that you wish to use, or which hosts should not handle Edge Microgateway proxies: HTTP_PROXY , HTTPS_PROXY , and NO_PROXY . You can set NO_PROXY as a comma delimited list of domains that Edge Microgateway should not proxy to. Например:

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

For more information on these variables, see:

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

5. Set a custom timeout for target requests (PR 57)

You can set a custom timeout for target requests with this configuration:

edgemicro:
    request_timeout: 10

The timeout is set in seconds. If a timeout occurs, Edge Microgateway responds with a 504 status code.

6. Respect custom HTTP status messages on the target response (PR 53)

Edge Microgateway respects custom HTTP status messages set on the target response. In previous releases, status messages sent from the target were overridden with Node.js defaults.

7. The X-Forwarded-For header can set the client_ip for analytics

If present, the X-Forwarded-For header will set the client_ip variable that is reported in Edge Analytics. This feature lets you know the IP of the client that sent a request to Edge Microgateway.

8. OAuth plugin changes

The OAuth plugin supports API Key verification and OAuth access token verification. Before this change, the plugin accepted either form of security. With this change, you can allow only one of those security models (while maintaining backward compatibility).

The OAuth plugins adds two new flags:

• allowOAuthOnly -- If set to true , every API must carry an Authorization header with a Bearer Access Token.

• allowAPIKeyOnly -- If set to true , every API must carry an x-api-key header (or a custom location) with an API Key.

You set these flags in the Edge Microgateway configuration file like this:

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

9. Improved the edgemicro-auth proxy (PR 40)

Improvements have been made to the edgemicro-auth proxy. Before these changes, the proxy stored keys in the Edge Secure Store, an encrypted vault. Now, the proxy stores keys in Edge's encrypted key-value map (KVM).

10. Rewriting default target URL in a plugin (PR 74)

You can also override the target endpoint port and choose between HTTP and HTTPS. Modify these variables in your plugin code: req.targetPort and req.targetSecure . To choose HTTPS, set req.targetSecure to true ; for HTTP, set it to false . If you set req.targetSecure to true, see this discussion thread for more information.

11. Initial support for OAuth token authentication (PR 125)

You can configure Edge Microgateway to use an OAuth token for authentication instead of username/password. To use an OAuth token, use the following parameter on the edgemicro configure command:

-t, --token <token>

Например:

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

Bugs fixed v2.4.3

• Fixed an issue where a paid org was required to properly run the edgemicro-auth proxy. Now, you can use Edge Microgateway with trial orgs as well. (PR 5)
• Fixed an issue where the stream was not finished processing data, but end handlers were executing anyway. This caused a partial response to be sent. (PR 71)
• Fixed an issue where a custom config directory for Private Cloud installations was not recognized. (PR 110)
• Fixed an issue with bi-directional SSL between the client and Edge Microgateway. (PR 70)
• Fixed an issue where a trailing slash was required on the proxy basepath for API key verification to workk properly. Now, a trailing slash is not needed at the end of the basepath. (PR 48)

Version 2.3.5

New features and enhancements v.2.3.5

Proxy filtering

You can filter which microgateway-aware proxies an Edge Microgateway instance will process. When Edge Microgateway starts, it downloads all of the microgateway-aware proxies in the organization it's associated with. Use the following configuration to limit which proxies the microgateway will process. For example, this configuration limits the proxies the microgateway will process to three: edgemicro_proxy-1 , edgemicro_proxy-2 , and edgemicro_proxy-3 :

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

Analytics data masking

A new configuration lets you prevent request path information from showing up in Edge analytics. Add the following to the microgateway configuration to mask the request URI and/or request path. Note that the URI consists of the hostname and path parts of the request.

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

Version 2.3.3

New features and enhancements v.2.3.3

Following are the new features and enhancements for this release.

Disable automatic change polling

You can turn off automatic change polling by setting this attribute in the microgateway config:

disabled_config_poll_interval: true

By default, periodic polling picks up any changes made on Edge (changes to products, microgateway-aware proxies, etc) as well as changes made to the local config file. The default polling interval is 600 seconds (five minutes).

Rewriting target URLs in plugins

You can override the default target URL dynamically in a plugin by modifying these variables in your plugin code: req.targetHostname and req.targetPath .

New plugin function signature

A new plugin function signature has been added that provides the target response as an argument. This addition makes it easier for plugins to access the target response.

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

Simplified default logging output

By default, the logging service now omits the JSON of downloaded proxies, products, and JWT. You can change to default to output these objects by setting DEBUG=* when you start Edge Microgateway. Например:

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

Custom config path added to CLI

By default, the microgateway configuration file is in ./config/config.yaml. On the init, configure, and start commands, you can now specify a custom config path on the command line. Например:

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

Bugs fixed v2.3.3

• A memory leak was fixed that occurred during large request/responses.
• Plugin execution order was fixed. It now behaves the way it is explained in the documentation.
• The plugin accumulate-request plugin no longer hangs for GET requests.
• An issue was fixed in the accumulate-response plugin where a lack of response body caused errors.

Release 2.3.1

Installation note

Some previous versions of Edge Microgateway let you install the software by downloading a ZIP file. These ZIP files are no longer supported. To install Edge Microgateway, you must use:

npm install -g edgemicro

Refer to the installation topic for more details.

New features and enhancements v.2.3.1

Following are the new features and enhancements for this release.

Filter proxies

A new configuration lets you filter which proxies that Edge Microgateway will load upon startup. Previously, the microgateway loaded all microgateway-aware proxies (proxies named edgemicro_*) pulled from the Edge organization/environment that you specified in the edgemicro configure command. This new feature lets you filter this list of proxies so that Edge Microgateway only loads the ones you specify. Simply add the proxies element to the microgateway config file like this:

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

For example, let's say you have 50 edgemicro_* proxies in your Edge org/env, including ones named edgemicro_foo and edgemicro_bar . You can tell the microgateway to use only these two proxies like this:

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

Upon startup, the microgateway will only be able to call the specified proxies. Any attempts to call other microgateway-aware proxies downloaded from the Edge organization/environment will result in an error.

Set target request headers in plugins

There are two basic patterns to consider if you want to add or modify target request headers: one where the incoming request contains data (as in a POST request) and one where it does not (as in a simple GET request).

Let's consider a case where the incoming request contains data, and you want to set request headers on the target request. In previous versions of Edge Microgateway, it was not possible to set target headers reliably in this case.

The key to this pattern is to first accumulate all incoming data from the client. Then, in the onend_request() function, use the new function request.setOverrideHeader(name, value) to customize the headers.

Here is sample plugin code showing how to do this. The headers set in onend_request are sent to the target:

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);
    }

  };

}

If the request does not include data, then you can set target headers in the onrequest() handler. This pattern is not new -- it has been documented previously and has been used in the sample plugins provided with 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();
    }

Zero-downtime reload feature

After making a configuration change to Edge Microgateway, you can load the configuration without dropping any messages. With this change, Edge Microgateway always starts in cluster mode, and he --cluster option has been removed from the edgemicro start command.

In addition, three new CLI commands have been added. You must run these commands from the same directory where the edgemicro start command was executed:

• edgemicro status - Checks to see if the Edge Microgateway is running or not.
• edgemicro stop - Stops the Edge Microgateway cluster.
• edgemicro reload - Reloads the Edge Microgateway configuration with no downtime.

Automatic config reload with zero downtime

Edge Microgateway loads a new configuration periodically and executes a reload if anything changed. The polling picks up any changes made on Edge (changes to products, microgateway-aware proxies, etc) as well as changes made to the local config file. The default polling interval is 600 seconds (five minutes). You can change the default in the microgateway config file as follows:

edgemicro:
    config_change_poll_interval: [seconds]

Added version information to CLI

A --version flag was added to the CLI. To get the current version of Edge Microgateway, use:

edgemicro --version

New Edge Microgateway server SSL options

Edge Microgateway now supports the following server SSL options in addition to key and cert :

Send log files to stdout

You can send log data to standard output with a new configuration setting:

edgemicro:
  logging:
    to_console: true  

See Managing log files .

Version 2.1.2

Following are the new features and enhancements for this release.

Allow custom API endpoint for configuration

There are new configurable endpoints for the authorization proxy that support the use of a custom auth service. These endpoints are:

• edgeconfig:verify_api_key_url
• edgeconfig:products

For details, see Using a custom auth service .

Version 2.1.1

Following are the new features and enhancements for this release.

Deploy auth proxy cross-platform compatible

An enhancement was made so that the command used to deploy the Edge Microgateway authorization proxy to Edge is compatible on Windows systems.

Version 2.1.0

New features and enhancements v.21.0

Following are the new features and enhancements:

Specify client SSL/TLS options

You can specify client options for SSL/TSL connections to targets using a new set of config options. See Using client SSL/TSL options .

Version 2.0.11

Installation note v2.0.11

Some previous versions of Edge Microgateway let you install the software by downloading a ZIP file. These ZIP files are no longer supported. To install Edge Microgateway, you must use:

npm install -g edgemicro

Refer to the installation topic for more details.

New features and enhancements v.2.0.11

Following are the new features and enhancements:

Specify a port on startup

The start command lets you specify a port number to override the port specified in the configuration file. You can also specify a port number using the PORT environment variable. See start command for details.

Optionally preserve auth headers

A new configuration setting, keepAuthHeader , lets you preserve the Authorization header sent in the request. If set to true, the Auth header is passed on to the target. See oauth attributes .

Ability to use a custom authorization service

If you want to use your own custom service to handle authentication, change the authUri value in the Edge Microgateway config file to point to your service. For details, see Using a custom auth service .

Version 2.0.4

Edge Microgateway v.2.0.4 was released on May 25, 2016.

New features and enhancements v2.0.4

Following are the new features and enhancements in this release.

Support for resource paths in products

Edge Microgateway now supports resource paths in products. Resource paths let you restrict access to APIs based on the proxy path suffix. For details on creating products and configuring resource paths, see Create API products .

Support for npm global install

You can now install Edge Microgateway using the npm -g (global) option. For details on this option refer to the npm documentation .

Version 2.0.0

Edge Microgateway v2.0.0 was released on April 18, 2016.

New features and enhancements v.2.0.0

Following are the new features and enhancements in this release.

Single process server

Edge Microgateway is now a single process server. It no longer uses a two process model where one process (previously known as the "agent") launches Edge Microgateway, the second process. The new architecture makes automation and containerization easier.

Namespaced configuration files

Configuration files now are namespaced using organization and environment so that multiple Microgateway instances can run on the same host. You can find the config files in ~/.edgemicro after you run the Edge Microgateway config command.

New environment variables

There are now 4 environment variables: EDGEMICRO_ORG, EDGEMICRO_ENV, EDGEMICRO_KEY, EDGEMICRO_SECRET. If you set these variables on your system, you do not have to specify their values when you use the Command-Line Interface (CLI) to configure and start Edge Microgateway.

Cached configuration

Edge Microgateway uses a cached configuration file if it restarts with no connection to Apigee Edge.

Cluster mode

There are now options to start Edge Microgateway in cluster mode. Cluster mode allows you to take advantage of multi-core systems. The microgateway employs the Node.js cluster module for this feature. For details, see the Node.js documentation.

Bugs fixed v2.0.0

Plugin event lifecycle now properly handles async code that contains code with a new callback.

Version 1.1.2

Edge Microgateway v. 1.1.2 was released on March 14, 2016.

New features and enhancements v.1.1.2

Following are the new features and enhancements in this release.

Performance Improvement

Edge Microgateway now uses the Node.js HTTP agent properly for better connection pooling. This enhancement improves performance and overall stability under high load.

Remote debugger support

You can configure Edge Microgateway to run with a remote debugger, like node-inspector .

New config file location

When you configure Edge Microgateway, the agent/config/default.yaml file is now copied to ~./edgemicro/config.yaml .

Log file rotatio n

A new config attribute lets you specify a rotation interval for Edge Microgateway logs.

Bugs fixed v1.1.2

The following bugs are fixed in v. 1.1.2.