AS3 端口

AS3 端口支援使用 Applicability Statement 3 (AS3) 協議傳送和接收檔案。

核心功能

結合 FTP 協議與 AS2 風格安全性的安全檔案傳輸
支援數字加密和簽章以增強安全性
生成並處理 MDN 回執，用於可靠的交付確認
支援帶過濾功能的上傳和下載操作
支援 TLS/SSL，並具備用戶端認證能力

概觀

每個 AS3 端口都配置為與單個 AS3 交易夥伴交換檔案。AS3 端口使用 FTP 協議傳輸檔案，並透過數字加密和簽章增加安全性和驗證。配置 AS3 交易關係需要交換 AS3 專用的配置檔案詳情，例如 AS3 ID 和數字憑證，以及目標 FTP 伺服器的連線詳情。

端口配置

本節包含所有可配置的端口屬性。

設定 Tab

交易夥伴資訊

用於識別並連線到特定 AS3 交易夥伴的設定。

設定	說明
端口 ID	端口的靜態唯一識別碼。
端口型別	顯示端口名稱及其功能說明。
端口描述	可選欄位，用於自由描述端口及其在工作流程中的作用。
AS3 ID	目標交易夥伴專用的 AS3 識別碼。

本地配置檔案

用於標識本地 AS3 配置檔案的設定。

設定	說明
本地 AS3 ID	你的 AS3 識別碼。
私密金鑰憑證	用於解密傳入訊息並簽章傳出訊息的憑證。
憑證密碼	存取本地私密金鑰憑證所需的密碼。

連線資訊

與目標 FTP 伺服器連線參數相關的設定。

設定	說明
主機	FTP 伺服器的主機名或 IP 地址。
端口	連線 FTP 伺服器所用的端口。
使用者	登入 FTP 伺服器的使用者名稱憑據。
密碼	登入 FTP 伺服器的密碼憑據。
TLS 型別	連線伺服器時如何協商 TLS/SSL。選擇 Explicit 時，將先建立純文字連線，然後透過顯式命令啟動 TLS/SSL。選擇 Implicit 時，不建立純文字連線，而是立即協商 TLS/SSL。
訊息傳送安全性	是否簽章和/或加密傳出的 AS3 訊息。強烈建議使用簽章和加密。
訊息接收安全性	是否要求傳入的 AS3 訊息包含簽章和加密。如果收到的訊息缺少必需的安全參數，將引發錯誤。
壓縮	是否壓縮傳出訊息的負載。
連線逾時時間	端口在擲回逾時錯誤之前等待連線回應的時長（秒）。

MDN 回執

與傳送 AS3 訊息時請求 MDN 相關的設定。

設定	說明
請求 MDN 回執	是否應傳回 MDN 回執以回應傳出的 AS3 訊息。強烈建議請求 MDN 回執。
MDN 路徑	夥伴上傳 MDN 回執的伺服器資料夾路徑。
安全性	MDN 回執是否應包含簽章塊，以驗證訊息完整性和接收者身份。強烈建議使用此選項。

上傳

與如何上傳傳出的 AS3 訊息相關的設定。

設定	說明
遠端路徑	傳出訊息應上傳到的遠端 FTP 伺服器資料夾路徑。

下載

與如何下載傳入的 AS3 訊息相關的設定。

設定	說明
遠端路徑	下載傳入訊息的遠端 FTP 伺服器資料夾路徑。
檔案掩碼	用於確定應下載遠端路徑中哪些檔案的 glob 模式（例如 *.txt）。
刪除檔案	成功下載檔案後，是否應從 FTP 伺服器刪除這些檔案。

交易夥伴憑證

與交易夥伴提供的公開金鑰憑證相關的設定。

設定	說明
加密憑證	傳送訊息時用於 AS3 加密的公開金鑰憑證。該憑證必須與交易夥伴的私密金鑰憑證配對，交易夥伴在共享 AS3 配置詳情時應提供此公開金鑰憑證。
驗證憑證	接收訊息時用於驗證 AS3 簽章的公開金鑰憑證。此欄位通常不是必需的；大多數 AS3 參與方使用同一個私密金鑰憑證進行簽章和解密。如果未指定此欄位，應用程式將使用加密憑證驗證簽章。
TLS 伺服器憑證	用於驗證 SSL/TLS 伺服器身份的公開金鑰憑證。僅當 FTP 伺服器要求 FTPS（基於 TLS/SSL 的 FTP）時才需要。如果交易夥伴未提供 TLS 伺服器憑證，可以將此設定留空，以允許底層 OS/JVM 執行憑證驗證；也可以將其設定為 `Any Certificate`，以無條件信任目標伺服器的身份。

進階 Tab

本地配置檔案

需要雙向 SSL 認證時，與用戶端認證相關的設定。

設定	說明
使用配置檔案	是否使用“配置檔案”頁面上配置的私密金鑰憑證作為用戶端認證的 TLS 憑證。
私密金鑰憑證	TLS 用戶端認證期間提供的私密金鑰憑證。僅當不使用“配置檔案”頁面中的同一私密金鑰憑證時適用。
憑證密碼	存取 TLS 用戶端憑證所需的密碼。

