本頁面由 Cloud Translation API 翻譯而成。

4.52.00.03 - Edge for Private Cloud 版本資訊

您正在查看 Apigee Edge 說明文件。
參閱 Apigee X 說明文件。資訊

我們在 2023 年 10 月 25 日發布了適用於 Private Cloud 的新版 Apigee Edge。

注意：自 2024 年 10 月 25 日起，系統將支援這個版本。

更新程序

如果您是從先前版本的 Private Cloud Edge 更新，本節說明如何安裝這個版本。如需從先前的版本進行更新，請參閱「套用多個修補程式版本」一文。

更新這個版本後，系統會更新下列 RPM 清單中的元件：

edge-gateway-4.52.00-0.0.60200.noarch.rpm
edge-management-server-4.52.00-0.0.60200.noarch.rpm
edge-message-processor-4.52.00-0.0.60200.noarch.rpm
edge-postgres-server-4.52.00-0.0.60200.noarch.rpm
edge-qpid-server-4.52.00-0.0.60200.noarch.rpm
edge-router-4.52.00-0.0.60200.noarch.rpm
apigee-sso-4.52.00-0.0.21316.noarch.rpm
edge-analytics-4.52.00-0.0.40100.noarch.rpm
edge-management-ui-4.52.00-0.0.20029.noarch.rpm
edge-ui-4.52.00-0.0.20233.noarch.rpm
apigee-service-4.52.00-0.0.1500.noarch.rpm
apigee-mirror-4.52.00-0.0.1032.noarch.rpm
apigee-tomcat-9.0.82-0.0.939.noarch.rpm
apigee-configutil-4.52.00-0.0.624.noarch.rpm

注意： sosreport 是系統層級的診斷與資料收集工具，現已預設安裝。Apigee 客服專員可以透過 sosreport 協助排解您可能遇到的問題。除非執行工具，否則這項工具不會收集任何資料。

如要查看目前安裝的 RPM 版本，請輸入以下指令：

apigee-all version

如要更新安裝，請在邊緣節點上執行以下程序：

在所有邊緣節點上：
1. 清除 Yum 存放區：
```
sudo yum clean all
```
2. 將最新的 Edge 4.52.00 bootstrap_4.52.00.sh 檔案下載至 /tmp/bootstrap_4.52.00.sh：
```
curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
```
3. 安裝 Edge 4.52.00 apigee-service 公用程式和依附元件：
```
sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord
```
  其中 uName 和 pWord 是您從 Apigee 接收的使用者名稱和密碼。如果省略 pWord，系統會提示您輸入該驗證碼。
4. 使用 source 指令執行 apigee-service.sh 指令碼：
```
source /etc/profile.d/apigee-service.sh
```
在所有 Edge 節點上，執行邊緣程序的 update.sh 指令碼：
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
在所有節點上執行單一登入 (SSO) 的 update.sh 指令碼：

/opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile

