設定AEM as a Cloud Service的進階網路

最後更新： 2025年3月26日

主題：

建立對象：

管理員

本文介紹AEM as a Cloud Service中可用的進階網路功能。這些功能包括VPN、非標準連線埠和專用輸出IP位址的自助服務和API布建。

除了本檔案之外，還有一系列教學課程旨在引導您瞭解每個進階網路選項。請參閱進階網路。

IMPORTANT

您可以透過AEM as a Cloud Service UI或使用Cloud Manager API （例如cURL），在Cloud Manager中設定進階網路。

本文主要說明如何使用UI方法。如果您偏好透過API自動設定，請參閱虛擬私人網路(VPN)教學課程。

使用API自動化進階網路
若要自動進行進階網路設定（例如VPN建立），您可以使用Cloud Manager API：

curl -X POST https://cloudmanager.adobe.io/api/program/{PROGRAM_ID}/environment/{ENV_ID}/vpn \
   -H "Authorization: Bearer {ACCESS_TOKEN}" \
   -H "x-api-key: {API_KEY}" \
   -H "Content-Type: application/json" \
   -d '{
       "providerId": "aws",
       "portMappings": [
           {
               "name": "SSH",
               "protocol": "TCP",
               "port": 22
           }
       ]
   }'

請參閱虛擬私人網路(VPN)教學課程中的完整教學課程和更多API範例。

概觀

AEM as a Cloud Service 提供以下進階網路選項：

彈性連接埠輸出 - 設定 AEM as a Cloud Service 為允許從非標準連接埠輸出流量。
專用輸出 IP 位址 - 將 AEM as a Cloud Service 的對外流量設定為源自唯一的 IP。
虛擬私人網路 (VPN) - 如果您有 VPN，可保護您的基礎結構與 AEM as a Cloud Service 之間的流量。

本文首先會詳細說明每個選項以及為什麼您可能會使用這些選項，然後會說明如何使用 Cloud Manager UI 和 API 來設定選項。本文最後提供了一些進階用例。

CAUTION

如果您已佈建舊版專用輸出技術並想設定這些進階網路選項之一，聯絡 Adobe Client Care。

嘗試使用舊版專用輸出技術設定進階網路時，可能會影響網站連線。

要求和限制

設定進階網路功能時，有以下限制。

一個程式可以提供單一進階網路選項 (彈性連接埠輸出、專用輸出 IP 位址或 VPN)。
進階網路不適用於沙箱方案。
使用者必須擁有 管理員 角色，才能在您的程式中新增及設定網路基礎結構。
必須先建立生產環境，然後才能將網路基礎架構加入您的程式。
您的網路基礎設施必須與生產環境的主要區域位於相同區域內。
- 如果您的生產環境有額外的發佈區域，您可以建立對應每個額外區域的另一個網路基礎架構。
- 您建立的網路基礎架構數量不得超過生產環境中設定的最大區域數量。
- 您可以定義生產環境中可用區域的網路基礎架構數量，但新基礎架構的型別必須與先前建立的基礎架構相同。
- 建立多個基礎架構時，您只能選取尚未建立進階網路基礎架構的區域。

設定和啟用進階網絡

使用進階網路功能需要兩個步驟：

進階網路選項之設定，無論是彈性連接埠輸出、專用輸出 IP 位址或 VPN，都必須先在方案層級完成。
若要使用進階網路選項，必須在環境層級啟用。

這兩個步驟都可以使用 Cloud Manager UI 或 Cloud Manager API 來完成。

使用 Cloud Manager UI 時，這表示要使用程式層級的精靈建立進階網路設定，然後編輯您想要啟用設定的每個環境。
使用 Cloud Manager API 時，系統會在程式層級呼叫 /networkInfrastructures API 端點來宣告所需的進階網路類型。接下來是對每個環境的 /advancedNetworking 端點的呼叫，以啟用基礎設施並設定環境特定的參數。

彈性連接埠輸出

此進階網路功能可讓您設定 AEM as a Cloud Service 以透過預設開啟的 HTTP (連接埠 80) 和 HTTPS (連接埠 443) 以外的連接埠輸出流量。

TIP

在決定使用彈性連接埠輸出或專用輸出 IP 位址時，如果不需要特定的 IP 位址，建議您選擇彈性連接埠輸出。這是因為Adobe可以最佳化彈性連線埠輸出流量的效能。

NOTE

在建立後，彈性連接埠輸出基礎架構類型將無法編輯。變更設定值的唯一方法是刪除並重新建立。

UI 設定

在 my.cloudmanager.adobe.com 登入 Cloud Manager 並選取適當的組織。
在「我的程式」控制台中，選取程式。
從「程式概覽」頁面，導覽至「環境」標籤，然後在左側面板選取「網路基礎設施」。
在 新增網路基礎結構 精靈中，選取 彈性連線埠輸出。
從區域下拉式功能表，選擇想要的區域，然後按一下繼續。
「確認」標籤會總結您的選擇和後續步驟。按一下「儲存」並建立內容結構。

