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

4.52.00.03 - Edge for Private Cloud 版本資訊

您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件。info

我們在 2023 年 10 月 25 日發布了新版 Apigee Edge for Private Cloud。

注意：我們會持續支援這個版本，直到 2024 年 10 月 25 日為止。

更新程序

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

更新這個版本會更新下列 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

如要更新安裝作業，請在 Edge 節點上執行下列程序：

在所有 Edge 節點上：
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
```
在所有節點上執行 update.sh 指令碼，以便使用 SSO：

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

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

已修正安全性問題

以下是本版本已修正的已知安全性問題清單。為避免發生這些問題，請安裝最新版 Edge for Private Cloud。

問題 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	新增了啟動程序檢查，確保 postgresql 不會在升級程序中移除/刪除。
279065586	在 OAuth2 的重新導向網址中，狀態參數的熵已改善，以便避免跨網站要求偽造 (CSRF) 安全漏洞。
283310836	剖析大型 XML 時顯示的錯誤訊息已改善。
245936798	機構和環境名稱的問題導致 Postgresql 查詢失敗。<code<create< code="" dir="ltr" translate="no"> </code<create<> 改善了對長期機構和環境名稱進行 postgres 索引名稱衝突的處理方式。
293733533	Edge Gateway 元件中的 Spring 第三方程式庫已從 5.3.20 版更新至 5.3.27 版。
294363158	發生迴歸會導致部分額外維度顯示在 Edge UI 的「分析」和「監控」頁面中。這個問題已修正。
297889765	使用 Apigee-Mirror 產生的構件現在有正確的擁有權。
294989027	改善特定 Stats API 的效能。

已知問題

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

套用多個修補程式版本

本節說明如何套用多個修補程式版本，以免您是透過比先前修補程式版本更早的 Edge for Private Cloud 更新。

每個修補程式版本都包含 Edge for Private Cloud 的特定元件更新，例如 edge-management-server。如要套用多個修補程式版本，您需更新修補程式版本中所含的每個 Edge 元件，而且該元件須晚於目前安裝的版本。如需這些元件，您可以查看所有比目前版本後續版本的 Edge for Private Cloud 版本資訊，以及這些版本的 RPM 清單。如要查看所有 Edge for Private Cloud 版本資訊的連結，請參閱 Apigee 版本資訊。

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

注意：升級元件會自動安裝元件的最新修補程式版本。如果您想升級至不是最新版本的修補程式版本，就必須使用 Apigee 鏡像自行維護 Apigee 存放區的 tarball 副本，並且在 Apigee 安裝項目中使用這個鏡像。詳情請參閱「使用本機 Edge 存放區來維護 Edge 版本」。