4.51.00 Edge for Private Cloud リリースノート

ここに表示されているのは Apigee Edge のドキュメントです。
Go to the Apigee X のドキュメントに移動します
info

2021 年 7 月 29 日に、Edge for Private Cloud 機能リリース バージョン 4.51.00 をリリースしました。

リリースの概要

次の表に、このリリースの変更の概要を示します。

新機能

このリリースには、次の新機能が含まれています。

○ ライフサイクル終了(EOL)日を警告する新しいポップアップ ウィンドウ
○ パスワードが変更されたときにユーザーをログアウトするオプション
○ SMTP の TLS バージョンを設定
○ 親ファクト テーブルからデータを削除する(省略可)ための拡張された pg-data-purge スクリプトを追加
○ 新しいシステムレベルの診断およびデータ収集ツールである sosreport を追加

これらの新機能の詳細については、 新機能をご覧ください。

下位互換性

Apigee Edge for Private Cloud のこのバージョンでは、下位互換性に影響する次の問題が発生しています:

  • Apigee SSO(シングル サインオン)モジュールで、Java Management Extensions(JMX)がデフォルトで有効にならなくなりました。
  • 問題 132443137 の修正( 19.03.01 Public Cloud リリースノートに記載)により、Message Processor は X-Apigee-*で始まるヘッダーを無視するようになりました。そのため、 X-Apigee-* ヘッダーを使用するコードをリファクタリングし、これらのヘッダーをサポートされているヘッダーに置き換える必要があります。
  • Cassandra ログファイルの名前が変更されました。現在は次のようになっています。

    /opt/apigee/var/log/apigee-cassandra/system.log
含まれるリリース

前回の Edge for Private Cloud 機能リリース以降、次のリリース が行われ、このリリースに含まれています。

○ Edge:
   20.08.03(Router)
   20.09.18(Management Server)
   21.03.08(Router、Management Server、Message Processor)
廃止された機能 なし
サポートの終了

4.51.00 のリリースに伴い、次の機能のサポートが終了しました。

  • 4.19.06: Apigee Edge for Private Cloud バージョン 4.19.06 のサポートは終了しました。

削除のスケジュールなど、サポート終了の詳細については、 Apigee の非推奨、終了、CPS の変更をご覧ください。

既知の問題

このリリースには、次の既知の問題があります。

回避策など、これらの既知の問題の詳細については、 既知の問題をご覧ください。

アップグレード パス

Edge for Private Cloud 4.51.00 にアップグレードする手順については、 Apigee Edge 4.19.06 または 4.50.00 を 4.51.00 に更新するをご覧ください。

新機能

このセクションでは、このリリースの新機能について説明します。また、このリリースには、含まれるリリースに記載されている Edge UI、Edge Management、Portal のリリースに含まれるすべての機能が含まれています。

このリリースには、次の機能強化に加えて、使いやすさ、 パフォーマンス、セキュリティ、安定性に関する複数の機能強化も含まれています。

Edge for Private Cloud のライフサイクル終了(EOL)日を警告する新しいポップアップ ウィンドウ

Edge for Private Cloud のお客様には、インストールされているバージョンの EOL 日の 6 か月前から警告メッセージが表示されます。EOL メッセージは、ブラウザ セッションごとに 1 回表示されます: タブまたはブラウザを閉じると、セッションは失われます。その後、ブラウザで Apigee を再度開くと、 メッセージが再び表示されます。

パスワードが変更されたときにユーザーをログアウトする新しいオプション

apigee.feature.clearSessionOnPasswordUpdate に新しいフラグが追加されました。このフラグを使用すると、パスワードを変更した後にユーザーをログアウトするかどうかを構成できます。デフォルトでは、ユーザーはログアウトされません。

SMTP の TLS バージョンを設定する新しいフラグ

mail.smtp.ssl.protocols に新しいフラグが追加されました。このフラグは、SMTP 接続で有効にする SSL プロトコル を指定します。この機能を使用すると、 セキュリティ要件に基づいて SSL プロトコルを構成できます。

このフラグを設定するには、プロパティ ファイルに次のエントリを追加します。 /opt/apigee/customer/application/ui.properties

conf_apigee.mail.smtp.ssl.protocols=ssl-protocol

ssl-protocol の有効な値は、SSLv2HelloSSLv3TLSv1TLSv1.1TLSv1.2 です。

新しい診断ツール sosreport

新しいシステムレベルの診断およびデータの収集ツールである Sosreport を追加しました。

新しいソフトウェア バージョンのサポートを追加

Apigee は、次のソフトウェア バージョンのサポートを追加しました。