新記錄會顯示在側邊面板中的 網路基礎結構 標題下方。其中包含基礎架構型別、狀態、地區及啟用環境的詳細資訊。

網路基礎架構下方的新項目

NOTE

建立彈性連接埠輸出的基礎設施可能需要長達一個小時，之後可以在環境層級進行設定。

API 設定

對每個程式會叫用一次 POST/program/<programId>/networkInfrastructures 端點，直接傳遞 flexiblePortEgress 的值 (kind 參數和區域)。端點會以 network_id 及其他資訊回應，包括狀態。

呼叫後，通常需要大約 15 分鐘的時間來佈建網路基礎結構。對 Cloud Manager 的網路基礎結構 GET 端點的呼叫會顯示「就緒」狀態。

TIP

完整的參數、正確的語法，以及哪些參數之後不能變更等重要資訊，可參考 API 文件。

流量路由

對於流向 80 或 443 以外連接埠的 http 或 https 流量，應使用以下主機和連接埠環境變數來設定 Proxy：

對於HTTP： AEM_PROXY_HOST/ AEM_HTTP_PROXY_PORT (在AEM版本< 6094中預設為proxy.tunnel:3128)
對於HTTPS： AEM_PROXY_HOST/ AEM_HTTPS_PROXY_PORT (在AEM版本< 6094中預設為proxy.tunnel:3128)

例如，以下是傳送請求至 www.example.com:8443 的範例程式碼：

String url = "www.example.com:8443"
String proxyHost = System.getenv().getOrDefault("AEM_PROXY_HOST", "proxy.tunnel");
int proxyPort = Integer.parseInt(System.getenv().getOrDefault("AEM_HTTPS_PROXY_PORT", "3128"));
HttpClient client = HttpClient.newBuilder()
      .proxy(ProxySelector.of(new InetSocketAddress(proxyHost, proxyPort)))
      .build();

HttpRequest request = HttpRequest.newBuilder().uri(URI.create(url)).build();
HttpResponse<String> response = client.send(request, BodyHandlers.ofString());

如果使用非標準 Java™ 網路程式庫，請使用上述屬性為所有流量設定 Proxy。

目標流經 portForwards 參數中宣告的連接埠的非 http/s 流量應該參照一個名為 AEM_PROXY_HOST 的屬性，以及對應的連接埠。例如：

DriverManager.getConnection("jdbc:mysql://" + System.getenv("AEM_PROXY_HOST") + ":53306/test");

下表描述了流量路由：

流量

目標條件

連接埠

連線

外部目標範例

Http 或 https 通訊協定

標準 http/s 流量

80 或 443

允許

流經使用以下環境變數和 Proxy 連接埠號碼設定的 http proxy 的非標準流量 (在 80 或 443 以外的其他連接埠上)。請勿在 Cloud Manager API 呼叫的 portForwards 參數中宣告目標連接埠：

AEM_PROXY_HOST (在 AEM 版本 < 6094 中預設為 `proxy.tunnel`)
AEM_HTTPS_PROXY_PORT (在 AEM 版本 < 6094 中預設為連接埠 3128)

80 或 443 之外的連接埠

允許

example.com:8443

不使用 http proxy 的非標準流量 (在連接埠 80 或 443 之外的其他連接埠上)

80 或 443 之外的連接埠

已封鎖

非 http 或非 https

連接到 AEM_PROXY_HOST 環境變數 (使用 portOrig 在 portForwards API 參數中宣告) 的用戶端。

任何

允許

mysql.example.com:3306

其他一切

任何

已封鎖

db.example.com:5555

Apache / Dispatcher 設定

AEM Cloud Service Apache / Dispatcher層的mod_proxy指示詞可使用上述屬性進行設定。

ProxyRemote "http://example.com:8080" "http://${AEM_PROXY_HOST}:3128"
ProxyPass "/somepath" "http://example.com:8080"
ProxyPassReverse "/somepath" "http://example.com:8080"

SSLProxyEngine on //needed for https backends

ProxyRemote "https://example.com:8443" "http://${AEM_PROXY_HOST}:3128"
ProxyPass "/somepath" "https://example.com:8443"
ProxyPassReverse "/somepath" "https://example.com:8443"

專用輸出 IP 位址

在與 SaaS 廠商 (如 CRM 廠商) 整合或在 AEM as a Cloud Service 之外有提供 IP 位址允許清單的其他整合時，專用的 IP 位址可以增強安全性。新增專用的 IP 位址新增至允許清單，可確保只允許來自 AEM Cloud Service 的流量流向外部服務。除了來自任何其他允許的IP的流量之外，此方法還額外擴充。

