Edge Microgateway リリースノート

Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントに移動します。
info

バージョン 3.3.x

バグの修正と機能強化 v.3.3.x

3.3.12

2026 年 11 月 4 日、Apigee は Edge Microgateway に次の修正をリリースしました。

コンポーネントのバージョン

次の表に、Edge Microgateway 3.3.12 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway plugins edgeauth
3.3.12 3.3.9 3.2.2

修正されたセキュリティの問題

3.3.11

2026 年 8 月 19 日 - Docker コンテナ イメージの更新(タグ: 3.3.11-sec.1)

2026 年 8 月 19 日、Apigee は Edge Microgateway の以下の修正と機能強化をリリースしました。

コンテナの更新:

問題 ID タイプ 説明
541758106 拡張機能

Edge Microgateway Docker コンテナ イメージが、アップグレードされたベースイメージ node:24.18.1-trixie-slim を使用して再ビルドされました。

Docker コンテナの更新で修正されたセキュリティの問題


2026 年 7 月 1 日 - 初回リリース

2026 年 7 月 1 日、Apigee は Edge Microgateway 3.3.11 に次の修正をリリースしました。

コンポーネントのバージョン

次の表に、Edge Microgateway 3.3.11 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway plugins edgeauth
3.3.11 3.3.9 3.2.2

修正されたセキュリティの問題

3.3.10

2026 年 5 月 27 日、Apigee は Edge Microgateway に次の修正をリリースしました。

コンポーネントのバージョン

次の表に、Edge Microgateway 3.3.10 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway plugins edgeauth
3.3.10 3.3.9 3.2.2

修正されたセキュリティの問題

3.3.9

2026 年 4 月 1 日、Apigee は Edge Microgateway の次の修正と機能強化をリリースしました。

バグの修正と機能強化:

問題 ID タイプ 説明
466417342 バグ

コントロール プレーンのメンテナンス中の復元力の向上 Apigee ZooKeeper のメンテナンスの時間枠中に Edge Microgateway インスタンスでランタイムの停止(404 エラーや再起動など)が発生する可能性がある問題を修正しました。EMG がコントロール プレーンからの null レスポンスを正しく処理するようになり、最後に確認された正常な構成を誤ってクリアするのではなく、ローカル キャッシュから保持して提供するようになりました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.3.9 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway plugins edgeauth
3.3.9 3.3.9 3.2.2

修正されたセキュリティの問題

3.3.8

2025 年 12 月 16 日、Apigee は Edge Microgateway に対する次の修正と機能強化をリリースしました。

バグの修正と機能強化:

問題 ID タイプ 説明
430058436 機能

Edge Microgateway(EMG)が Node.js バージョン 24 をサポートするようになり、現在の Node.js Active LTS リリースと Maintenance LTS リリースに対応しました。Node.js バージョン 18 のサポートは終了しました。

135435674 機能

保守性を向上させ、リリース プロセスを効率化するため、microgateway-core コンポーネントと microgateway-config コンポーネントが 1 つの microgateway パッケージに統合されました。この統合により、内部の複雑さとメンテナンスのオーバーヘッドが軽減され、将来の開発に役立ちます。

461773945 バグ

Apigee 管理プレーンから構成を更新しているときにエラー(HTTP 500 や接続リセットなど)が発生すると、Edge Microgateway がキャッシュからのリクエストを処理できないことがある問題を修正しました。Edge Microgateway は、このような一時的なコントロール プレーンの問題が発生している間、最後に確認された正常な構成をより確実に使用するようになりました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.3.8 に関連付けられた個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway plugins edgeauth
3.3.8 3.3.8 3.2.2

修正されたセキュリティの問題

3.3.7

2025 年 7 月 17 日、Apigee は Edge Microgateway に対する次の修正と機能強化をリリースしました。

バグの修正と機能強化:

問題 ID タイプ 説明
191613108 機能

Edge Microgateway(EMG)が、excludeUrls 構成内のワイルドカード URL パターンをサポートするように拡張されました。この機能強化により、executeURL 機能が静的 URL に制限され、GET リクエストの URL パターンやクエリ パラメータがサポートされていなかったという以前の制限が解消されました。

更新された機能により、動的 URL またはパターン マッチング URL に基づいてプラグインを条件付きで除外できるようになりました。この変更は下位互換性があり、既存の静的 URL 構成は変更を必要とせずに完全に機能し続けることが保証されました。

次に例を示します。

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

Edge Microgateway(EMG)の分析データに gateway_flow_id が含まれていました。以前は、このフィールドが省略されていたため、分析イベントと特定の API 実行の一意の識別と関連付けが困難でした。

EMG が更新され、各分析レコードに gateway_flow_id の一意の UUID が自動的に入力されるようになりました。このフィールドは、デフォルトですべての分析ペイロードの必須コンポーネントとなり、データのトレーサビリティとレポートの一貫性が大幅に向上しました。

422696257 バグ

重大なクラッシュの問題が解決され、システムの安定性が大幅に向上しました。

この修正では、内部モジュール内の設定ミスを特定して修正しました。この設定ミスにより、以前はプロセスのループが繰り返し発生し、システムが過負荷になっていました。このターゲットを絞った修正により、ループが解消され、より堅牢で信頼性の高いシステムが実現しました。

修正されたセキュリティの問題

3.3.6

2025 年 4 月 16 日、Apigee は Edge Microgateway に次の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.3.6 に関連付けられた個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版と一致しない場合があります。

microgateway core config plugins edgeauth
3.3.6 3.3.6 3.3.6 3.3.6 3.2.2

修正されたセキュリティの問題

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

3.3.5

2024 年 12 月 20 日、Apigee は Edge Microgateway に次の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.3.5 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版と一致しない場合があります。

microgateway core config plugins edgeauth
3.3.5 3.3.5 3.3.5 3.3.5 3.2.2

バグの修正と機能強化:

問題 ID タイプ 説明
383024578 機能

Node.js バージョン 22 のサポートが追加され、バージョン 16 のサポートが削除されました。Node.js v18 を使用している場合、Edge Microgateway の起動時に次のエラー メッセージが表示されます。

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

以前のバージョンの Node.js を実行している場合は、次のエラー メッセージが表示されます。

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

2024 年 9 月 18 日、Apigee は Edge Microgateway に対する次の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.3.4 に関連付けられた個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.3.4 3.3.4 3.3.4 3.3.4 3.2.2

バグの修正と機能強化:

問題 ID タイプ 説明
675987751 バグ

Edge Microgateway がクライアント IP アドレスをロギングしないという問題が修正されました。

修正されたセキュリティの問題

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

3.3.3

2024 年 4 月 25 日、Apigee は Edge Microgateway に次の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.3.3 に関連付けられた個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.3.3 3.3.3 3.3.3 3.3.3 3.2.2

バグの修正と機能強化:

問題 ID タイプ 説明
315939218 削除済み

Eureka クライアント プラグインが Edge Microgateway から削除されました。この機能の削除は、Edge Microgateway のコア機能やターゲット URL の書き換えには影響しません。詳細については、プラグインでのターゲット URL の書き換えをご覧ください。

283947053 削除済み

forever-monitor のサポートが Edge Microgateway から削除されました。forever-monitor は PM2 に置き換えることができます。詳細については、Apigee コミュニティの投稿 Edgemicro + PM2: Starting edgemicro as a service をご覧ください。

修正されたセキュリティの問題

  • 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

2023 年 8 月 18 日、Apigee は Edge Microgateway に次の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.3.2 に関連付けられた個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.3.2 3.3.2 3.3.2 3.3.2 3.2.2

バグの修正と機能強化:

問題 ID タイプ 説明
296187679 機能

サポートされている Node.js バージョン: 16、18、20。バージョン 3.3.2 以降、Edge Microgateway CLI コマンドはサポートされているバージョンでのみ動作します。サポートされていないバージョンで CLI コマンドを実行すると、エラーが発生します。Apigee でサポートされているソフトウェアとサポートされているバージョンもご覧ください。

283947053 バグ

Edge Microgateway が、アプリに関連付けられている API プロダクトのリストの最初の API プロダクトを返す問題を修正しました。現在は、リクエストに基づいて、返す正しい API プロダクトを決定します。

274443329 バグ

Docker が古いイメージ バージョンを pull する問題を修正しました。Docker ノードのバージョンが Node.js バージョン 18 に更新されました。バージョン 18.17-buster-slim の Docker イメージをビルドします。

修正されたセキュリティの問題

なし

3.3.1

2022 年 6 月 7 日、Apigee は Edge Microgateway に次の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.3.1 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.3.1 3.3.1 3.3.1 3.3.1 3.2.2

バグの修正と機能強化:

問題 ID タイプ 説明
220885293 機能

Node.js バージョン 16 がサポートされるようになりました。

231972608 バグ

プライベート クラウドの構成中に private configure コマンドがエラーをスローする問題を修正しました。

233315475 バグ

json2xml プラグインが、レスポンスを JSON から XML に変換する際、および accumulate-response プラグインと組み合わせて使用された場合に、解析エラーをスローする問題を修正しました。

221432797 変更

ベース Edge Microgateway イメージの Docker Node.js バージョンが Node.js 14 にアップグレードされました。

215748732 機能

revokekeys コマンドに SAML トークン認証のサポートが追加されました。

revokekeys コマンドの -t オプションを使用して、ユーザー名とパスワードの認証情報の代わりに SAML トークンを渡すことができるようになりました。

詳細については、コマンドライン リファレンスをご覧ください。

218723889 ドキュメントの更新

GitHub に保存されているサポート対象の Edge Microgateway プラグインへのリンクが追加されました。Edge Microgateway にバンドルされている既存のプラグインをご覧ください。

