19.03.01 - Apigee Edge for Public Cloud リリースノート

Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご覧ください。
info

2019 年 12 月 3 日(火)、このバージョンの Apigee Edge for Public Cloud のアップデートのリリースを開始しました。(このリリースは 2019 年 4 月 18 日(木)に公開されました)。

新機能と最新情報

このリリースにおける新機能とアップデートは次のとおりです。

作業項目 ID コンポーネント名 説明
Apigee は 2019 年 10 月 1 日に次のアップデートのリリースを開始しました。
110995050 API ランタイム

ロード バランシング - 障害が発生したサーバーを削除するための制御の強化

API プロキシの ロードバランサを構成する際に、ロード バランシング ローテーションからサーバーが削除されるまでに発生するレスポンス エラーの数を決定できます。レスポンスのエラーとは、Apigee がターゲット サーバーからのレスポンスを 1 つも受信していないことを意味します。この状況が発生した場合、エラーカウンタが 1 つ増えます。Apigee がターゲットからレスポンスを受信すると、レスポンスが HTTP エラー(500 など)であっても、ターゲット サーバーからのレスポンスとしてカウントされ、エラーカウンタがリセットされます。異常なサーバーを負荷分散のローテーションから可能な限り早く除外するために、不正な HTTP レスポンス(500 など)もエラーとしてカウントさせたい場合は、<ResponseCode> 子要素を含む新しい <ServerUnhealthyResponse> 要素をロードバランサの構成に追加します。Edge は、こうしたコードを含むレスポンスもエラーとしてカウントするようになります。

<HTTPTargetConnection>
  <LoadBalancer>
    <Algorithm>RoundRobin</Algorithm>
    <Server name="target1" />
    <Server name="target2" />
    <ServerUnhealthyResponse>
        <ResponseCode>500</ResponseCode>
        <ResponseCode>502</ResponseCode>
        <ResponseCode>503</ResponseCode>
    </ServerUnhealthyResponse>
    <MaxFailures>5</MaxFailures>
  </LoadBalancer>
</HTTPTargetConnection>
  
  
130416715 セキュリティ

AccessControl ポリシーの強化

AccessControl ポリシーは、API プロキシを呼び出すことができる IP アドレスを決定します。このポリシーの新しい要素により、API デベロッパーは評価する IP アドレスをより詳細に制御できます。

<IgnoreTrueClientIPHeader>: 省略可(デフォルトは false)。true に設定すると、ポリシーは True-Client-IP ヘッダーを無視し、構成した X-Forwarded-For 評価動作に従って X-Forwarded-For ヘッダーの IP アドレスを評価します。

<AccessControl async="false" continueOnError="false"
    enabled="true" name="Access-Control-1">
    <DisplayName>Access Control-1</DisplayName>
    <IgnoreTrueClientIPHeader>true</IgnoreTrueClientIPHeader>
    ...
</AccessControl>
Apigee は 2019 年 4 月 18 日に次のアップデートをリリースしました。
117558815、
119856499、
110548137、
79526748、
72989449、
70712859、
69049041
API ランタイム JWS と JWT
JWS をサポートするための新しいポリシーを追加し、既存の JWT ポリシーを強化しました。

詳しくは、こちらのコミュニティ投稿をご覧ください。

122610025 API ランタイム RaiseFault で障害理由と任意の変数を AssignMessage と同様に設定できるようにする

RaiseFault ポリシーで 2 つの新しい要素を使用できるようになり、FaultRules の処理がよりクリーンで強力になりました。

  • ShortFaultReason はブール値です。true に設定すると、ポリシー名が fault.reason 変数に格納されます。
  • FaultResponse で使用できる AssignVariable を使用すると、API プロキシフローの他のポリシーで使用される変数に障害レスポンスを割り当てることができます。
121149811 Hosted Targets Hosted Targets に適用される上限

Hosted Targets に制限が適用されるようになりました。上限の詳細については、上限をご覧ください。

117659213 API ランタイム AccessControl ポリシーで IP 範囲をパラメータ化する

メッセージ テンプレート変数を使用して、AccessControl ポリシーで IP アドレスと CIDR マスクを設定できるようになりました。たとえば、IP アドレスとマスクを Key-Value マップ(KVM)に保存する場合は、API プロキシフローで設定した変数からこれらの値を取得できます。これにより、ポリシー構成を変更することなく、実行時に IP 値を簡単に変更できます。

たとえば、次の操作を行います。

<MatchRule action="DENY">
    <SourceAddress mask="24">198.51.100.1</SourceAddress>
</MatchRule>
     

値が KVM に保存され、KeyValueMapOperations ポリシーを使用して値を取得し、ここに示されている変数に割り当てる場合は、次のようにポリシーを構成できます。

<MatchRule action="DENY">
    <SourceAddress mask="{kvm.mask.ref}">{kvm.ip.ref}</SourceAddress>