相同的專用 IP 適用於程式中的所有環境，並且適用於製作和發佈服務。

若未啟用專用IP位址功能，來自AEM as a Cloud Service的流量會流經一組共用IP。 AEM as a Cloud Service的其他客戶會使用這些IP。

設定專用輸出IP位址類似於彈性連線埠輸出。主要區別在於設定後，流量一律從專用的唯一 IP 輸出。若要尋找該 IP，請使用 DNS 解析器識別與 p{PROGRAM_ID}.external.adobeaemcloud.com 相關聯的 IP 位址。該 IP 位址預期不會變更，但如果必須變更會事先通知。

TIP

在決定使用彈性連接埠輸出或專用輸出 IP 位址時，如果不需要特定的 IP 位址，可選擇彈性連接埠輸出。這是因為Adobe可以最佳化彈性連線埠輸出流量的效能。

NOTE

如果在 2021.09.30 之前 (即 2021 年 9 月版本之前) 已為您佈建專用輸出 IP，則您的專用輸出 IP 功能僅支援 HTTP 和 HTTPS 連接埠。

此結果包括HTTP/1.1以及加密後的HTTP/2。此外，一個專用輸出端點可以分別透過連線埠80/443上的HTTP / HTTPS與任何目標通訊。

NOTE

建立後，專用輸出 IP 位址基礎架構類型將無法編輯。變更設定值的唯一方法是刪除並重新建立。

UI 設定

在 my.cloudmanager.adobe.com 登入 Cloud Manager 並選取適當的組織。
在「我的程式」控制台中，選取程式。
從「程式概覽」頁面，導覽至「環境」標籤，然後在左側面板選取「網路基礎設施」。
在開啟的 新增網路基礎結構 精靈中，按一下 專用輸出IP位址。
從區域下拉式功能表，選擇想要的區域，然後按一下繼續。
「確認」標籤會總結您的選擇和後續步驟。按一下「儲存」並建立內容結構。

新記錄會顯示在側邊面板中的 網路基礎結構 標題下方。其中包含基礎架構型別、狀態、地區及啟用環境的詳細資訊。

網路基礎架構下方的新項目

NOTE

建立彈性連接埠輸出的基礎設施可能需要長達一個小時，之後可以在環境層級進行設定。

API 設定

對每個程式會叫用一次 POST/program/<programId>/networkInfrastructures 端點，直接傳遞 dedicatedEgressIp 的值 (kind 參數和區域)。端點會以 network_id 及其他資訊回應，包括狀態。

呼叫後，通常需要大約 15 分鐘的時間來佈建網路基礎結構。對 Cloud Manager 的網路基礎結構 GET 端點的呼叫會顯示「就緒」狀態。

TIP

完整的參數、正確的語法，以及哪些參數之後不能變更等重要資訊，可參考 API 文件。

流量路由

Http 或 https 流量會流經預先設定的 Proxy，前提是它們使用標準 Java™ 系統屬性進行 Proxy 設定。

目標流經 portForwards 參數中宣告的連接埠的非 http/s 流量應該參照一個名為 AEM_PROXY_HOST 的屬性，以及對應的連接埠。例如：

DriverManager.getConnection("jdbc:mysql://" + System.getenv("AEM_PROXY_HOST") + ":53306/test");

流量

目標條件

連接埠

連線

外部目標範例

Http 或 https 通訊協定

到 Azure (*.windows.net) 或 Adobe 服務的流量

任何

流經共用叢集 IP (不是專用的 IP)

adobe.io
api.windows.net

符合 nonProxyHosts 參數的主機

80 或 443

流經共用叢集 IP

符合 nonProxyHosts 參數的主機

80 或 443 之外的連接埠

已封鎖

流經http proxy設定，預設針對使用標準Java™ HTTP使用者端程式庫的http/s流量所設定

任何

流經專用輸出 IP

忽略 http proxy 設定 (例如，如果從標準 Java™ HTTP 用戶端資料庫中明確移除，或者如果使用忽略標準 Proxy 設定的 Java™ 資料庫)

80 或 443

流經共用叢集 IP

忽略 http proxy 設定 (例如，如果從標準 Java™ HTTP 用戶端資料庫中明確移除，或者如果使用忽略標準 Proxy 設定的 Java™ 資料庫)

80 或 443 之外的連接埠

已封鎖

非 http 或非 https

連接到 AEM_PROXY_HOST 環境變數 (使用 portOrig 在 portForwards API 參數中宣告) 的用戶端

任何

流經專用輸出 IP

mysql.example.com:3306

其他任何項目

已封鎖

功能使用情況

功能與導致輸出流量的 Java™ 程式碼或資料庫相容，前提是它們使用標準 Java™ 系統屬性進行 Proxy 設定。實際上，此方法應包含最常見的程式庫。