修正されたセキュリティの問題

問題 ID 説明
CVE-2021-23413 これは、3.7.0 より前のパッケージ jszip に影響します。ファイル名がオブジェクト プロトタイプ値(proto、toString など)に設定された新しい ZIP ファイルを作成すると、変更されたプロトタイプ インスタンスを含むオブジェクトが返されます。

3.3.0

2022 年 2 月 4 日に、Apigee は Edge Microgateway の次の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.3.0 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.3.0 3.3.0 3.3.0 3.3.0 3.2.2

バグの修正と機能強化:

問題 ID タイプ 説明
219556824 報告されている問題 Edge Microgateway Gateway 3.3.0 は、npm audit fix コマンドと互換性がありません。

npm audit fix を実行すると、apigeetool が 0.15.2 にアップグレードされ、edgemicro upgradeauth コマンドに影響します。

npm audit fix を実行してから edgemicro upgradeauth を実行すると、次のエラーが表示されます。

Error: This method has been removed in JSZip 3.0, please check the upgrade guide.

この問題を解決するには、次のコマンドを実行して、正しいバージョンの apigeetool を復元します。

npm install apigeetool@0.15.1

この問題は、Edge Microgateway の今後のリリースで解決される予定です。

138622990 機能

Quota プラグインの新しいフラグ isHTTPStatusTooManyRequestEnabled を使用すると、割り当て違反が発生した場合に、ステータス 403 ではなく HTTP 429 レスポンス ステータスを返すようにプラグインを構成できます。割り当ての構成オプションをご覧ください。

192534424 バグ

Apigee Analytics に表示されるレスポンス コードが Edge Microgateway のレスポンス コードと一致しない問題が修正されました。

198986036 拡張機能 Edge Microgateway は、各ポーリング間隔で ID プロバイダ(IDP)の公開鍵を取得し、IDP の公開鍵が変更された場合は鍵を更新するようになりました。以前は、IDP の公開鍵が変更された場合、extauth プラグインは Edge Microgateway を再読み込みしないと公開鍵を更新できませんでした。
168713541 バグ

複数のターゲットに TLS / SSL を構成する方法を説明するようにドキュメントが拡張されました。クライアント SSL / TLS オプションの使用をご覧ください。

171538483 バグ

ログファイルの命名規則を修正するために、ドキュメントが変更されました。ログファイルの命名規則をご覧ください。

157908466 バグ

特定のバージョンの Edge Microgateway をインストールする方法を正しく説明するようにドキュメントが変更されました。インターネット接続がある場合の Edge Microgateway のアップグレードをご覧ください。

215748427 バグ 既存のキーとシークレットのペアを使用してキーを取り消すときに、revokekeys コマンドがエラーを返す問題を修正しました。
205524197 バグ ドキュメントが更新され、ロギングレベルの完全なリストが追加されました。edgemicro 属性とロギングレベルの設定方法をご覧ください。

バージョン 3.2.x

バグの修正と機能強化 v.3.2.x

3.2.3

2021 年 9 月 17 日、Apigee は Edge Microgateway の次の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.2.3 に関連付けられた個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.2.3 3.2.3 3.2.3 3.2.3 3.2.2

バグの修正と機能強化:

問題 ID タイプ 説明
192416584 機能

disableStrictLogFile 構成属性を使用すると、アプリケーション ログファイル api-log.log に対する厳格なファイルへのアクセス許可を緩和できます。詳細については、ログファイルへのアクセス許可を緩和する方法をご覧ください。

192799989 機能

on_target_response_abort 構成属性を使用すると、クライアント(Edge Microgateway)とターゲット サーバー間の接続が早期に終了した場合の Edge Microgateway の動作を制御できます。詳細については、edgemicro 属性をご覧ください。

148062415 バグ Docker コンテナのコンテキストで、Edge Microgateway が docker stop {containerId} コマンドで正常にシャットダウンしない問題を修正しました。プロセスは強制終了されましたが、.sock ファイルと .pid ファイルは削除されませんでした。これでファイルが削除され、同じコンテナを再起動すると想定どおりに動作します。
190715670 バグ マイクロゲートウェイの内部リロード アクティビティ中に一部のリクエストが停止する問題を修正しました。この問題は断続的に発生し、トラフィックが多い状況で発生していました。 この問題は、OAuth プラグインの tokenCache 機能と cacheKey 機能が使用されたときに発生しました。
183910111 バグ 末尾にスラッシュが付いたリソースパス URL が、別のリソースパスとして誤って解釈される問題を修正しました。たとえば、パス /country/all と /country/all/ は同じパスとして解釈されます。

修正されたセキュリティの問題

問題 ID 説明
CVE-2020-28503 2.0.5 より前の copy-props パッケージは、メイン機能によるプロトタイプ汚染に対して脆弱です。
CVE-2021-23343 すべてのバージョンのパッケージ path-parse は、splitDeviceRe、splitTailRe、splitPathRe の正規表現を介した正規表現サービス拒否(ReDoS)に対して脆弱です。ReDoS は、最悪の場合に多項式時間計算量を示します。

3.2.2

2021 年 7 月 15 日、Apigee は Edge Microgateway の以下の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.2.2 に関連付けられた個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.2.2 3.2.2 3.2.2 3.2.2 3.2.2

バグの修正と機能強化:

問題 ID タイプ 説明
185323500 変更

expires_in の値が文字列から整数に変更されました

トークン リクエスト API と更新トークン リクエスト API が、expires_in を秒単位で指定された整数値として返すようになりました。

RFC 6749 The OAuth 2.0 Authorization Framework に準拠するため、expires_in 構成パラメータの想定値が文字列から整数に変更されました。詳細については、オペレーションと構成のリファレンスをご覧ください。

188492065 変更 Node.js 8 のサポート終了

リリース 3.2.2 以降、Node.js 8 はサポートされなくなります。詳細については、サポートされているソフトウェアとサポートされているバージョン: Edge Microgateway をご覧ください。

183990345 機能 Docker コンテナのログ出力を構成する

Edge Microgateway の構成パラメータ to_console を使用すると、ログ情報をログファイルではなく標準出力に送信できます。Docker コンテナで Edge Microgateway を実行する手順に沿って操作すると、コンテナはデフォルトで stdout とエラー出力をコンテナ内の ${APIGEE_ROOT}/logs/edgemicro.log にあるファイルにリダイレクトします。

ログ情報が edgemicro.log に送信されないようにするには、コンテナの実行時に新しい LOG_CONSOLE_OUTPUT_TO_FILE 変数を使用します。

この新しい変数の使用方法については、Edge Microgateway での Docker の使用をご覧ください。

183057665 機能 edgemicro.pid ファイルパスと edgemicro.sock ファイルパスを構成可能にします。

Edge Microgateway で Docker コンテナを実行するための新しい -w, --workdir パラメータを使用すると、edgemicro.sock ファイルと edgemicro.pid ファイルを Docker コンテナに作成するディレクトリのパスを指定できます。Edge Microgateway での Docker の使用をご覧ください。

191352643 機能 Edge Microgateway の Docker イメージが更新され、NodeJS バージョン 12.22 が使用されるようになりました。Edge Microgateway での Docker の使用をご覧ください。

修正されたセキュリティの問題

問題 ID 説明
CVE-2021-28860 Node.js mixme の v0.5.1 より前のバージョンでは、攻撃者が mutate() 関数と merge() 関数を介して「__proto__」経由でオブジェクトのプロパティを追加または変更できます。汚染された属性は、プログラム内のすべてのオブジェクトに直接割り当てられます。これにより、プログラムの可用性が危険にさらされ、サービス拒否攻撃(DoS)を受ける可能性があります。
CVE-2021-30246 Node.js の jsrsasign パッケージ(10.1.13 まで)では、一部の無効な RSA PKCS#1 v1.5 署名が誤って有効と認識されます。注: 既知の攻撃はありません。
CVE-2021-23358 1.13.0-0 から 1.13.0-2 より前、1.3.2 から 1.12.1 より前のパッケージ underscore は、テンプレート関数を介した任意のコード インジェクションに対して脆弱です。特に、変数プロパティがサニタイズされずに引数として渡される場合に脆弱です。
CVE-2021-29469 Node-redis は Node.js Redis クライアントです。バージョン 3.1.1 より前では、クライアントがモニタリング モードのときに、モニター メッセージの検出に使用される正規表現の開始により、一部の文字列で指数バックトラッキングが発生する可能性がありました。この問題により、サービス拒否攻撃を受けるおそれがあります。この問題は、バージョン 3.1.1 でパッチが適用されています。
CVE-2020-8174 Docker イメージが更新され、Node.js バージョン 12.22 が使用されるようになりました。

3.2.1

2021 年 3 月 5 日、Apigee は Edge Microgateway に次の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.2.1 に関連付けられた個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.2.1 3.2.1 3.2.1 3.2.1 3.2.1

バグの修正と機能強化:

問題 ID タイプ 説明
180362102 バグ JWK 鍵の値が null の場合にアプリケーションが失敗する問題を修正しました。

null 条件が処理され、jwkPublicKeys で null 値が渡されないようになりました。

注: この修正では、edgemicro-auth プロキシをアップグレードする必要があります。

179971737 バグ ターゲットの 4XX / 5XX ステータス レスポンスが edgemicro_* プロキシのプロキシエラーとしてログに記録される問題を修正しました。

Edge Microgateway トランザクションの場合、Apigee Edge エラーコード分析ダッシュボードに誤ったターゲット エラー数が表示されていました。ターゲット エラーのエラーコードがプロキシエラーとしてカウントされていました。この問題は修正され、正しいターゲット エラー数が表示されるようになりました。