</MatchRule>
     
113599885 API Monitoring API Monitoring のロール

API Monitoring には、API Monitoring にアクセスするで説明されている API Monitoring 管理者と API Monitoring ユーザーの 2 つのロールがあります。これらは 2018 年 12 月にリリースされました。

132256772 API ランタイム リクエストに X-Apigee.Message-Timeout ヘッダーが追加される

Edge は、各リクエストにヘッダー X-Apigee.Message-Timeout を追加します。このヘッダーは Edge の内部使用を目的としています。API プロキシの X-Apigee.* ヘッダーの値には依存しないでください。これらのヘッダーはお客様用ではなく、いつでも Apigee によって削除または変更される可能性があります。

78575018 プライベート クラウド / OPDK 複数のゲートウェイ Pod がある場合にゲートウェイ データストアの登録をスキップする管理サーバーをスキップ

修正済みのバグ

このリリースでは以下のバグが修正されています。このリストは、主にユーザーがご自身で送信されたサポート チケットの修正状況を確認するためのものです。すべてのユーザーに詳細情報を提供することを目的としたものではありません。

作業項目 ID コンポーネント名 説明
Apigee は、2019 年 12 月 3 日に次の修正のリリースを開始しました。
セキュリティに関する修正。
Apigee は、2019 年 10 月 29 日に次の修正のリリースを開始しました。
139381794 管理サーバー

API 呼び出しが失敗しないようにキーストアの削除エラーを処理

Apigee は、2019 年 10 月 1 日に次の修正のリリースを開始しました。
140761319 API ランタイム

x-apigee.edge.execution.sense.action が常に null に設定される

139091614 API ランタイム

ResponseCache ポリシーで、NIOTheread がスレッド プールからの拒否なしで実行されている

131331305 コアサービス

Apigee ルーターで複数のログ エクスポーターが原因で CPU 使用率が高くなる

136690640 API ランタイム

特定の組織で 404 が断続的に発生する

140948100 API ランタイム

デプロイされた共有フローが一部のメッセージ プロセッサで実行されない

Apigee は 2019 年 9 月 13 日に次の修正をリリースしました。
132654321 Management Server 監査ログにデータが表示されない
131246911 Management Server ポータルのデベロッパー メールで、*.games、*.asia などの新しいドメインのサポートを有効にする
Apigee は 2019 年 4 月 18 日に次の修正をリリースしました。
123844598 Management Server 削除したアプリキーは 24 時間経過すると再度インポートできない
123588156 API ランタイム レスポンスから Content-Length ヘッダーを削除すると 304 で失敗する
122732400 API ランタイム api.timeout の設定は io.timeout.millis をオーバーライドする
122545281 API ランタイム JSON の DebugSession データマスクで jsonPayload が配列の場合を考慮する必要がある
122355807 Management Server 複数のロールを持つユーザーの権限の動作が正しくない
121393556 API ランタイム x_apigee_fault_code が「org/codehaus/jackson/map/ObjectMapper」に設定されている
120998548 Edge UI エラー メッセージの誤字脱字: 証明書が無効であるか、信頼できない
120990929 API ランタイム Nginx/Apigee-Router からの HTTP-413 レスポンスでサーバータイプが明らかになる
120799489 API ランタイム 非同期 JavaScript コールバック httpComplete() で httpClient を使用すると、debugsession(トレース)出力がミュートされる
120794339 API ランタイム 組織のドリフトした MP
120277011 Management Server 入力検証が必要: ターゲット サーバーのホスト名に **が含まれている場合、プロキシをデプロイできない
119976417 API Monitoring API Monitoring ではプロキシの応答時間が長いと表示されるが、分析ではターゲットの応答時間が長いと表示される
119947481 API ランタイム 例外シナリオで、マスクされるペイロードが書式なしテキストとしてログに記録される
119877164 プライベート クラウド / OPDK TLS が有効な状態でルーターがエラーを生成し、メッセージ プロセッサがオフラインになる

この修正は、次の Edge for Private Cloud リリースに含まれます。

119816218 API ランタイム レスポンス キャッシュは、0 または負の数に解決される場合、Expires ヘッダーを無視します
119770242 API ランタイム ルーターと MP の通信に失敗し、完全なダウンタイムが発生しました。PostClientFlow のエラーが原因で無限ループが発生しました
119443145 Management Server ProxyEndpoint の名前を変更して再デプロイすると、API プロキシが 404 を返す
119260281 API ランタイム 「Unable to parse as a string3000.0」というログエラー
118743407 Management Server Apigee プロキシのデプロイ期間
118447966 API ランタイム MP リリース 180608_07 の JavaScript コールアウトでエラーが発生する
117549719 API ランタイム リクエスト URI とプロキシ ベースパスの不一致
117219520 API ランタイム MessageLogging: Syslog ロガーがデフォルトで間違った日付形式を使用し、ミリ秒が正しく表示されない
117116435 API ランタイム JavaScript ファイルから断続的にエラーが発生する
117091520 API ランタイム Message Processor リリース 18.06.08 以降で JavaCallout が失敗する
116165318 API ランタイム 同じバンドルの同時デプロイで RepositoryException が発生する
116055025 Configstore サービス 起動後に Message Processor に仮想ホストとアプリケーションがない
115614498 API ランタイム OPDK で ILB のサポートが必要