以下是程式碼範例：

public JSONObject getJsonObject(String relativePath, String queryString) throws IOException, JSONException {
  String relativeUri = queryString.isEmpty() ? relativePath : (relativePath + '?' + queryString);
  URL finalUrl = endpointUri.resolve(relativeUri).toURL();
  URLConnection connection = finalUrl.openConnection();
  connection.addRequestProperty("Accept", "application/json");
  connection.addRequestProperty("X-API-KEY", apiKey);

  try (InputStream responseStream = connection.getInputStream(); Reader responseReader = new BufferedReader(new InputStreamReader(responseStream, Charsets.UTF_8))) {
    return new JSONObject(new JSONTokener(responseReader));
  }
}

一些資料庫需要明確設定才能使用標準 Java™ 系統屬性進行 Proxy 設定。

使用 Apache HttpClient 的範例，需要明確呼叫
HttpClientBuilder.useSystemProperties() 或使用
HttpClients.createSystem()：

public JSONObject getJsonObject(String relativePath, String queryString) throws IOException, JSONException {
  String relativeUri = queryString.isEmpty() ? relativePath : (relativePath + '?' + queryString);
  URL finalUrl = endpointUri.resolve(relativeUri).toURL();

  HttpClient httpClient = HttpClientBuilder.create().useSystemProperties().build();
  HttpGet request = new HttpGet(finalUrl.toURI());
  request.setHeader("Accept", "application/json");
  request.setHeader("X-API-KEY", apiKey);
  HttpResponse response = httpClient.execute(request);
  String result = EntityUtils.toString(response.getEntity());
}

偵錯考量

若要驗證流量確實在預期的專用 IP 位址上傳出，請檢查目標服務中的記錄 (如果可用)。否則，呼叫偵錯服務可能會有幫助，例如 https://ifconfig.me/ip 會傳回呼叫的 IP 位址。

虛擬私人網路 (VPN)

VPN 允許從製作、發佈或預覽執行個體連線到內部部署基礎結構或資料中心。例如，此功能對於保護資料庫的存取權非常有用。 VPN 還允許連線到 SaaS 廠商，例如支援 VPN 的 CRM 廠商。

支援大多數採用 IPSec 技術的 VPN 裝置。請查閱本裝置清單內 RouteBased 設定指示 欄中的資訊。按照表格所述設定裝置。

NOTE

以下是 VPN 基礎設施的限制：

支援僅限於單一 VPN 連線
DNS Resolver 必須列在閘道位址空間中才能解析私有主機名稱。

UI 設定

在 my.cloudmanager.adobe.com 登入 Cloud Manager 並選取適當的組織。
在「我的程式」控制台中，選取程式。
從「程式概覽」頁面，導覽至「環境」標籤，然後在左側面板選取「網路基礎設施」。
在啟動的「新增網路基礎設施」精靈中，選取「虛擬私人網路」並提供必要的資訊，然後按一下「繼續」。
- 區域 — 應建立基礎結構的區域。
- 位址空間 - 位址空間只能是您自己空間中的 1/26 CIDR (64 IP 位址) 或更大的 IP 範圍。
  - 該值以後便無法變更。
- DNS資訊 — 遠端DNS解析器清單。
  - 輸入 DNS 伺服器位址後，按下Enter再新增另一個位址。
  - 在位址後面，按一下 X 即可移除。
- 共用金鑰 — 您的VPN預先共用金鑰。
  - 選取「顯示共用金鑰」，顯示金鑰，以便您仔細檢查該值。
在精靈的「連線」標籤中，提供「連線名稱」以識別您的 VPN 連線，並按一下「新增連線」。
在 新增連線 對話方塊中，定義您的VPN連線，然後按一下儲存。
- 連線名稱 - VPN連線的描述性名稱，您在上一步驟中提供，可在此處更新。
- 位址 - VPN裝置IP位址。
- 位址空間 — 要透過VPN路由的IP位址範圍。
  - 輸入一個範圍後，按下Enter再新增另一個範圍。
  - 在一個範圍後面，按一下 X 即可移除。
- IP 安全性原則 - 依需要調整預設值
對話方塊會關閉，並返回精靈的連線標籤。按一下 「繼續」。
「確認」標籤會總結您的選擇和後續步驟。按一下「儲存」並建立內容結構。

新記錄會顯示在側邊面板中的 網路基礎結構 標題下方。其中包含基礎架構型別、狀態、地區及啟用環境的詳細資訊。

API 設定

對每個程式會叫用一次 POST /program/<programId>/networkInfrastructures 端點，這會傳遞設定資訊的承載該資訊包括kind引數、區域、位址空間（CIDR清單 — 請注意，此值以後無法修改）、DNS解析器（用於解析您網路中的名稱）的 vpn 值。還包括 VPN 連接訊息，例如網關設定、共享 VPN 金鑰和 IP 安全性原則。端點會以 network_id 及其他資訊回應，包括狀態。