179674670 機能 プロダクト ステータス コードに基づいて、JWT に配置された API プロダクトのリストをフィルタリングできる新機能が追加されました。

API プロダクトには、Pending、Approved、Revoked の 3 つのステータス コードがあります。edgemicro-auth プロキシの Set JWT Variables ポリシーに、allowProductStatus という新しいプロパティが追加されました。このプロパティを使用して、JWT にリストされている API プロダクトをフィルタするには:

  1. Apigee プロキシ エディタで edgemicro-auth プロキシを開きます。
  2. allowProductStatus プロパティを SetJWTVariables ポリシーの XML に追加し、フィルタするステータス コードのカンマ区切りのリストを指定します。たとえば、[保留中] と [取り消し済み] のステータスでフィルタするには、次のようにします。
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Javascript timeLimit="20000" async="false" continueOnError="false"
        enabled="true" name="Set-JWT-Variables">
        <DisplayName>Set JWT Variables</DisplayName>
        <FaultRules/>
        <Properties>
            <Property name="allowProductStatus">Pending,Revoked</Property>
        </Properties>
        <ResourceURL>jsc://set-jwt-variables.js</ResourceURL>
    </Javascript>
    
    

    承認済みの商品のみを掲載する場合は、次のようにプロパティを設定します。

    <Property name="allowProductStatus">Approved</Property>
  3. プロキシを保存します。

    Property タグが存在しない場合、すべてのステータス コードの商品が JWT にリストされます。

    この新しいプロパティを使用するには、edgemicro-auth プロキシをアップグレードする必要があります。

178423436 バグ CLI または環境変数で渡されたキーとシークレットの値は、プロセス エクスプローラのコマンドライン引数に表示されます。

コマンドライン引数から渡された、または環境変数で設定された Edge Microgateway のキーとシークレットの値が、Microgateway の起動後にノード ワーカー / 子プロセスの引数に表示されるという問題が報告されました。

環境変数のシナリオでこの問題を解決するため、プロセス エクスプローラのコマンドライン引数に値が表示されなくなりました。

Microgateway の起動時にコマンドラインでキーとシークレットの値が渡されると、環境変数の値が設定されていても、その設定が優先されます。この場合、値はプロセス エクスプローラのコマンドライン引数に表示されます。

178341593 バグ apikeys プラグインのドキュメント エラーを修正しました。

apikeys プラグインの README ファイルに、gracePeriod プロパティが誤って含まれていました。このプロパティとその説明を README から削除しました。

gracePeriod プロパティは oauth プラグインに実装されています。猶予期間機能を使用するには、oauth プラグインを使用する必要があります。

179366445 バグ ターゲットへのすべての GET リクエストでペイロードがドロップされる問題が修正されました。

目的の動作は、新しい構成パラメータ edgemicro: enable_GET_req_body で制御できます。true に設定すると、リクエスト ヘッダー transfer-encoding: chunked がすべての GET リクエストに追加され、GET ペイロードが存在する場合はターゲットに送信されます。false(デフォルト)の場合、リクエストがターゲットに送信される前にペイロードがサイレントに削除されます。

次に例を示します。

edgemicro:
 enable_GET_req_body: true

RFC 7231、セクション 4.3.1: GET によると、GET リクエスト ペイロードには定義されたセマンティクスがないため、ターゲットに送信できます。

3.2.0

2021 年 1 月 21 日、Apigee は Edge Microgateway の次の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.2.0 に関連付けられた個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.2.0 3.2.0 3.2.0 3.2.0 3.2.0

バグの修正と機能強化:

問題 ID タイプ 説明
152640618 バグ extauth プラグインを有効にして、トークンが有効な場合にリクエスト オブジェクトに client_id を含む x-api-key ヘッダーを設定します。その後、x-api-key は後続のプラグインで使用できるようになります。
168836123、172295489、176462355、176462872 機能 Node.js 14 のサポートを追加しました。
172376835 バグ edgemicro-auth プロキシの /token エンドポイントに正しい時間単位を使用します。

edgemicro-auth プロキシの /token エンドポイントが expires_in をミリ秒単位で返す問題を修正しました。OAuth 仕様に従い、refresh_token_expires_in の時間単位(秒)と一致する必要があります。

この修正では、有効期限の長さは変更されず、時間単位のみが変更されます。これは、アクセス トークンのレスポンス ペイロードの expires_in フィールドにのみ適用されます。同じレスポンス ペイロードの JWT トークンには、iat と exp の 2 つのフィールドが含まれます。これらは seconds 時間単位で正しく生成され、常に生成されています。

クライアントがトークンの有効期限が切れる前に更新トークンを更新するために expires_in 値(ミリ秒単位)に依存している場合、クライアントを変更せずにこの修正を適用すると、更新が頻繁に発生し、不要な更新が発生します。これらのクライアントは、元の動作を維持するために、時間単位の変更を考慮して変更する必要があります。

クライアントが常に JWT トークンの値を使用してトークンの更新期間を評価している場合、クライアントを変更する必要はありません。

173064680 バグ すべてのデータチャンクが処理される前に、Microgateway がターゲット リクエストを終了する問題を修正しました。

これは、ペイロード サイズが大きいリクエストで発生する断続的な問題であり、3.1.7 リリースで導入されました。

174640712 バグ プラグインに適切なデータ処理を追加します。

json2xml、accumulate-request、accumulate-response、header-uppercase のプラグインに適切なデータ処理が追加されました。プラグインの詳細については、microgateway-plugins を参照してください。

バージョン 3.1.x

バグの修正と機能強化 v.3.1.x

3.1.8

2020 年 11 月 16 日、Apigee は Edge Microgateway の以下の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.1.8 に関連付けられた個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.1.8 3.1.9 3.1.7 3.1.3 3.1.2

バグの修正と機能強化:

問題 ID タイプ 説明
169201295 バグ 環境変数タグで数値とブール値が正しく解析されませんでした。

環境変数の置換処理ですべての値が文字列として解析され、ブール値または数値の解析エラーが発生していました。たとえば、edgemicro.port には数値が必要です。ブール値と数値をサポートするように修正されました。構成の詳細については、環境変数の値を使用した構成属性の設定をご覧ください。

169202749 バグ 環境変数の置換が機能しない場合がありました。

一部の構成属性で、環境変数の置換処理が機能していませんでした。制限事項については、環境変数値を使用した構成属性の設定をご覧ください。

168732942 バグ OAuth スコープが想定どおりに API プロキシへのアクセスを制限しない問題を修正しました。

edgemicro-auth プロキシの /token フローは、Edge で定義された正しいプロダクト スコープなしで JWT を生成しました。これは、2 つの異なるシナリオの結果です。1)/token フローへのリクエスト ペイロードがスコープ パラメータを渡さなかった、または 2)/token フローへのリクエスト ペイロードで無効なスコープが渡された。Apigee Edge の API プロダクトで定義されているすべてのスコープを返すように修正されました。

170609716 バグ edgemicro-auth プロキシの /refresh フローが apiProductList のない JWT を生成する問題を修正しました。

170708611 バグ API プロダクト スコープは、カスタム プラグインでは使用できません。

API プロダクト スコープは、カスタム プラグインで使用できず、キャッシュ構成ファイルに書き込まれませんでした。スコープの詳細をプラグインにアクセス可能にする方法については、プラグインの init() 関数についてをご覧ください。

169810710 機能 鍵とシークレットがキャッシュ構成ファイルに保存されます。

Edge Microgateway のキーとシークレットが、再読み込み / 起動のたびにキャッシュ構成 yaml ファイルに保存されていました。3.1.8 では、キーとシークレットはキャッシュ構成ファイルに保存されなくなりました。鍵とシークレットが以前にキャッシュ構成ファイルに書き込まれていた場合は、削除されます。

170708621 機能 アナリティクス プラグインを無効にできない。

以前の Microgateway バージョンでは、アナリティクス プラグインがデフォルトで有効になっており、無効にする方法はありませんでした。バージョン 3.1.8 では、アナリティクス プラグインを有効または無効にする新しい構成パラメータ enableAnalytics が導入されました。詳細については、構成リファレンスをご覧ください。

159571119 バグ レスポンス / ソケット タイムアウトのカスタム プラグインの onerror_request フックで null エラーが発生する。

onerror_request イベントの正しい HTTP ステータス コードとエラー メッセージ、onerror_response イベントの正しいエラー メッセージが入力されるように修正されました。

3.1.7

2020 年 9 月 24 日、Apigee は Edge Microgateway に次の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.1.7 に関連付けられた個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.1.7 3.1.8 3.1.6 3.1.2 3.1.1

バグの修正と機能強化:

問題 ID タイプ 説明
131708105 バグ analytics プラグインが axpublisher 呼び出しからの null レスポンスを誤って処理し、ワーカーが終了しました。

133162200 バグ デベロッパー アプリの情報が、不正なプロダクト リソースパスによる 403 ステータス レスポンス、または期限切れまたは無効なトークンによる 401 レスポンスのいずれかで、アナリティクスに入力されませんでした。

132194290 バグ Apigee Edge が一部の分析レコードを拒否すると、分析レコードが破棄されます。

158618994 バグ Redis クライアント接続が過剰です。

161404373 バグ 404 ステータス レスポンスの場合、レスポンス メッセージに完全なプロキシ URI が含まれていました。
166356972 バグ

Node.js バージョン 12.13.x 以降で Edge Microgateway を実行すると、リクエスト ペイロードを変換するプラグインの実行時に次のエラーが発生しました。

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

168681746 バグ redisBasedConfigCache:true を使用した Edge Microgateway の手動リロードが機能していませんでした。