この修正は、次の Edge for Private Cloud リリースに含まれます。

113972537 API ランタイム 複数の P1 - Trireme プロキシの Node.js コードから NullPointerException が発生 - 500 Internal Server Error
113904969 Apigee のサポート デモ組織での API プロキシの削除に関する問題
113554802 API ランタイム SAML アサーションの検証が NullPointerException で失敗する
113315737 Management Server ZooKeeper にデプロイ レコードがないため、プロキシのデプロイに失敗した
112767195 API ランタイム KVM ポリシーへのアクセス中に断続的に DataStore エラーが発生する
112162179 API ランタイム 文字列化せずに JavaScript オブジェクトをキャッシュに保存すると、デッドロックが発生する可能性がある
111860576 API ランタイム Quota ポリシーでエラーが欠落している
111671525 Hosted Targets ホストされているターゲットからの成功以外のレスポンス コードにより、プロキシで障害フローがトリガーされる
111523933 拡張機能(コネクタ) ExtensionCallout ポリシーのキャッシュ保存に関する問題
111420263 API ランタイム MessageLogging での ConcurrentModification 例外
110843526 Management Server フローフックの作成/更新用の管理 API は共有フローを検証する必要がある
110805739 API ランタイム Reuserefreshtoken が true で、リフレッシュ トークンの有効期限が明示的に設定されていない場合、CPS フローで TTL が -1 に設定されない
110429629 API ランタイム BasicAuthentication ポリシーが request.headers.Authorization 変数を DebugSession に出力する
110425503 API ランタイム Nginx の再読み込みにより MP の可用性に関する問題が発生する
110311540 API ランタイム MP がシャットダウン中の NPE
110161455 API ランタイム AccessEntity は、CPS 組織のすべてのアプリを取得するメソッドではなく、アプリ名で取得するメソッドを使用する必要があります
90695522 API ランタイム context.proxyRequest.asForm generates java.lang.ArrayIndexOutOfBoundsException: 1
79734096 Management Server プロキシの監査ログでプロキシがフィルタリングされなくなった
78105568 Management Server デプロイされた共有フローを更新した後、/org/{org}/sharedflows/{sharedflow}/deployments 管理 API 呼び出しに共有フローのデプロイが表示されない
77528868 Trireme Trireme の回帰: スクリプト server.js がステータス コード -1 で終了しました: プロパティ 0 が見つかりません
73766568 API ランタイム 170213_02 から 171117_01 へのアップグレードにより、Trireme/Node ターゲットのプロキシのレイテンシが大幅に増加した
72710481 API ランタイム CacheServiceImpl/CacheMemoryLimiter NullPointerException
68861063 API ランタイム ルーターのシャットダウン中の NPE を処理
68833699 API ランタイム API プロキシに関する情報が API 分類ツリーから削除されないことがある
67377575 Hosted Targets Node.js プロキシでアナリティクス レコードとお客様に送信される内容が一致しない
112481174 Hosted Targets Turbo エラーが原因でプロキシのデプロイ解除が失敗しないようにする
117171470 Hosted Targets app.yaml が無効な場合のエラー メッセージを修正
67169139 API ランタイム MessageLogging ポリシーの syslog タイムスタンプ形式が正しくない
67165418 API ランタイム ライセンスされている数よりも少ない数を使用しているにもかかわらず、より多くのメッセージ プロセッサが使用されていることに関するライセンス エラー

この修正は、次の Edge for Private Cloud リリースに含まれます。

67165195 API ランタイム ValidateSAMLAssertion が署名付きレスポンスに埋め込まれたアサーションの署名を検証しない
66214414 API ランタイム 共有フローから参照される場合、currentstep.flowstate 変数は常に「SHARED_FLOW」を返します
65731656 API ランタイム 同じリクエストに対して脅威保護 API が断続的に失敗する
133197060 API ランタイム MP からターゲットに 57 Gateway timeout が返される
110535186 API ランタイム Response 要素のない ServiceCallout とプロキシを指す HTTPTargetConnection: 呼び出しがない場合がある
132443137 API ランタイム X-Apigee-* で始まるヘッダーを無視するように Message Processor の動作を変更します。そのため、X-Apigee-* ヘッダーを使用するコードをリファクタリングし、サポートされているヘッダーに置き換える必要があります。
125709964 API ランタイム purgeChildEntries を使用したキャッシュの無効化が想定どおりに機能しない