呼叫後，通常需要45到60分鐘的時間來布建網路基礎結構。可以呼叫 API 中的 GET 方法傳回目前狀態，這最終會從 creating 轉成 ready。請參閱 API 文件以了解各種狀態。

TIP

完整的參數、正確的語法，以及哪些參數之後不能變更等重要資訊，可參考 API 文件。

流量路由

下表描述了流量路由。

流量

目標條件

連接埠

連線

外部目標範例

Http 或 https 通訊協定

到 Azure 或 Adobe 服務的流量

任何

流經共用叢集 IP (不是專用的 IP)

adobe.io
api.windows.net

符合 nonProxyHosts 參數的主機

80 或 443

流經共用叢集 IP

符合 nonProxyHosts 參數的主機

80 或 443 之外的連接埠

已封鎖

如果IP在 VPN閘道位址 空間範圍內，並透過http proxy設定(預設針對使用標準Java™ HTTP使用者端程式庫的http/s流量所設定)

任何

流經 VPN

10.0.0.1:443
它也可以是主機名稱。

如果IP不在 VPN閘道位址空間 範圍內，並透過http proxy設定(預設針對使用標準Java™ HTTP使用者端程式庫的http/s流量所設定)

任何

流經專用輸出 IP

忽略http proxy設定(例如，如果從標準Java™ HTTP使用者端程式庫中明確移除，或者如果使用忽略標準Proxy設定的Java™程式庫)

80 或 443

流經共用叢集 IP

忽略http proxy設定(例如，如果從標準Java™ HTTP使用者端程式庫中明確移除，或者如果使用忽略標準Proxy設定的Java™程式庫)

80 或 443 之外的連接埠

已封鎖

非 http 或非 https

如果 IP 在 VPN 閘道位址空間 範圍內，並且用戶端連線到 AEM_PROXY_HOST 環境變數 (使用 portOrig 在 portForwardsAPI 參數中宣告)

任何

流經 VPN

10.0.0.1:3306
它也可以是主機名稱。

如果 IP 不在 VPN 閘道位址空間 範圍內，並且用戶端連線到 AEM_PROXY_HOST 環境變數 (使用 portOrig 在 portForwardsAPI 參數中宣告)

任何

流經專用輸出 IP

其他任何項目

任何

已封鎖

供設定的實用網域

下圖提供了一組網域和相關聯的 IP 的視覺化表示，對設定和開發很有幫助。圖表下方的表格描述了這些網域和 IP。

VPN 網域設定

網域模式

輸出 (自 AEM) 含義

輸入 (至 AEM) 含義

p{PROGRAM_ID}.external.adobeaemcloud.com

專用輸出 IP 位址，用於流向網際網路而不是流經私人網路的流量

來自 VPN 的連線在 CDN 上會顯示為來自此 IP。若要僅允許來自VPN的連線進入AEM，請將Cloud Manager設定為僅允許此IP並封鎖其他所有一切。請參閱「限制輸入 VPN 連線」一節以取得詳細資料。

p{PROGRAM_ID}.{REGION}-gateway.external.adobeaemcloud.com

不適用

AEM 端 VPN 閘道的 IP。您的網路工程團隊可以使用此IP只允許從特定IP位址到您的VPN閘道的VPN連線。

在環境中啟用進階網路設定

為程式設定好進階網路選項後，無論是彈性連接埠輸出、專用輸出 IP 位址或 VPN，若要使用，您必須在環境層級啟用。

當您為環境啟用進階網路設定時，您也可以啟用選用的連接埠轉送和非代理主機。參數可根據環境設定，以提供靈活性。

連線埠轉送 — 應針對80/443以外的任何目的地連線埠宣告連線埠轉送規則，但前提是不使用http或https通訊協定。
- 連接埠轉送規則是透過指定目標主機集 (名稱或 IP 和連接埠) 來定義。
- 透過http / https使用連線埠80/443的使用者端連線仍然必須在其連線中使用Proxy設定，才能將進階網路的屬性套用至連線。
- 對於每個目標主機，您必須將預期的目標連接埠對應到 30000 到 30999 之間的連接埠。
- 連接埠轉送規則適用於所有進階網路類型。
非代理主機 - 非代理主機可讓您宣告一組主機，這些主機應透過共用 IP 位址範圍 (而非專用 IP) 進行路由。
- 此方法可能相當實用，因為流經共用IP的流量可能會進一步最佳化。
- 非代理主機僅適用於專用輸出進階 IP 位址和 VPN 進階網路類型。

NOTE

如果環境在更新狀態中，您無法為環境啟用進階網路設定。