フォワード プロキシを構成する。

フォワード プロキシを構成できる次のフラグが追加されました。

  • http.proxyHost
  • http.proxyPort
  • http.proxyUser
  • http.proxyPassword

デフォルトでは、フラグの値は空です。

pg-data-purge スクリプトを拡張して、アナリティクスから親ファクト テーブルを削除する

スクリプトを実行するには、次のコマンドを入力します。

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql pg-data-purge org_name env_name number_of_days_to_retain [Delete-from-parent-fact - N/Y] [Confirm-delete-from-parent-fact - N/Y]

スクリプトには次のオプションがあります。

  • Delete-from-parent-fact デフォルト : No。親のファクト テーブルからは、保持期間より前のデータも削除されます。
  • skip-prompt。デフォルト: No。「No」の場合、スクリプトでは、親ファクトからデータを削除する前に確認のプロンプトが表示されます。パージ スクリプトが自動実行される場合は「Yes」に設定します。

ログインページでユーザーラベルを変更するオプション

新しいフラグ apigee.feature.customLoginUserLabel を使用すると、ユーザーの好みに応じてログインページのユーザーラベル を構成できます。デフォルトはメールアドレスです。

サポートされるソフトウェア

このリリースでは、サポートされるソフトウェアに次の変更が加えられています。

サポートが追加されたソフトウェア サポートが終了したソフトウェア

このリリースでは、次のソフトウェア バージョンがサポートされています。

  • Red Hat Enterprise Linux(RHEL)7.5、7.6、7.7、7.8、7.9、8.0
  • Amazon Linux AMI 2
  • Postgres 10.17
  • Nginx 1.20.1

このリリースでは、次のソフトウェア バージョンのサポートが終了しました。

  • Red Hat Enterprise Linux(RHEL)6.X
  • Amazon Linux AMI 1
  • Node.js 0.10.32

サポートされているプラットフォームの完全なリストについては、 サポートされているソフトウェアとそのバージョンをご覧ください。

バグの修正

このセクションでは、このリリースで修正された Private Cloud のバグについて説明します。また、この リリースには、 含まれるリリースに記載されている Edge UI、Edge Management、Portal のリリースに含まれるすべてのバグ修正が含まれています。

問題 ID 説明
120421482

KVM の作成に、指定された 環境が存在するかどうかを検証する追加のチェックが含まれるようになりました。

存在しない環境をターゲットとする POST リクエストと GET KVM リクエストは、404 エラーを返します。
112262604

Postgres のフェイルオーバーを実行する場合は、Mint Management Server を更新する必要があります

Mint Management Server の Postgres 接続の詳細を変更するための拡張スクリプトが作成されました。PostgreSQL データベースのフェイルオーバーの処理 をご覧ください。
150844280

インターネット接続がない場合、Apigee SSO は ログイン時に外部フォント ライブラリをダウンロードしようとしました。

オープンソース ライセンスのないヘッダーの Google Sans フォントが、 Noto Sans フォントに置き換えられました。
161351690

HMAC ポリシーがポリシー選択ツールに表示されませんでした。

ポリシーがポリシー選択ツールに表示されるようになりました。
168149141

2 番目の Management Server で Monetization のインストールが失敗していました。

Mint Management Server のインストール中に競合状態が発生する可能性のある問題が修正されました。
170089960

ログインページでユーザーラベルを変更できない

apigee.feature.customLoginUserLabel に新しいフラグが追加されました。 このフラグを使用すると、ログインページのユーザーラベルを構成できます。 デフォルトは既存のラベルです。メールアドレス。
170791446

デベロッパーのメールアドレスに禁止文字が含まれているため、 デベロッパーの詳細を編集できませんでした。

この現象は修正されました。
173657467

他のデータセンターの Cassandra ノードが停止している場合、Management Server が起動しませんでした。

この問題を回避するため、Cassandra 認証を有効にするスクリプトが強化されました。
175638733

AWS Linux 1 は非推奨になりました

AWS Linux 2 のサポートが追加されました。
175942835

dailysummaryreports への GET リクエストが CSRF 保護なしで許可されていました

この現象は修正されました。
178305317

Consul Connect クライアントが、自動フェイルオーバーに使用可能なすべての Consul サーバーを使用していませんでした

この現象は修正されました。
180207712

`CASS_HOSTS`CASS_HOSTS プロパティが正しくないため、新しい Cassandra ノードを追加できませんでした。

正しくない CASS_HOSTS プロパティが指定された場合、Cassandra の設定で改善されたエラー メッセージが返されるようになりました。
186503861