在所有 UI 節點上，執行使用者介面的 update.sh 指令碼：
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
如果您使用的是 New Edge 服務，請執行下列指令：
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```

已修正安全性問題

以下列出已在這個版本中修正的已知安全性問題。如要避免這些問題，請安裝適用於 Private Cloud 的最新版 Edge。

問題 ID	說明
279065506	在 OAuth2 的重新導向網址中，狀態參數的熵已經過改善，使其無法預測，以避免跨網站要求偽造 (CSRF) 安全漏洞。",
279065586	在標頭中新增內容安全政策，為網站多添一層安全保障，不受用戶端攻擊。

支援的軟體變更

我們已新增對下列軟體版本的支援：

Red Hat Enterprise Linux (Intel 64 位元)：8.8 版
Oracle Linux (Intel 64 位元)：7.9、8.7 和 8.8 版
Rocky Linux 8
Tomcat 9.0.82

如需完整的支援軟體清單，請參閱 Edge for Private Cloud 支援的軟體。

淘汰和淘汰

這個版本沒有新的淘汰項目或淘汰項目。

新功能

此版本推出了以下新功能：

設定機構和環境名稱的字元數上限

在這個版本中，您可以在建立新機構或環境時限制機構和環境名稱的字元數上限。字元數上限的預設值是 255。如要設定較低的上限，請在各個屬性檔案中設定下列屬性：

在機構屬性檔案中，設定 org.name.max.length。
在機構屬性檔案中，設定 env.name.max.length。

如果將上述任一屬性設為小於 0 或大於 255 的值，則系統會分別使用最大值 1 或 255。

設定存取權杖的到期時間

在這個版本中，您可以將屬性 conf_keymanagement_oauth_access_token_expiry_time_in_millis 設為所需的到期時間 (以毫秒為單位)，藉此設定存取權杖的到期時間。這項功能預設為停用。如要啟用這項功能，請在訊息處理器中將 conf_keymanagement_oauth_access_token_is_apply_limit 設為 true。

這項功能可讓 Apigee 管理員進一步控管在 Apigee 中建立的存取權杖到期時間。

修正錯誤

本節列出已在這個版本中修正的 Private Cloud 錯誤。

問題 ID	說明
290242749	當在 DataMasking 中使用 `ServiceCallout.response` 變數時，政策就不會顯示在追蹤記錄中。不過現在這個問題已經解決。
260397807	電子郵件範本中的一項問題，導致使用者無法透過電子郵件傳送多位元組字元。不過現在這個問題已經解決。
234544436	在新版 Edge UI 中變更機構時，左側選單會消失。不過現在這個問題已經解決。
293268203	管理伺服器節點不會自動升級 Analytics (分析) 依附元件。不過現在這個問題已經解決。
261616264	新增了 Bootstrap 檢查，確保在升級程序期間不會移除/刪除 Postgresql。
279065586	在 OAuth2 的重新導向網址中，狀態參數的熵已經過改善，使其無法預測，以避免跨網站要求偽造 (CSRF) 安全漏洞。
283310836	改善剖析大型 XML 時的錯誤訊息。
245936798	機構和環境名稱發生問題，導致 Postgresql <code<create<code="" dir="ltr"trans="no">查詢失敗。</code<create<> 透過改善長篇機構和環境名稱的 Postgres 索引名稱衝突處理方式，這個問題現已獲得修正。
293733533	Edge Gateway 元件中的 Spring 第三方程式庫已從 5.3.20 版更新至 5.3.27 版。
294363158	迴歸導致部分額外維度出現在 Edge UI 的數據分析和監控頁面的下拉式選單中。不過現在這個問題已經解決。
297889765	Apigee- 鏡像產生的構件現在具備正確的擁有權

已知問題

如需已知問題的完整清單，請參閱「Edge for Private Cloud 的已知問題」一文。

套用多個修補程式版本

本節說明如何套用多個修補程式版本，以便您從 Private Cloud 適用的 Edge 版本更新，但更新的版本早於先前的修補程式發布版本。

每個修補程式版本都包含針對 Private Cloud Edge 特定元件的更新項目，例如 edge-management-server。如要套用多個修補程式版本，您需要更新修補程式版本中包含的每個 Edge 元件，使其高於目前安裝的版本。如要找到這些元件，請查看私有雲的 Edge 版本資訊，瞭解目前版本之後的所有版本，並查看這些版本的 RPM 清單。請參閱 Apigee 版本資訊，取得所有 Edge for Private Cloud 版本資訊的連結。

注意：您只需要更新每個元件一次，方法是為修補程式版本內含的最新版元件安裝 RPM。請按照該版本的版本資訊中的操作說明更新元件。

注意：升級元件會自動安裝元件的最新修補程式版本。如要升級至不是最新的修補程式版本，您必須使用 Apigee 鏡像維護自己的 Apigee 存放區 tarball 副本，並將這個鏡像用於 Apigee 安裝。詳情請參閱「使用本機 Edge 存放區來維護邊緣版本」。