啟用使用 UI

在 my.cloudmanager.adobe.com 登入 Cloud Manager 並選取適當的組織。
在「我的程式」控制台中，選取程式。
從「計劃概覽」頁面，導覽至「環境」標籤，並選取您想要啟用進階網路設定的環境 (在左側面板的「環境」標題中)。然後，選取所選環境的「進階網路設定」標籤，然後按一下「啟用網路基礎設施」。
設定進階網路 對話方塊開啟。
在「非代理主機」標籤上，對於專用輸出 IP 位址和 VPN，您可以選擇性定義一組主機。這些主機應透過共用 IPS 位址範圍進行路由 (而非專用的 IP)，方法是在「非代理主機」欄位中提供主機名，然後按一下「新增」。
- 該主機將會新增至標籤上的主機清單。
- 如果您想要新增多個主機，可重複此步驟。
- 如果您想要移除主機，可按一下該列右側的 X。
- 此標籤不適用於彈性連接埠輸出設定。
在「連接埠轉送」標籤上，如果不使用 HTTP 或 HTTPS，您可以選擇為除 80/443 以外的任何目標連接埠定義連接埠轉送規則。提供名稱、 連接埠來源 和 連接埠目標，然後按一下「新增」。
- 該規則將會新增至標籤上的規則清單中。
- 如果您想要新增多個規則，可重複此步驟。
- 如果您想要移除規則，可按一下該列右側的 X。
在對話框中，按一下「儲存」，以便您可將設定套用至環境。

進階網路設定將適用於所選環境中。返回「環境」標籤，您可以查看套用於所選環境的設定詳細資訊及其狀態。

已設定進階網路的環境

啟用使用 API

若要為環境啟用進階網路設定，必須為每個環境叫用 PUT /program/<program_id>/environment/<environment_id>/advancedNetworking 端點。

API 應該會在幾秒鐘內做出回應，指示 updating 的狀態。約 10 分鐘後，對 Cloud Manager 環境 GET 端點的呼叫會顯示 ready 的狀態，這表示已套用環境更新。

每個環境的連接埠轉送規則可以透過叫用 PUT /program/{programId}/environment/{environmentId}/advancedNetworking 端點來更新，包括完整的設定參數集而非子集。

專用輸出 IP 位址和 VPN 進階網路類型支援 nonProxyHosts 參數。這項支援可讓您宣告一組應該路由通過共用IP位址範圍而不是專用IP的主機。 nonProxyHost URL 可能遵循 example.com 或*.example.com 的模式，其中僅在網域開頭支援萬用字元。

即使沒有環境流量路由規則 (主機或旁路)，仍然必須用空白承載呼叫 PUT /program/<program_id>/environment/<environment_id>/advancedNetworking。

TIP

完整的參數、正確的語法，以及哪些參數之後不能變更等重要資訊，可參考 API 文件。

編輯並刪除環境中的進階網路設定

啟用環境的進階網路設定後，您可以更新這些設定的詳細資訊或將其刪除。

NOTE

如果網路基礎設施在「建立中」、「更新中」或「刪除中」的狀態，您就無法編輯網路基礎設施。

使用 UI 編輯或刪除

在 my.cloudmanager.adobe.com 登入 Cloud Manager 並選取適當的組織。
在「我的程式」控制台中，選取程式。
從「計劃概覽」頁面，導覽至「環境」標籤，並選取您想要啟用進階網路設定的環境 (在左側面板的「環境」標題中)。然後，選取所選環境的「進階網路設定」標籤，然後按一下省略號按鈕。
在省略號選單中，選取「編輯」或「刪除」。
- 如果您選擇「編輯」，請按照上一節「利用使用者介面啟用」中所述的步驟更新資訊，然後按一下「儲存」。
- 如果您選擇「刪除」，請在「刪除網路設定」對話框中使用「刪除」來確認刪除，或使用「取消」來中止。

變更會反映在「環境」標籤上。

使用 API 編輯或刪除

若要刪除特定環境的進階網絡，請呼叫 DELETE [/program/{programId}/environment/{environmentId}/advancedNetworking]()。

TIP

完整的參數、正確的語法，以及哪些參數之後不能變更等重要資訊，可參考 API 文件。

編輯和刪除程式的網路基礎結構

一旦為程式建立了網路基礎結構，就只能編輯有限的屬性。如果您不需要，您可以刪除整個程式的進階網路基礎架構。

NOTE

編輯和刪除網路基礎設施有以下限制：

如果所有環境都停用了進階網路，則刪除作業只會刪除基礎結構。
如果網路基礎設施在「建立中」、「更新中」或「刪除中」的狀態，您就無法編輯網路基礎設施。
建立後，只能編輯 VPN 進階網路基礎架構類型，然後，只能編輯有限的欄位。
基於安全理由，在編輯進階 VPN 網路基礎架構時，一定要隨時提供 共用金鑰，即使您未編輯金鑰也一樣要提供。