149256174 バグ ネットワーク障害に関する OAuth プラグイン エラーがログに記録されませんでした。

166517190 バグ jwk_public_keys データが Synchronizer によって保存および取得されず、Redis に保存されませんでした。

141659881 バグ 無効なターゲット証明書のエラー処理で、誤解を招くエラー レスポンスが表示されていました。

142808699 バグ accesscontrol プラグインが「allow」セクションと「deny」セクションを正しく処理していませんでした。

Microgateway が deny セクションを適切に処理し、allow セクションと deny セクションの順序を尊重するようになりました。Apigee Edge の AccessControl ポリシーとの整合性を確保するため、新しい noRuleMatchAction プロパティが Microgateway 構成ファイルに追加されました。GitHub のアクセス制御プラグインの README もご覧ください。

3.1.6

2020 年 8 月 20 日、Apigee は Edge Microgateway の次の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.1.6 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.1.6 3.1.7 3.1.5 3.1.1 3.1.1

バグの修正と機能強化:

問題 ID タイプ 説明
163711992 機能 rotatekey コマンドのカスタム鍵と証明書ファイルの場所のオプション。

これらの新しいコマンド オプションの詳細については、鍵をローテーションするをご覧ください。

154838259 バグ 複数のデータセンターのマルチインスタンスの鍵のローテーションを修正する

これらの新しいコマンド オプションの詳細については、鍵をローテーションするをご覧ください。

145525133 アルファ機能 新しいプラグイン指標

詳細については、GitHub の新しいプラグイン指標の README をご覧ください。

159396879 バグ 未使用のパッケージ ヘルパーを削除する
161092943 バグ ベースパスの検証が正しくありませんでした

バージョン 3.1.6 より前では、ベースパスが / で終わらない場合、プロキシのベースパスが正しく照合されませんでした。

以前の動作(3.1.6 で修正済み)について、以下に詳しく説明します。

プロキシがベースパス /hello/v1 とターゲット パス https://mocktarget.apigee.net で構成されているとします。ここで、プロキシが次のリクエストを受信するとします。

リクエストパス 解決パス 結果
/hello/v1/json https://mocktarget.apigee.net/json /hello/v1 のベースパスが正しく一致しているため、解決されたパスは正しいです。
リクエストパス 解決パス 結果
/hello/v1json https://mocktarget.apigee.netjson /hello/v1 は /hello/v1json の部分文字列であるため、解決されたパスが正しくありません。/hello/v1json は有効なパスではないため、Edge Microgateway は 404 をスローするはずです。バージョン 3.1.6 以降では、この場合に 404 エラーがスローされます。
160431789 バグ カスタム プラグイン - init に渡された構成オブジェクトが入力されない

Apigee Edge の構成は、Edge Microgateway 構成ファイルとマージされた後、すべてのカスタム プラグインの構成オブジェクトで使用できるようになります。config をご覧ください。

162758808 バグ Redis バッキング ストアの新しい割り当て構成

次の構成を使用して、割り当てに Redis バッキング ストアを指定できます。詳細については、割り当てに Redis バッキング ストアを使用するをご覧ください。

3.1.5

2020 年 6 月 26 日、Apigee は Edge Microgateway の次の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.1.5 に関連付けられた個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.1.5 3.1.6 3.1.4 3.1.0 3.1.0

バグの修正と機能強化:

問題 ID タイプ 説明
159210507 機能 プラグイン処理を除外する構成

指定した URL のプラグインの処理をスキップする新しい構成機能が追加されました。詳細については、プラグインの除外 URL の構成をご覧ください。

156986819、158529319 バグ json2xml プラグインに関する問題を修正しました

プラグインが重複する Content-Type ヘッダーを生成する問題と、ヘッダーが想定どおりにターゲットに送信されない場合がある問題を修正しました。

156560067、159688634 機能

構成で環境変数の値を使用する

構成ファイルでタグを使用して環境変数を指定できる機能が追加されました。指定した環境変数タグは、実際の環境変数の値に置き換えられます。置換はメモリにのみ保存され、元の構成ファイルやキャッシュ ファイルには保存されません。詳細については、環境変数の値を使用した構成属性の設定をご覧ください。

155077210 バグ ログの形式に関する問題を修正しました。

ターゲット ホストがログに表示されるときに、余分なコロンが付加される問題を修正しました。

153673257 バグ

(Edge for Private Cloud のみ)Microgateway 対応プロダクトが pull されない

microgateway 対応プロダクトが pull されない問題を修正しました。この問題は、Edge for Private Cloud のインストールでのみ発生していました。

154956890、155008028、155829434 機能 ダウンロードした商品のカスタム属性によるフィルタリングをサポート

詳細については、カスタム属性による商品のフィルタリングをご覧ください。

153949764 バグ ログの宛先ファイルがいっぱいになると Edge Microgateway プロセスがクラッシュする問題を修正しました。

例外処理が改善され、エラーをトラップしてコンソールにメッセージを出力するようになりました。

155499600 バグ 鍵のローテーションと KVM のアップグレードに関する問題を修正

JWT 鍵のローテーションもご覧ください。

3.1.4

2020 年 4 月 23 日、Apigee は Edge Microgateway に次の修正をリリースしました。

バグの修正:

バージョン 3.1.3 の依存関係の問題を修正しました。バージョン 3.1.3 は、npm リポジトリで非推奨としてマークされています。それ以外については、バージョン 3.1.3 のリリースノートに記載されているすべてのバグの修正と機能強化がこのリリースに適用されます。

3.1.3

2020 年 4 月 15 日、Apigee は Edge Microgateway の次の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.1.3 に関連付けられた個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.1.3 3.1.3 3.1.3 3.0.14 3.0.9