伺服器命令

進階設定

先前類別中未包含的設定。

設定	說明
主動模式	在遠端 FTP 伺服器上啟用主動模式還是被動模式。被動模式較少受到防火牆對連線的干擾。
明文命令通道	選中此項可使用明文通道而不是加密通道傳送 FTP 命令。
明文資料通道	選中此項可讓應用程式在與 FTP 伺服器通訊時使用明文資料通道。
加密演算法	加密傳出 AS3 訊息時使用的演算法。
EPSV	選中此項可使用擴充套件被動模式。如果需要使用 IPv4 以外的協議，這可能是必要的。
排除副檔名	端口不應處理的副檔名清單，用逗號分隔。
FSwitch	與 Simple Dir List 結合使用。選中此項可將目錄清單限制為僅包含檔案。
本地檔案命名方案	為端口輸出的訊息分配檔名的方案。可以在檔名中動態使用宏，以包含識別碼、時間戳等資訊。更多資訊，請參閱宏。
隱式 TLS 的 PROT 命令	告訴伺服器資料通道受隱式 TLS 連線保護。在設定 Tab 上選擇 TLS 型別。
被動模式遠端主機地址	僅在未設定主動模式時適用。留空時，應用程式將從先前伺服器回應中解析遠端主機以傳送回覆。選中此項後，應用程式將改用 RemoteHost 設定的值。
簽章演算法	簽章傳出訊息時使用的演算法。相應的 MDN 回執也會請求使用同一演算法。
Simple Dir List	當伺服器傳回無法解析的長回應，因而需要簡單目錄清單命令時，選中此項。設定後，如果端口仍無法解析目錄清單，請新增 FSwitch 設定，將目錄清單限制為僅包含檔案。
啟用的 TLS 協議	建立傳出連線時支援的 TLS/SSL 協議清單。最佳實踐是僅使用 TLS 協議。SSL v2 和 SSL v3 被認為存在漏洞，只有在夥伴不支援更高版本時才應使用。請注意，TLS v1.3 尚未被普遍採用，如果目標伺服器不支援，可能會被拒絕。
處理延遲	放入交易 Tab 的檔案延遲處理的時間（秒）。這是一箇舊設定。最佳實踐是使用檔案端口來管理本地檔案系統，而不是使用此設定。

代理設定

這是一組用於識別連線所經代理並對其進行身分驗證的設定。預設情況下，本節使用安全設定頁面的代理設定部分中的全域設定。清除此核取方塊可為您的端口提供特定的設定。

設定	描述
代理型別	基於代理的防火牆使用的協議。
代理主機	基於代理的防火牆的名稱或 IP 地址。
代理端口	基於代理的防火牆的 TCP 端口。
代理使用者	用於透過基於代理的防火牆進行身分驗證的使用者名稱。
代理密碼	用於對基於代理的防火牆進行身分驗證的密碼。
身分驗證方案	保留預設值 None 或選擇以下身分驗證方案之一：Basic、Digest、Proprietary 或 NTLM。

訊息

訊息設定確定端口如何搜尋訊息並在處理後管理它們。

注意：以下設定已棄用，預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本，請在工作流程中右鍵單擊該端口，選擇顯示成功路徑，然後將成功路徑連線到 File 端口。

設定	描述
儲存到已傳送資料夾（已棄用）	將端口處理的檔案複製到 Sent 資料夾。預設停用。儲存到 Sent 資料夾中的檔案不受靜態加密保護。
已傳送資料夾方案（已棄用）	按所選時間間隔對 Sent 資料夾中的檔案進行分組。僅在啟用儲存到已傳送資料夾時適用。

日誌

用於管理日誌建立和儲存的設定。

設定	描述
日誌級別	指定要記錄在端口日誌目錄中的資訊型別： None - 不建立任何日誌。 Error - 僅當端口遇到錯誤時才建立日誌。 Warning - 僅當端口發出警告時才建立日誌。 Info - 記錄工作流程的一般資訊，包括任何錯誤和警告（如果適用）。 Debug - 記錄成功和失敗工作流程的詳細偵錯資訊。 Trace - 記錄成功和失敗工作流程的詳細跟蹤資訊。請注意：Debug 和 Trace 級別的日誌可能會記錄敏感資訊，包括訊息內容和 SSL 憑證。儘管連線屬性（例如密碼）被遮蔽了，但在與您的組織外部共享它們之前，請檢視此級別的日誌以避免洩漏敏感資訊。
日誌資料夾結構	指示端口根據選定的時間間隔將日誌資料夾中的檔案分組。例如，Weekly 選項指示端口每週建立一個新的子資料夾，並將該周的所有日誌儲存在該資料夾中。空白設定告訴端口將所有日誌直接儲存在日誌資料夾中。對於處理許多交易的端口，使用子資料夾有助於保持日誌的有序性並提高效能。
保留訊息副本	指示端口在日誌目錄中儲存最新訊息副本的切換。請注意，端口每個子資料夾只保留一個訊息，並且端口在再次執行時會覆蓋以前儲存的訊息。