使用 UI 編輯和刪除

在 my.cloudmanager.adobe.com 登入 Cloud Manager，並選取適當的組織。
在「我的程式」控制台中，選取程式。
從 計畫總覽 頁面，瀏覽至環境索引標籤。
在左側面板中，按一下 網路基礎結構。
按一下您要刪除之基礎結構旁的。
按一下編輯或刪除。
執行下列任一項作業：
- 如果您選擇編輯，則會開啟 編輯網路基礎結構 精靈。請依照建立基礎架構時說明的步驟，依需要進行編輯。
- 如果您選擇刪除，請在 刪除網路組態 對話方塊中確認刪除，並顯示刪除，或中止並顯示取消。

變更會反映在「環境」標籤上。

使用 API 編輯和刪除

要刪除程式的網路基礎結構，請叫用 DELETE /program/{program ID}/networkinfrastructure/{networkinfrastructureID}。

變更程式的進階網路基礎架構類型

一次只能為程式設定一種型別的進階網路基礎結構。進階網路基礎結構必須是彈性的連線埠輸出、專用輸出IP位址或VPN。

如果您決定需要其他進階網路基礎架構類型，而不需要已設定的網路基礎架構類型，可刪除現有的網路基礎架構類型並建立另一個網路基礎架構類型。請執行下列動作：

刪除所有環境中的進階網路。
刪除進階網路基礎結構。
建立您現在需要的進階網路基礎架構類型，包括彈性連接埠輸出、專用輸出 IP 位址或 VPN。
在環境層級重新啟用進階網路。

WARNING

此程序會導致進階網路服務在刪除和重新建立之間停機。
如果停機導致顯著的業務衝擊，請聯絡客戶支援以尋求協助，描述已經建立的內容和變更的原因。

其他發佈區域的進階網路設定

將其他區域新增到已設定進階網路的環境時，來自其他發佈區域的流量會遵循現有規則。依預設，會透過主要區域路由相符的流量。但是，如果主要區域變成無法使用，並且在額外區域中尚未啟用進階網路，則進階網路流量會下降。如果您想在其中一個區域發生中斷時將延遲最佳化並提高可用性，則有必要啟用額外發佈區域的進階網路。以下章節會說明兩種不同的案例。

NOTE

所有區域都共用環境進階網路設定，因此無法根據流量輸出的區域將流量路由至不同的目標。

專用的輸出 IP 位址

進階網路已在主要區域中啟用

如果已在主要區域中啟用進階網路設定，請依照下列步驟進行：

如果您已鎖定基礎結構，以便將專用的 AEM IP 位址加入允許清單，可暫時停用該基礎結構中的任何否決規則。如果您略過此步驟，您的基礎結構會暫時拒絕來自新區域IP位址的請求。如果您已使用完整網域名稱(FQDN) （例如p1234.external.adobeaemcloud.com）鎖定基礎架構，則不需要執行此步驟。所有AEM區域都會從相同的FQDN輸出進階網路流量。
根據進階網路文件中的說明，可透過對 Cloud Manager Create Network Infrastructure API 的 POST 呼叫為次要區域建立計畫範圍的網路基礎結構。承載的 JSON 設定相對於主要區域的唯一差異是區域屬性
如果您需要透過IP鎖定您的基礎結構以允許AEM流量，請新增對應至p1234.external.adobeaemcloud.com的IP。每個區域都應該有一個。

尚未在任何區域中設定進階網路

此程序和先前的說明大部分類似。但是，如果尚未啟用進階網路的生產環境，則有機會先在中繼環境中啟用以測試該設定：

透過對Cloud Manager建立網路基礎結構API的POST呼叫，為所有區域建立網路基礎結構。裝載的JSON設定相對於主要區域的唯一差異是region屬性。
若是中繼環境，可透過執行 PUT api/program/{programId}/environment/{environmentId}/advancedNetworking 以啟用和設定環境範圍的進階網路。如需詳細資訊，請參閱 API 文件
如有必要，可鎖定外部基礎結構，最好透過 FQDN (例如 p1234.external.adobeaemcloud.com)。不然可透過 IP 位址進行
如果中繼環境按預期運作，請啟用並設定環境範圍的進階網路設定以進行生產。

VPN

該程序和專用的輸出 IP 位址說明幾乎相同。唯一的差別是region屬性的設定與主要區域不同。此外，您可以選擇設定connections.gateway欄位。此設定可路由至由貴組織操作的不同 VPN 端點，在地理位置上更接近新區域。

疑難排解

請注意，以下幾點資訊是供您參考的準則，並包含疑難排解的最佳實務。這些建議旨在協助有效診斷和解決問題。

連線集區