要素 が使用されている場合、ServiceCallout ポリシーがヘッダー値を誤って分割していました。

すべてのヘッダーのデフォルトの複数値 & 重複動作を制御する一般的な構成(conf_http_HTTPHeader.{ANY})を追加しました。この構成は、特定のヘッダー 構成が存在しない場合にのみ適用されます。
182456858

Management Server がローカル リージョンの Postgress サーバーに常に接続していませんでした。

ローカル リージョンの Postgres ノードに接続するように、Management Server の Postgres 選択アルゴリズムが最適化されました。
182857918

Message Processor が接続上限に達したときのログメッセージが改善されました。 これにより、トラブルシューティングが簡素化されます。

183147699

カスタム リージョン名が原因で、お客様の dc-4 の拡張に失敗しました。

新しいプロパティ REGION_MAPPING を使用すると、カスタム リージョン名を 標準リージョン名(dc-1、dc2 など)に割り当てることができます。 Edge 構成 ファイル リファレンスをご覧ください。
185285557

デベロッパーのメールアドレスを大文字と小文字を区別しないようにするオプション機能を追加しました。

この機能はデフォルトでオフになっているため、デベロッパーのメールアドレスは引き続き大文字と小文字が区別されます (現在の動作)。
189743303

API プロキシを除外するフィルタを使用した Analytics API がエラーを返していました。

カスタム レポートの実行中にフィルタを解析する際の問題が修正されました。
171240470

Cassandra JMX 認証または SSL が有効になっている場合、Management の更新が失敗していました

Management Server で設定または更新を実行するときに、Cassandra JMX 認証と SSL 構成を提供する機能を追加しました。
168560804

Edge UI で共有フローを作成するときに、権限が不足しているため UI が 403 エラーを返していました。

API に渡される未定義の値が修正されました。
171985727

Cassandra の JMX 構成を改善し、構成が他の Apigee 構成標準に準拠し、Cassandra のアップグレード中に変更がオーバーライドされないようにしました。

188526117

IP コマンドに絶対パスの接頭辞が付いていませんでした。

コマンドに絶対パスが含まれるようになりました。
123015330

コンポーネントの .properties ファイル内の数値の形式が正しくないため、コンポーネントが起動しませんでした

この現象は修正されました。
161934168

PostgreSQL PassTheHash プロトコルの設計上の脆弱性(PostgreSQL から Postgres v10.17)

この現象は修正されました。
185115206

Management Server でのアナリティクス クエリのパフォーマンスを向上させるための機能強化を行いました

193870176

標準ポート 80 と 443 で仮想ホスト リッスン オプションを無効にする Router レベルの構成を追加しました。

197331224

組織が存在しない場合、Get org は 404 Not Found エラーではなく 403 Unauthorized エラーを返していました。

184573211

Apigee SSO モジュールで、Java Management Extensions(JMX)がデフォルトで有効にならなくなりました。

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

このリリースで修正された既知のセキュリティ問題の一覧を次に示します。 これらの問題を回避するには、最新バージョンの Edge Private Cloud をインストールしてください。

問題 ID 説明
CVE-2018-16131

脆弱性: プロジェクト unified-experience/navbar で [サービス拒否攻撃(DoS)] が検出されました(SNYK-JAVA-COMTYPESAFEAKKA-32493)。この現象は修正されました。

CVE-2020-7676

jQuery のクロスサイト スクリプティング(XSS)の脆弱性。 クロスサイト スクリプティング(XSS)が報告された jQuery の脆弱性が修正されました。

CVE-2016-5388

Tomcat サーブレットの脆弱性。 既存の Tomcat サーブレット 8.0.53 にセキュリティの脆弱性がありました。Tomcat サーブレットを 8.5.34 にアップグレードすることで、この脆弱性が修正されました。

既知の問題

次の表に、このリリースの既知の問題を示します。

問題 ID 説明
194249507

apigee-mirror は Red Hat Enterprise Linux(RHEL)8.0 では動作しません。

回避策として、RHEL の下位バージョンまたは Apigee でサポートされている 別のオペレーティング システムを実行しているサーバーに apigee-mirror をインストールします。ミラーを使用して、RHEL 8.0 サーバーに Apigee をインストールした場合でもパッケージを 追加できます。

既知の問題の完全なリストについては、Edge for Private Cloud の既知の問題 をご覧ください。

次のステップ

Edge for Private Cloud 4.51.00 の使用を開始するには、次のリンクを使用します。

新規インストール:

新規インストールの概要

既存のインストール

Apigee Edge 4.19.06 または 4.50.00 を 4.51.00 に更新する