バグの修正と機能強化:

  • 153509313 - Node.js デバッグ モジュールでメモリリークが発生する問題を修正しました。この問題は、バージョン v3.1.0、v3.1.1、3.1.2 で発生します。
  • 153509313 - 2 つの異なるトランザクションで同じメッセージ ID がロギング出力に表示される問題を修正しました。
  • 151673570 - Edge Microgateway が新しい Apigee KVM API を使用するように更新されない問題を修正しました。Edge Microgateway で、KVM 値の追加と更新に新しいコマンドが使用されるようになりました。
  • 152822846 - 以前のリリースでは、リソースパス マッピングの処理が Apigee Edge の処理と一致するように Edge Microgateway が更新されました。このリリースでは、パターン /literal_string/* が正しく処理されない問題が修正されました。例: /*/2/*「/」、「/*」、「/**」のリソースパスの動作を構成するもご覧ください。
  • 152005003 - 割り当てに組織と環境をスコープとする識別子を有効にする変更が加えられました。
  • 152005003 - 割り当てに組織と環境をスコープとする識別子を有効にするための変更が行われました。「org + env + appName + productName」の組み合わせが割り当て識別子として使用されます。

3.1.2

2020 年 3 月 16 日、Apigee は Edge Microgateway の以下の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.1.3 に関連付けられた個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.1.2 3.1.2 3.1.2 3.0.13 3.0.9

バグの修正と機能強化:

  • 151285018 - Edge Microgateway とバックエンド ターゲット間のトラフィックに HTTP プロキシのサポートを追加する機能強化が行われました。また、Edge Microgateway と Apigee Edge 間の既存の HTTP プロキシ サポートに関する問題が修正されました。詳細については、以下をご覧ください。
  • 149101890 - ターゲット サーバーまたはロードバランサが接続を閉じた場合のログ通知コードが ERROR から INFO に変更されました。
  • 150746985 - redisBasedConfigCache: true または quotaUri: https://%s-%s.apigee.net/edgemicro-auth が構成ファイルに存在する場合に edgemicro verify コマンドが正しく機能しない問題を修正しました。
  • 151284716 - リロード中にワーカーが再起動されたときに、サーバー接続をより迅速に閉じるように機能が強化されました。
  • 151588764 - Node.js v8 が非推奨になったため、Docker コンテナで Edge Microgateway を実行するために使用される Docker イメージの Node.js バージョンを 12 に更新します。
  • 151306049 - Edge Microgateway CLI コマンドで使用される Apigee Edge 管理 API を一覧表示するために、ドキュメントが更新されました。Edge Microgateway が使用する Management APIをご覧ください。

3.1.1

2020 年 2 月 20 日、Apigee は Edge Microgateway に次の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.1.1 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.1.1 3.1.1 3.1.1 3.0.13 3.0.9

バグの修正と機能強化:

  • 146069701 - microgateway-core モジュールが HTTP_PROXY 環境変数と HTTPS_PROXY 環境変数を尊重しない問題を修正しました。この変更により、YAML 構成ファイルでプロキシ設定が指定されている場合、その設定は無視されるようになりました。プロキシの指定には環境変数のみが使用されます。

    構成ファイルでプロキシ構成を指定する場合は、構成ファイルで指定したものと同じプロキシ URL を参照する HTTP_PROXY 変数も指定する必要があります。たとえば、次の構成を指定するとします。

    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 属性を設定します。(デフォルト: edgemicro.keep_alive_timeout で設定された時間より 5 秒長い時間。このデフォルト設定により、ロードバランサやプロキシが誤って接続をドロップするのを防ぐことができます。

  • 149278885 - 1 つのグローバル タイムアウト設定を使用する代わりに、API プロキシレベルでターゲット API タイムアウトを設定できる新機能が追加されました。

    API プロキシで TargetEndpoint プロパティ io.timeout.millis を設定すると、Edge Microgateway はそのプロパティを取得して、ターゲット エンドポイント固有のタイムアウトを適用できます。このパラメータが適用されていない場合、Edge Microgateway は edgemicro.request_timeout で指定されたグローバル タイムアウトを使用します。

3.1.0

2020 年 1 月 21 日、Apigee は Edge Microgateway の以下の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.1.0 に関連付けられた個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.1.0 3.1.0 3.1.0 3.0.12 3.0.9

バグの修正と機能強化:

  • 144187500 - quotas.failOpen フラグがトリガーされると、新しい WARN レベルのイベントがログに記録されます。 このフラグは、割り当て処理エラーが発生した場合、または 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 がキャッシュを更新し、ワーカーノードが再起動します。この変更により、処理中のトランザクションと、Microgateway に送信される新しい API 呼び出しは影響を受けません。
  • 146378327 - sourceRequest、targetRequest、targetResponse のログレベルが INFO レベルに変更されました。
  • 146019878 - Edge Analytics の「API プロキシのパフォーマンス」と Edge Microgateway の sourceResponse / targetResponse ログイベントで計算されたレイテンシの不一致が修正されました。Edge Analytics と Microgateway のログイベントのレイテンシが一致するようになりました。
  • パターン マッチング ロジックに関連する変更:
    • 147027862 - API プロダクトで指定されている次のリソースパス一致パターンをサポートするように、oauth プラグインが更新されました。
      • /{literal}**
      • /{literal}*
      • 上記の 2 つのパターンの任意の組み合わせ

      この変更により、Edge Microgateway プラグインは、「/」、「/*」、「/**」のリソースパスの動作の構成で説明されているように、Apigee Edge と同じパターン マッチングに従うようになりました。

    • 145644205 - oauth プラグインと一致するように apiKeys プラグインのパターン マッチング ロジックを更新。
  • 143488312 - クライアント ID パラメータの先頭または末尾にスペースがあると、OAuth トークンと API キーのリクエストで JWT プロダクト リストが空になる問題を修正しました。
  • 145640807 および 147579179 - 「シンクロナイザー」と呼ばれる特別な Edge Microgateway インスタンスが Apigee Edge から構成データを取得してローカルの Redis データベースに書き込むことができる新機能が追加されました。他の Microgateway インスタンスは、データベースから構成データを読み取るように構成できます。この機能により、Edge Microgateway の復元性が向上します。これにより、Apigee Edge と通信しなくても、Microgateway インスタンスを起動して機能させることができます。詳細については、Synchronizer の使用をご覧ください。

    現在、同期機能は Redis 5.0.x で動作するようにサポートされています。

バージョン 3.0.x

バグの修正と機能強化 v.3.0.x

3.0.10

2019 年 11 月 8 日、Apigee は Edge Microgateway の次の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.0.10 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.0.10 3.0.8 3.0.8 3.0.11 3.0.8

バグの修正と機能強化:

  • 142677575 - Edge Microgateway の API プロダクトで使用されるリソースパスのパターン マッチングが、Apigee Edge で使用されるリソースパスのパターン マッチングと一致するように機能が更新されました。詳細については、「/」、「/*」、「/**」のリソースパスの動作の構成をご覧ください。

    注: /*/2/** などの複合リソース パターンを使用する場合は、edgemicro_auth プロキシがスタンドアロン API プロダクトに追加されていることを確認する必要があります。次に、以下のスクリーンショットに示すように、そのプロダクトをプロキシのデベロッパー アプリに含める必要があります。

    alt_text

    注: 「/」、「/*」、「/**」のリソースパスの動作の構成で説明されている 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 の場合、割り当ては Redis に接続する Edge Microgateway インスタンスのみに制限されます。false の場合、volos-quota-apigee モジュールがバッキング ストアとして使用され、割り当てカウンタはグローバルになります。詳細については、割り当ての構成オプションをご覧ください。次に例を示します。
    edgemicro:
    ...
    quotas:
      useRedis: true
      redisHost: localhost
      redisPort: 6379
      redisDb: 1
  • 140574210 - edgemicro-auth プロキシによって生成されるトークンのデフォルトの有効期限が、108,000 ミリ秒(1.8 分)から 1,800 秒(30 分)に変更されました。
  • 143551282 - SAML 対応の組織をサポートするため、edgemicro genkeys コマンドが更新され、‑‑token パラメータが追加されました。このパラメータを使用すると、ユーザー名とパスワードの代わりに OAuth トークンを認証に使用できます。詳細については、鍵の生成をご覧ください。

3.0.9

2019 年 10 月 11 日、Apigee は Edge Microgateway の以下の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.0.9 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.0.9 3.0.7 3.0.7 3.0.10 3.0.7

バグの修正と機能強化:

  • 141989374 - 割り当てプラグインに新しい「フェイル オープン」機能が追加されました。この機能を有効にすると、割り当て処理エラーが発生した場合、または Edge への「割り当て適用」リクエストでリモート割り当てカウンタの更新に失敗した場合、次のリモート割り当ての同期が成功するまで、割り当てはローカル カウントのみに基づいて処理されます。どちらの場合も、リクエスト オブジェクトに quota-failed-open フラグが設定されます。

    割り当ての「フェイルオープン」機能を有効にするには、次の構成を設定します。

    quotas :
     failOpen : true

    注: また、OAuth プラグインの fail-open リクエスト オブジェクト フラグの名前が oauth-failed-open に変更されました。

  • 142093764 - 割り当ての超過を防ぐため、edgemicro-auth プロキシの構成が変更されました。この変更により、割り当てタイプが calendar に設定されます。この改善を利用するには、edgemicro-auth をバージョン 3.0.7 以降に更新する必要があります。
  • 142520568 - 割り当てレスポンスで MP(Message Processor)ID のロギングを有効にする新機能が追加されました。この機能を使用するには、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

2019 年 9 月 26 日、Apigee は Edge Microgateway の次の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.0.8 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.0.8 3.0.6 3.0.6 3.0.9 3.0.6

バグの修正と機能強化:

  • 140025210 - 新しい「フェイルオープン」機能が追加されました。この機能により、edgemicro-auth プロキシへの API キー検証呼び出しが成功しない接続エラーが原因で、期限切れの JWT トークンを更新できない場合でも、API 処理を続行できます。

    この機能を使用すると、古いトークンがキャッシュに残り、猶予期間が終了するまで再利用される猶予期間を設定できます。この機能により、一時的な接続エラーが発生した場合でも、Edge Microgateway はリクエストの処理を続行できます。接続性が再開され、Verify API キー 呼び出しが成功すると、新しい JWT が取得され、キャッシュ内の古い JWT が置き換えられます。

    新しい「フェイル オープン」機能を構成する手順は次のとおりです。

    1. Edge Microgateway 構成ファイルの oauth スタンザで、次のプロパティを設定します。
      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 プロキシが更新され、Verify API キー リクエストごとに Edge Microgateway のキーと Secret の検証が必要になりました。Edge Microgateway が更新され、すべての Verify API キー リクエストでキーとシークレットが常に送信されるようになりました。この変更により、クライアントは API キーのみで JWT を取得できなくなります。
  • 140090250 - 割り当て処理の診断ロギングを追加する更新が行われました。この変更により、割り当てログの出力を他の Edge Microgateway ログと関連付けることができるようになりました。

3.0.7

2019 年 9 月 12 日、Apigee は Edge Microgateway に次の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.0.7 に関連付けられた個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは個別のプロジェクトであるため、リリース番号がメインの製品版バージョンと一致しない場合があります。

microgateway core config plugins edgeauth
3.0.7 3.0.5 3.0.5 3.0.8 3.0.5

バグの修正と機能強化:

  • 140075602 - 適切な場合に 5xx ステータス コードを返すように OAuth プラグインが更新されました。以前は、このプラグインは 200 以外のすべてのケースで 4xx ステータス コードのみを返していました。200 ステータス以外のメッセージ レスポンスに対して、エラーに応じて正確な 4xx または 5xx コードが返されるようになりました。

    この機能はデフォルトでは無効になっています。この機能を有効にするには、Edge Microgateway 構成に oauth.useUpstreamResponse: true プロパティを追加します。次に例を示します。

    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 プロキシが変更され、割り当て ID から「organization」が削除されました。割り当てエンドポイントは顧客の組織に存在するため、割り当て ID は不要になりました。
  • 140823165 - 次のプロパティ名:
    edgemicro:
        keepAliveTimeout

    は、リリース 3.0.6 で誤ってドキュメント化されていました。正しいプロパティ名は次のとおりです。

    edgemicro:
        keep_alive_timeout
  • 139526406 - デベロッパー アプリに複数のプロダクトがある場合に、割り当て数が正しくカウントされないバグを修正しました。複数のプロダクトを含むアプリの各プロダクトに割り当てが正しく適用されるようになりました。「appName + productName」の組み合わせが割り当て識別子として使用されます。

3.0.6

2019 年 8 月 29 日、Apigee は Edge Microgateway の次の修正と機能強化をリリースしました。

  • 138633700 - 新しい構成プロパティ keepAliveTimeout を追加しました。このプロパティを使用すると、Edge Microgateway のタイムアウト(ミリ秒単位)を設定できます。(デフォルト: 5,000 ミリ秒)

    次に例を示します。

    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

2019 年 8 月 15 日、Apigee は Edge Microgateway の以下の修正と機能強化をリリースしました。

修正されたバグ
  • 139005279 - edgemicro status コマンドが正しい数のワーカー プロセスを返さない問題を修正しました。
  • 138437710 - ExitCounter クラスで、適切なログが書き込まれない問題を修正しました。
ログ メッセージの全般的な改善
  • 139064652 - イベントログとシステムログに trace と debug のロギングレベルを追加する機能を追加しました。現時点では、これらのログレベルを追加する機能のみが追加されています。現在、使用可能なログレベルは info、warn、error です。
  • 139064616 - すべてのコンソール ログ ステートメントでログ出力が標準化されました。コンソールのロギング ステートメントに、次の属性が含まれるようになりました。
    • タイムスタンプ
    • コンポーネント名
    • プロセス ID
    • コンソール ログ メッセージ
JWT 鍵とシークレットのログ メッセージの改善
  • 138413755 - CLI コマンド(cert、verify、upgradekvm、token、genkeys、revokekeys、rotatekey、configure)の JWT 鍵とシークレット関連のログメッセージを改善しました。
タイムアウトと接続拒否のエラー メッセージの改善
  • 138413577 - バックエンド サービスのタイムアウトに関するエラー処理を追加、改善。
  • 138413303 - レスポンスとソケットのタイムアウトに関するエラー処理を追加、改善。
  • 138414116 - 「接続が拒否されました」エラーのエラー処理を追加、改善しました。

3.0.4

2019 年 8 月 1 日、Apigee は Edge Microgateway に次の修正と機能強化をリリースしました。

  • 134445926 - 内部 Edge Microgateway 認証の改善。
  • 137582169 - 不要なプロセスが起動する問題を修正しました。余分なプロセスにより、プラグインが再読み込みされ、メモリが過剰に使用されていました。Edge Microgateway で、プロセス数が想定される上限内に維持されるようになりました。
  • 137768774 - ログ メッセージの改善:
    • トランザクション(リクエスト)ログをクリーンアップしました。
    • 必要に応じてログ メッセージを追加しました。
    • トランザクション(リクエスト)ログ メッセージをコンソール出力から関連するログファイルに移動しました。
    • コンソールログを、一元的なロギング機能を使用するように更新しました。
  • 138321133、138320563 - 今後の割り当ての強化を可能にするため、割り当てバッファに基本的な内部変更を加えました。

3.0.3

2019 年 7 月 23 日、Apigee は Edge Microgateway の次の修正と機能強化をリリースしました。

  • ロギングの機能強化: 既存のランタイム ログは、一貫した形式でランタイム データをキャプチャしてログに記録する新しい eventLog() 関数を使用します。ログ情報には次のものが含まれます。
    • タイムスタンプ(ISO 8601: YYYY-MM-DDTHH:mm:ss.sssZ)。
    • ログレベル(error、warn、info)。
    • ホスト名 - リクエスト ヘッダーからのリクエスト元のホスト名。
    • プロセス ID - Node.js プロセスのクラスタを実行している場合、これはロギングが発生したプロセスの ID です。
    • Apigee 組織名。
    • 組織内の環境名。
    • API プロキシの名前。
    • クライアントの IP アドレス。
    • ClientId。
    • 相関 ID(現在は設定されていません)。
    • 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

2019 年 7 月 3 日、Apigee は Edge Microgateway の以下の修正と機能強化をリリースしました。

コードの品質 - コードの品質がレビューされ、ユーザーが要求する品質基準を満たすようにコードが変更されています。JSHint に起因するコード品質のエラーと警告に対処しました。その結果、実際のコードエラーがいくつか特定され、修正されました。すべての Apigee Edge Microgateway モジュールがこのプロセスを通過しました。microgateway-config、microgateway-core、microgateway-plugins、microgateway の 6 月 28 日と 7 月 2 日の commit をご覧ください。コード品質が変更されたすべてのモジュールは、お客様のユースケースで Edge Microgateway の実行を検証する内部ツールでテストされています。

3.0.1

2019 年 6 月 21 日、Apigee は Edge Microgateway の次の修正と機能強化をリリースしました。

  • 134834551 - Edge Microgateway でサポートされる Node.js のバージョンを変更
    (Node.js のサポート対象バージョン: 8、12。バージョン 7、9、11 は試験運用版)
  • 134751883 - 負荷がかかっている状態で再読み込みすると Edge Microgateway がクラッシュする
  • 134518428 - フィルタ パターンが正しくない場合、Edge Microgateway の Products エンドポイントが 5XX を返す
  • 135113408 - 予期せず終了した場合にワーカーが再起動するようにする
  • 134945852 - tokenCacheSize が oauth プラグインで使用されない
  • 134947757 - oauth プラグインで cacheTTL を設定
  • 135445171 - OAuth での gracePeriod の計算が正しくない
  • Edge Microgateway のインストールに付属の memored モジュールを使用する
  • 135367906 - セキュリティ監査

バージョン 2.5.x

新機能と機能強化 v.2.5.x

(2.5.38 で修正、2019 年 6 月 7 日)

JWT の形式が正しくないと、トークン キャッシュの使用時にワーカーがクラッシュする可能性があります。Edge microgateway-plugins モジュールで修正されました。(b/134672029)

(2.5.37 で追加)CLI オプション edgemicro-cert -t を追加しました。

edgemicro cert -t オプションを使用すると、Management API の認証に使用する OAuth トークンを指定できます。証明書の管理もご覧ください。

(2.5.35 で追加)edgemicroctl を使用した Edge Microgateway のデバッグのサポートを追加しました。

mgdebug フラグは edgemicroctl で使用できます。Kubernetes 統合タスクもご覧ください。

(2.5.35 で追加)edgemicroctl の Windows ビルドを有効にします。

(2.5.31 で追加)新しい edgemicro-auth/token API

新しい edgemicro-auth/token API が追加されました。これにより、クライアント シークレットを Base64 でエンコードされた Basic 認証ヘッダーとして、権限付与タイプをフォーム パラメータとして渡すことができます。署名なしトークンを直接取得するをご覧ください。

(2.5.31 で修正)プライベート構成でトークン フラグが考慮されない

Edge for Private Cloud で OAuth2 アクセス トークンを使用するように Edge Microgateway を構成すると、正しく機能しない(トークンが無視される)問題を修正しました。

Docker: 自己署名証明書の使用をサポート

(2.5.29 で追加)Node.js でデフォルトで信頼されていない認証局(CA)を使用している場合は、Edge Microgateway で Docker コンテナを実行するときにパラメータ NODE_EXTRA_CA_CERTS を使用できます。詳細については、Node.js で信頼されていない CA の使用をご覧ください。

Docker: TLS のサポート

(2.5.29 で追加)Docker コンテナで実行されている Edge Microgateway が、Edge Microgateway サーバーへの受信リクエスト(ノースバウンド リクエスト)と、Edge Microgateway からターゲット アプリケーションへの送信リクエスト(サウスバウンド リクエスト)で TLS をサポートするようになりました。

次の例では、これらの TLS 構成を設定する方法について詳しく説明します。

これらの例では、コンテナ マウント ポイント /opt/apigee/.edgemicro を使用して証明書を読み込み、Edge Microgateway 構成ファイルで参照する方法を示します。

Docker: リクエスト プロキシのサポート

(2.5.27 で追加)Docker コンテナで Edge Microgateway を実行する場合、これらのオプションを使用して、Microgateway がファイアウォールの背後で実行されているときのプロキシの動作を制御できます。

  • HTTP_PROXY
  • HTTPS_PROXY
  • NO_PROXY

詳細については、Edge Micro を Docker コンテナとして実行するをご覧ください。

Docker: プラグインの手順を更新

(2.5.27 で追加)Docker コンテナで Edge Microgateway を実行する場合、プラグインをデプロイする方法が 2 つあります。1 つ目のオプションは、Docker マウント ポイントを使用する新しい方法です。以前から存在していたもう 1 つのオプションは、基本的に変更されていませんが、Dockerfile が更新されています。詳細については、以下のリンクを参照してください。

KVM アップグレード コマンドの新しい OAuth トークンのサポート

(2.5.27 で追加)upgradekvm コマンドで OAuth トークンを使用できます。詳細については、KVM のアップグレードをご覧ください。

Edge Analytics での API の分離

(2.5.26 で追加)新しいアナリティクス プラグイン フラグを使用すると、特定の API パスを分離して、Edge Analytics ダッシュボードに別のプロキシとして表示できます。たとえば、ヘルスチェック API を分離して、実際の API 呼び出しと混同しないようにできます。詳細については、分析からパスを除外するをご覧ください。

ローカル プロキシの構成

(2.5.25 で追加)ローカル プロキシを使用すると、Apigee Edge で Microgateway 対応プロキシを手動で作成する必要がありません。代わりに、Microgateway はローカル プロキシのベースパスを使用します。詳細については、ローカル プロキシ モードの使用をご覧ください。

スタンドアロン モードを使用する

(2.5.25 で追加)Apigee Edge の依存関係から完全に切断された状態で Edge Microgateway を実行できます。このシナリオはスタンドアロン モードと呼ばれ、インターネット接続なしで Edge Microgateway を実行してテストできます。スタンドアロン モードでの Edge Microgateway の実行をご覧ください。

鍵の取り消し

(2.5.19 で追加)Edge Microgateway 構成のキーとシークレットの認証情報を取り消す新しい CLI コマンドが追加されました。

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 が Edge Micro 構成に追加されました。

デフォルトでは、TCP 接続は Nagle アルゴリズムを使用してデータをバッファリングしてから送信します。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

Forever モニタリング用の新しい CLI オプション

(2.5.12 で追加)edgemicro forever コマンドに新しいパラメータが追加されました。これらのパラメータを使用すると、forever.json ファイルの場所を指定したり、Forever バックグラウンド プロセスを開始または停止したりできます。永続的なモニタリングもご覧ください。

パラメータ説明
-f, --fileforever.json ファイルの場所を指定します。
-a, --actionstart または stop のいずれか。デフォルトは start です。

例:

Forever を開始するには:

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

Forever を停止するには:

edgemicro forever -a stop

JWT 鍵のローテーション

Edge Microgateway で OAuth セキュリティに使用される JWT トークンの生成に使用される公開鍵 / 秘密鍵ペアをローテーションできる新機能が追加されました。JWT 鍵のローテーションをご覧ください。

ダウンロードした API プロキシのフィルタリング

デフォルトでは、Edge Microgateway は、Edge 組織内の「edgemicro_」という命名接頭辞で始まるすべてのプロキシをダウンロードします。このデフォルトを変更して、名前にパターンが一致するプロキシをダウンロードできます。ダウンロードしたプロキシのフィルタリングをご覧ください。

API プロキシなしでプロダクトを指定する

Apigee Edge では、API プロキシを含まない API プロダクトを作成できます。このプロダクト構成では、そのプロダクトに関連付けられた API キーが、組織にデプロイされた任意のプロキシで機能します。バージョン 2.5.4 以降、Edge Microgateway はこのプロダクト構成をサポートしています。

永続的なモニタリングのサポート

Edge Microgateway には forever.json ファイルがあり、Edge Microgateway を再起動する回数と間隔を制御するように構成できます。このファイルは、Forever をプログラムで管理する forever-monitor というサービスを構成します。Forever モニタリングをご覧ください。

Edge Micro 構成ファイルの一元管理

複数の Edge Microgateway インスタンスを実行する場合は、それらの構成を 1 か所で管理することをおすすめします。これを行うには、Edge Micro が構成ファイルをダウンロードできる HTTP エンドポイントを指定します。構成ファイル エンドポイントの指定をご覧ください。

forever CLI オプションのサポート

(2.5.8 で追加)edgemicro forever [package.json] コマンドを使用して、forever.json ファイルの場所を指定します。このコマンドが追加される前は、構成ファイルは Edge Microgateway のルート ディレクトリに存在する必要がありました。

次に例を示します。

edgemicro forever ~/mydir/forever.json

reload コマンドに configUrl オプションを追加

(2.5.8 で追加)edgemicro reload コマンドで --configUrl オプションまたは -u オプションを使用できるようになりました。

JWT の時間差の猶予期間

(2.5.7 で追加)OAuth 構成の gracePeriod 属性は、システム クロックと JWT 認証トークンで指定された Not Before(nbf)または Issued At(iat)時間とのわずかな不一致によって発生するエラーを防ぐのに役立ちます。この属性は、このような不一致を許容する秒数に設定します。OAuth 属性をご覧ください。

(2.5.7 で追加)OAuth 構成の gracePeriod 属性は、システム クロックと JWT 認証トークンで指定された Not Before(nbf)または Issued At(iat)時間とのわずかな不一致によって発生するエラーを防ぐのに役立ちます。この属性は、このような不一致を許容する秒数に設定します。OAuth 属性をご覧ください。

バグの修正 v2.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 で Quota が機能しない。なお、本事象はすでに解決しております。
  • (Apigee コミュニティの問題: EMG - JWT token validated against both API Proxies and Resource URI in OAUTH) JWT トークンが、API プロキシと OAUTH のリソース URI の両方に対して検証されます。この問題は修正されました。
  • (Apigee コミュニティの問題: ヘッダーに OAuth トークンがなくてもマイクロゲートウェイが動作します) マイクロゲートウェイが OAuth で動作しません。なお、本事象はすでに解決しております。
  • Windows の pidPath を修正しました。
  • (問題 #157)「ReferenceError: deployProxyWithPassword が定義されていません」というエラー メッセージが表示される問題を修正しました。
  • (問題 #169)Node.js の依存関係を更新(npm audit)
  • edgemicro-auth プロキシは Edge JWT ポリシーを使用するようになりました。プロキシは、JWT サポートを提供するために Node.js に依存しなくなりました。

バージョン 2.4.x

新機能と機能強化 v.2.4.x

1. edgemicro-auth プロキシのカスタム エイリアスを設定する(PR 116)

edgemicro-auth プロキシのデフォルトのベースパスを変更できます。デフォルトでは、ベースパスは /edgemicro-auth です。これを変更するには、edgemicro configure コマンドで -x フラグを使用します。

例:

edgemicro configure -x /mypath …


2. ベースパスのワイルドカード サポート(PR 77)

edgemicro_* プロキシのベースパスでワイルドカードとして 1 つ以上の「*」を使用できます。たとえば、ベースパスを /team/*/members にすると、新しいチームをサポートするために新しい API プロキシを作成する必要なく、クライアントが https://[host]/team/blue/members と https://[host]/team/green/members を呼び出すことができます。/**/ はサポートされていないことに注意してください。