連線集區是一種專門用來建立和維持連線存放庫的技術，隨時可供任何可能需要連線的執行緒立即使用。在各種線上平台和資源中可以找到許多連線集區技術，每種技術都有其獨特的優點和考量。Adobe鼓勵客戶研究這些方法，以找出與系統架構最相容的方法。

實作適當的連線集區策略是主動修正系統設定中常見疏忽的措施，因為這種疏忽經常導致效能不佳。用正確的方式建立連線集區，可協助 Adobe Experience Manager (AEM) 改善外部呼叫的效率。此方法不僅可減少資源消耗，也可降低服務中斷的風險，並減少與上游伺服器通訊時遭遇失敗請求的可能性。

Adobe建議您根據此資訊檢閱目前的AEM設定。此外，也請考慮在進階網路設定旁刻意使用連線集區。管理平行連線的數目並減少陳舊的連線，有助於最佳化網路效能。這些動作會降低Proxy伺服器達到連線限制的風險。因此，此策略實作旨在降低請求無法與外部端點連接通訊的可能性。

連線限制常見問題

使用進階網路時，連線數量會受到限制，以確保跨環境的穩定性，並防止較低環境用儘可用的連線。

每個 AEM 執行個體的連線數量限制為 1000 個，當數量達到 750 個時，系統會向客戶傳送警報。

連線限制只適用於非標準連接埠的輸出流量，還是適用於所有輸出流量？

此限制僅適用於使用進階網路（非標準連線埠上的輸出、使用專用輸出IP或VPN）的連線。

傳出連線的數目似乎沒有大幅增加。為什麼現在會收到通知？

如果客戶動態建立連線 (例如，每個要求建立一個或多個連線)，流量增加可能會導致連線激增。

過去是否曾經發生類似情況而不會觸發警報？

只有達到軟限制時，系統才會發送警報。

如果達到限制上限會發生什麼？

當達到硬性限制時，將捨棄從AEM透過進階網路（非標準連線埠上的輸出，使用專用輸出IP或VPN）的新輸出連線，以防止DoS攻擊。

可以提高限制嗎？

不可以，大量連線可能會導致顯著的效能影響，以及跨 Pod 和環境的 DoS。

AEM 系統會在一段時間後自動關閉連線嗎？

是的，連線在JVM層級和網路基礎結構的不同點關閉。不過，此工作流程對於任何生產服務而言都太遲。當您不再使用連線時應確實關閉該連線，或在使用連線集區的情況下將連線退回集區中。否則，資源消耗量會太高，可能導致資源耗盡。

如果達到連線限制上限，是否會影響授權並導致額外費用？

不會，沒有與此限制相關的授權或費用。這是一個技術限制。

目前使用量接近上限的程度？允許的上限是多少？

當連線數超過 750 時，將觸發警報。每個 AEM 執行個體的連線數上限為 1000 個。

此限制適用於 VPN 嗎？

可以，此限制適用於使用進階網路（包括VPN）的連線。

使用專用輸出IP時限制仍適用嗎？

是的，如果使用專用輸出 IP，仍然適用該限制。

recommendation-more-help

設定AEM as a Cloud Service的進階網路

概觀

要求和限制

設定和啟用進階網絡

彈性連接埠輸出

UI 設定

API 設定

流量路由

Apache / Dispatcher 設定

專用輸出 IP 位址

UI 設定

API 設定

流量路由

功能使用情況

偵錯考量

虛擬私人網路 (VPN)

UI 設定

API 設定

流量路由

供設定的實用網域

在環境中啟用進階網路設定

啟用使用 UI

啟用使用 API

編輯並刪除環境中的進階網路設定

使用 UI 編輯或刪除

使用 API 編輯或刪除

編輯和刪除程式的網路基礎結構

使用 UI 編輯和刪除

使用 API 編輯和刪除

變更程式的進階網路基礎架構類型

其他發佈區域的進階網路設定

專用的輸出 IP 位址

進階網路已在主要區域中啟用

尚未在任何區域中設定進階網路

VPN

疑難排解

連線集區

連線限制常見問題

連線限制只適用於非標準連接埠的輸出流量，還是適用於所有輸出流量？

傳出連線的數目似乎沒有大幅增加。 為什麼現在會收到通知？

過去是否曾經發生類似情況而不會觸發警報？

如果達到限制上限會發生什麼？

可以提高限制嗎？

AEM 系統會在一段時間後自動關閉連線嗎？

如果達到連線限制上限，是否會影響授權並導致額外費用？

目前使用量接近上限的程度？ 允許的上限是多少？

此限制適用於 VPN 嗎？

使用專用輸出IP時限制仍適用嗎？

傳出連線的數目似乎沒有大幅增加。為什麼現在會收到通知？

目前使用量接近上限的程度？允許的上限是多少？