其他

特殊設定適用於特定用例。

設定	描述
其他設定	允許在以分號分隔的清單中配置隱藏的端口設定，例如 `setting1=value1;setting2=value2`。正常的端口用例和功能不需要使用這些設定。

自動化 Tab

自動化設定

與端口自動處理檔案相關的設定。

設定	說明
上傳	到達端口的檔案是否應自動上傳。
重試間隔	重試失敗上傳前等待的分鐘數。
最大嘗試次數	端口處理輸入檔案的最大次數。是否成功取決於伺服器成功確認以及回執驗證（同步請求回執時）。如果設定為 0，端口將無限期重試該檔案。
重發間隔	重新傳送未確認訊息前等待的分鐘數。當伺服器收到檔案，但未在預期時間範圍內提供非同步 MDN 回執時，將觸發重發。
最大嘗試次數（非同步）	請求非同步回執時，端口處理輸入檔案的最大次數。是否成功取決於伺服器成功確認後，非同步回執是否在重發間隔內傳回。如果未傳回成功的伺服器確認，則改用最大嘗試次數。如果設定為 0，端口將無限期重發該檔案。
接收	端口是否應自動輪詢遠端下載路徑以查詢要下載的檔案。
間隔	自動下載嘗試之間的間隔。
整點後分鍾數	小時計劃的分鐘偏移量。僅當上述間隔設定為_每小時_時適用。例如，如果此值設定為 5，自動化服務將在 1:05、2:05、3:05 等時間下載。
時間	嘗試發生的具體時間。僅當上述間隔設定為_每天_、_每週_或_每月_時適用。
日期	嘗試發生的日期。僅當上述間隔設定為_每週_或_每月_時適用。
分鐘數	嘗試下載前等待的分鐘數。僅當上述間隔設定為_分鐘_時適用。
Cron 運算式	表示 cron 運算式的五段字串，用於確定嘗試發生的時間。僅當上述間隔設定為_進階_時適用。
開始日期和時間	自動化首次執行的日期和時間。之後的每次執行都遵循上方的間隔設定。上次和下次執行時間顯示在自動化狀態區段中。

自動化狀態

效能

與端口資源分配相關的設定。

設定	描述
最大工作執行緒數	此端口上處理檔案時從執行緒池中消耗的最大工作執行緒數。如果設定，則會覆蓋進階設定頁面的效能設定部分的預設設定。
最大檔案數	分配給端口的每個執行緒傳送的最大檔案數。如果設定，則會覆蓋進階設定頁面的效能設定部分的預設設定。

警示 Tab

SLA Tab

建立連線

要連線到遠端 FTP 伺服器，請指定伺服器所需的主機、端口、使用者、密碼和 TLS 型別。使用測試連線按鈕驗證連線參數是否正確。連線後，請設定上傳和下載的遠端路徑，以便從適當位置放置和讀取檔案，從而與交易夥伴通訊。

自動快取清理

知行之橋會自動清理資源快取。此過程在每次接收週期的後臺執行，刪除遠端伺服器上已不存在的檔案對應的過期快取項目。這使得快取大小始終保持在可管理範圍內，無需任何手動操作。

預設情況下，檔案保留 30 天，但您可以在進階索引標籤的其他設定欄位中使用 ResourceCacheRetentionDays 設定來調整保留時間以適應您的環境。例如，ResourceCacheRetentionDays=15 表示檔案保留 15 天后將被刪除。

同樣的快取清理過程也適用於 MDN 回執。

入門指南

工作流

EDI 交易夥伴管理控制台

端口

對映

系統 API

操作指南

腳本編寫

軟體許可和第三方版權

核心功能

概觀

端口配置

設定 Tab

交易夥伴資訊

本地配置檔案

連線資訊

MDN 回執

上傳

下載

交易夥伴憑證

進階 Tab

本地配置檔案

伺服器命令

進階設定

代理設定

訊息

日誌

其他

自動化 Tab

自動化設定

自動化狀態

效能

警示 Tab

SLA Tab

建立連線

自動快取清理

宏

範例

​核心功能

​概觀

​端口配置

​設定 Tab

​交易夥伴資訊

​本地配置檔案

​連線資訊

​MDN 回執

​上傳

​下載

​交易夥伴憑證

​進階 Tab

​本地配置檔案

​伺服器命令

​進階設定

​代理設定

​訊息

​日誌

​其他

​自動化 Tab

​自動化設定

​自動化狀態

​效能

​警示 Tab

​SLA Tab

​建立連線

​自動快取清理

​宏

​範例

核心功能

概觀

端口配置

設定 Tab

交易夥伴資訊

本地配置檔案

連線資訊

MDN 回執

上傳

下載

交易夥伴憑證

進階 Tab

本地配置檔案

伺服器命令

進階設定

代理設定

訊息

日誌

其他

自動化 Tab

自動化設定

自動化狀態

效能

警示 Tab

SLA Tab

建立連線

自動快取清理

宏

範例