重要: Apigee では、ベースパスの最初の要素としてワイルドカード「*」を使用できません。たとえば、/*/search は使用できません。

3. プライベート クラウド構成の CLI にカスタム構成パスを追加しました(PR 99)

デフォルトでは、Microgateway 構成ファイルは ./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 と通信できない場合は、次の 2 つの方法を検討してください。

オプション 1:

最初のオプションは、Microgateway 構成ファイルで edgemicro: proxy_tunnel オプションを true に設定することです。

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

proxy_tunnel が true の場合、Edge Microgateway は HTTP CONNECT メソッドを使用して、単一の TCP 接続を介して HTTP リクエストをトンネリングします。(プロキシを構成する環境変数が TLS 対応の場合も同様です)。

オプション 2:

2 つ目のオプションは、プロキシを指定し、Microgateway 構成ファイルで 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 ヘッダーが存在する場合、Edge Analytics で報告される client_ip 変数が設定されます。この機能を使用すると、Edge Microgateway にリクエストを送信したクライアントの IP を確認できます。

8. OAuth プラグインの変更

OAuth プラグインは、API キーの検証と OAuth アクセス トークンの検証をサポートしています。この変更前は、プラグインはどちらの形式のセキュリティも受け入れていました。この変更により、これらのセキュリティ モデルのいずれか 1 つのみを許可できます(下位互換性は維持されます)。

OAuth プラグインにより、次の 2 つの新しいフラグが追加されます。

  • allowOAuthOnly -- true に設定すると、すべての API にベアラー アクセス トークンを含む Authorization ヘッダーを付加する必要があります。

  • allowAPIKeyOnly -- true に設定すると、すべての API に API キーを含む x-api-key ヘッダー(またはカスタム ロケーション)が含まれている必要があります。

これらのフラグは、Edge Microgateway 構成ファイルで次のように設定します。

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

9. edgemicro-auth プロキシを改善しました(PR 40)。

edgemicro-auth プロキシが改善されました。これらの変更前は、プロキシは暗号化された Vault である Edge Secure Store に鍵を保存していました。これで、プロキシは Edge の暗号化された Key-Value マップ(KVM)に鍵を保存するようになります。

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>

バグの修正 v2.4.3

  • edgemicro-auth プロキシを適切に実行するために有料の組織が必要になる問題を修正しました。現在、Edge Microgateway はトライアル組織でも使用できます。(PR 5)
  • ストリームがデータの処理を完了していないにもかかわらず、終了ハンドラが実行される問題を修正しました。これにより、部分的な回答が送信されました。(PR 71)
  • プライベート クラウド インストール用のカスタム構成ディレクトリが認識されない問題を修正しました。(PR 110)
  • クライアントと Edge Microgateway 間の双方向 SSL に関する問題を修正しました。(PR 70)
  • API キーの検証が正しく機能するために、プロキシのベースパスに末尾のスラッシュが必要だった問題を修正しました。ベースパスの末尾にスラッシュを付ける必要がなくなりました。(PR 48)

バージョン 2.3.5

新機能と機能強化 v.2.3.5

プロキシ フィルタリング

Edge Microgateway インスタンスが処理する Microgateway 対応プロキシをフィルタできます。Edge Microgateway は、起動時に、関連付けられている組織内の Microgateway 対応プロキシをすべてダウンロードします。次の構成を使用して、microgateway が処理するプロキシを制限します。たとえば、次の構成では、Microgateway が処理するプロキシを edgemicro_proxy-1、edgemicro_proxy-2、edgemicro_proxy-3 の 3 つに制限しています。

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

アナリティクスのデータ マスキング

新しい構成により、リクエストパス情報が Edge 分析に表示されないようにすることができます。リクエスト URI やリクエストパスをマスクするには、Microgateway 構成に以下を追加します。URI は、リクエストのホスト名とパスの部分で構成されます。

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

バージョン 2.3.3

新機能と機能強化 v.2.3.3

このリリースにおける新機能と改善点は次のとおりです。

変更の自動ポーリングを無効にする

自動変更ポーリングをオフにするには、Microgateway 構成でこの属性を設定します。

disabled_config_poll_interval: true

デフォルトでは、定期的なポーリングにより、Edge で行われた変更(プロダクト、Microgateway 対応プロキシなどへの変更)と、ローカル構成ファイルに加えられた変更が取得されます。デフォルトのポーリング間隔は 600 秒(5 分)です。

プラグインでのターゲット URL の書き換え

プラグイン コードで req.targetHostname と req.targetPath の変数を変更することで、プラグインのデフォルトのターゲット URL を動的にオーバーライドできます。

新しいプラグイン関数のシグネチャ

ターゲット レスポンスを引数として提供する新しいプラグイン関数シグネチャが追加されました。この追加により、プラグインがターゲット レスポンスにアクセスしやすくなります。

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

簡素化されたデフォルトのロギング出力

デフォルトでは、ロギング サービスはダウンロードされたプロキシ、プロダクト、JWT の JSON を省略するようになりました。Edge Microgateway の起動時に DEBUG=* を設定することで、これらのオブジェクトを出力するようにデフォルトを変更できます。次に例を示します。

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

CLI にカスタム構成パスを追加

デフォルトでは、Microgateway 構成ファイルは ./config/config.yaml にあります。init、configure、start コマンドで、コマンドラインでカスタム構成パスを指定できるようになりました。次に例を示します。

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

バグの修正 v2.3.3

  • 大規模なリクエスト / レスポンス中に発生するメモリリークを修正しました。
  • プラグインの実行順序が修正されました。ドキュメントで説明されているとおりに動作するようになりました。
  • accumulate-request プラグインが GET リクエストでハングしなくなりました。
  • accumulate-response プラグインで、レスポンス本文がない場合にエラーが発生する問題を修正しました。

リリース 2.3.1

設置に関する注意事項

以前のバージョンの Edge Microgateway では、ZIP ファイルをダウンロードしてソフトウェアをインストールできました。これらの ZIP ファイルのサポートは終了しました。Edge Microgateway をインストールするには、以下を使用する必要があります。

npm install -g edgemicro

詳しくは、インストールのトピックをご覧ください。

新機能と機能強化 v.2.3.1

このリリースにおける新機能と改善点は次のとおりです。

プロキシをフィルタする

新しい構成により、Edge Microgateway が起動時に読み込むプロキシをフィルタできます。以前は、Microgateway は、edgemicro configure コマンドで指定した Edge 組織 / 環境から pull された、Microgateway 対応のすべてのプロキシ(edgemicro_* という名前のプロキシ)を読み込んでいました。この新機能を使用すると、このプロキシのリストをフィルタして、指定したプロキシのみを Edge Microgateway が読み込むようにできます。次のように、Microgateway 構成ファイルに proxies 要素を追加するだけです。

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

たとえば、Edge の組織 / 環境に 50 個の edgemicro_* プロキシがあり、その中に edgemicro_foo と edgemicro_bar という名前のプロキシがあるとします。次のように、これら 2 つのプロキシのみを使用するように Microgateway に指示できます。

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

起動時に、Microgateway は指定されたプロキシのみを呼び出すことができます。Edge 組織 / 環境からダウンロードされた他の microgateway 対応プロキシを呼び出そうとすると、エラーが発生します。

プラグインでターゲット リクエスト ヘッダーを設定する

ターゲット リクエスト ヘッダーを追加または変更する場合に考慮すべき基本的なパターンは 2 つあります。1 つは受信リクエストにデータが含まれている場合(POST リクエストなど)、もう 1 つは含まれていない場合(単純な 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 コマンドから削除されました。

また、3 つの新しい CLI コマンドが追加されました。これらのコマンドは、edgemicro start コマンドを実行したのと同じディレクトリから実行する必要があります。

  • edgemicro status - Edge Microgateway が実行されているかどうかを確認します。
  • edgemicro stop - Edge Microgateway クラスタを停止します。
  • edgemicro reload - ダウンタイムなしで Edge Microgateway 構成を再読み込みします。

ダウンタイムなしでの構成の自動再読み込み

Edge Microgateway は、新しい構成を定期的に読み込み、変更があった場合は再読み込みを実行します。ポーリングでは、Edge で行われた変更(プロダクト、Microgateway 対応プロキシなどへの変更)と、ローカル構成ファイルに加えられた変更が取得されます。デフォルトのポーリング間隔は 600 秒(5 分)です。デフォルトは、Microgateway 構成ファイルで次のように変更できます。

edgemicro:
    config_change_poll_interval: [seconds]

CLI にバージョン情報を追加

--version フラグが CLI に追加されました。Edge Microgateway の現在のバージョンを取得するには、次のコマンドを使用します。

edgemicro --version

新しい Edge Microgateway サーバーの SSL オプション

Edge Microgateway は、key と cert に加えて、次のサーバー SSL オプションをサポートするようになりました。

オプション 説明
pfx クライアントの秘密鍵、証明書、CA 証明書を含む pfx ファイルへのパス(PFX 形式)。
passphrase 秘密鍵または PFX のパスフレーズを含む文字列。
ca 信頼できる証明書のリストを含む PEM 形式のファイルへのパス。
ciphers 使用する暗号を「:」で区切って記述した文字列。
rejectUnauthorized true の場合、サーバー証明書は、指定された CA のリストと照合して検証されます。検証で不合格だった場合は、エラーが返されます。
secureProtocol 使用する SSL メソッド。たとえば、SSLv3_method を使用して SSL をバージョン 3 に強制します。
servername SNI(Server Name Indication)TLS 拡張機能のサーバー名。

ログファイルを 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

新機能と機能強化 v.21.0

新機能と改善点は次のとおりです。

クライアントの SSL / TLS オプションを指定する

新しい構成オプションのセットを使用して、ターゲットへの SSL / TSL 接続のクライアント オプションを指定できます。クライアント SSL / TSL オプションの使用をご覧ください。

バージョン 2.0.11

インストールに関する注意事項 v2.0.11

以前のバージョンの Edge Microgateway では、ZIP ファイルをダウンロードしてソフトウェアをインストールできました。これらの ZIP ファイルのサポートは終了しました。Edge Microgateway をインストールするには、以下を使用する必要があります。

npm install -g edgemicro

詳しくは、インストールのトピックをご覧ください。

新機能と機能強化 v.2.0.11

新機能と改善点は次のとおりです。

起動時にポートを指定する

start コマンドを使用すると、構成ファイルで指定されたポートをオーバーライドするポート番号を指定できます。PORT 環境変数を使用してポート番号を指定することもできます。詳しくは、start コマンドをご覧ください。

必要に応じて認証ヘッダーを保持する

新しい構成設定 keepAuthHeader を使用すると、リクエストで送信された Authorization ヘッダーを保持できます。true に設定すると、Auth ヘッダーがターゲットに渡されます。oauth 属性をご覧ください。

カスタム認可サービスを使用する機能

独自のカスタム サービスを使用して認証を処理する場合は、Edge Microgateway 構成ファイルの authUri 値を変更して、サービスを指すようにします。詳細については、カスタム認証サービスの使用をご覧ください。

バージョン 2.0.4

Edge Microgateway v.2.0.4 は 2016 年 5 月 25 日にリリースされました。

新機能と機能強化 v2.0.4

このリリースにおける新機能と改善点は次のとおりです。

プロダクトのリソースパスのサポート

Edge Microgateway で、プロダクトのリソースパスがサポートされるようになりました。リソースパスを使用すると、プロキシパスのパス接尾辞に基づいて API へのアクセスを制限できます。プロダクトの作成とリソースパスの構成の詳細については、API プロダクトを作成するをご覧ください。

npm グローバル インストールのサポート

これで、npm -g(グローバル)オプションを使用して Edge Microgateway をインストールできるようになりました。このオプションの詳細については、npm のドキュメントをご覧ください。

バージョン 2.0.0

Edge Microgateway v2.0.0 は 2016 年 4 月 18 日にリリースされました。

新機能と機能強化 v.2.0.0

このリリースにおける新機能と改善点は次のとおりです。

単一プロセス サーバー

Edge Microgateway が単一プロセス サーバーになりました。1 つのプロセス(以前は「エージェント」と呼ばれていた)が 2 番目のプロセスである Edge Microgateway を起動する 2 プロセスモデルは使用されなくなりました。新しいアーキテクチャにより、自動化とコンテナ化が容易になります。

名前空間付き構成ファイル

構成ファイルは、複数の Microgateway インスタンスを同じホストで実行できるように、組織と環境を使用して名前空間化されるようになりました。構成ファイルは、Edge Microgateway 構成コマンドを実行した後に ~/.edgemicro にあります。

新しい環境変数

EDGEMICRO_ORG、EDGEMICRO_ENV、EDGEMICRO_KEY、EDGEMICRO_SECRET の 4 つの環境変数があります。これらの変数をシステムに設定すると、コマンドライン インターフェース(CLI)を使用して Edge Microgateway を構成して起動するときに、これらの値を指定する必要がなくなります。

キャッシュに保存された構成

Edge Microgateway は、Apigee Edge に接続せずに再起動すると、キャッシュに保存された構成ファイルを使用します。

クラスタモード

Edge Microgateway をクラスタモードで起動するオプションが追加されました。クラスタモードを使用すると、マルチコア システムを活用できます。Microgateway は、この機能に Node.js クラスタ モジュールを使用します。詳細については、Node.js のドキュメントをご覧ください。

バグの修正 v2.0.0

プラグイン イベント ライフサイクルで、新しいコールバックを含むコードを含む非同期コードが適切に処理されるようになりました。

バージョン 1.1.2

Edge Microgateway v. 1.1.2 は 2016 年 3 月 14 日にリリースされました。

新機能と機能強化 v.1.1.2

このリリースにおける新機能と改善点は次のとおりです。

パフォーマンスの向上

Edge Microgateway が Node.js HTTP エージェントを適切に使用して、接続プーリングを改善するようになりました。この機能強化により、高負荷時のパフォーマンスと全体的な安定性が向上します。

リモート デバッガのサポート

Edge Microgateway を、node-inspector などのリモート デバッガで実行するように構成できます。

新しい構成ファイルの場所

Edge Microgateway を構成すると、agent/config/default.yaml ファイルが ~./edgemicro/config.yaml にコピーされるようになりました。

ログファイルのローテーション

新しい構成属性を使用すると、Edge Microgateway ログのローテーション間隔を指定できます。

修正されたバグ v1.1.2

v. 1.1.2 では、以下のバグが修正されています。

説明
オンプレミス Edge で使用される edgemicro-internal プロキシの Java Callout が、適切な MGMT サーバーを使用するようになりました。
エージェントから TypeScript の依存関係を削除します。
リーン デプロイ オプションを使用する際の CLI のバグを修正しました。
証明書ロジックの依存関係参照を修正しました。