AS4 端口 - 知行之桥文档

AS4 端口支援使用 Applicability Statement 4 (AS4) 協議傳送和接收訊息。

核心功能

現代基於 SOAP 的 B2B 訊息傳遞，支援多種配置檔案（ENTSOG、e-SENS、BDEW 和 eDelivery）
具有權杖認證和憑證管理的進階安全功能
支援推送和拉取兩種訊息模式
支援透過服務和操作定義處理業務協議
全面支援訊息屬性和自定義請求頭
已獲得 Drummond Group 認證

概觀

AS4 連線需要在兩個位置進行配置。首先在 AS4 配置檔案頁面配置本地 AS4 參與方識別碼和私密金鑰憑證。然後，為單個交易夥伴在各個 AS4 端口中配置專用連線設定。當輸入檔案由 AS4 端口處理時，它會被打包並傳送到指定的交易夥伴。當知行之橋透過 AS4 接收檔案時，會嘗試將檔案路由到特定的 AS4 端口。應用程式使用 AS4 訊息中的 AS4 參與方識別碼來確定應由哪個 AS4 端口接收該檔案。檔案路由到 AS4 端口後，會放入該端口的交易 Tab，或傳遞到工作流程中下一個已連線的端口。 AS4 端口支援共享連線。這意味著在一個端口中建立的連線和配置也會顯示在設定 > 連線 Tab 中，以便在其他 AS4 端口中重複使用。

配置檔案配置

必須先配置 AS4 配置檔案，才能與各個 AS4 端口建立連線。單擊導覽列上的配置檔案，然後單擊 AS4 Tab。

AS4 配置檔案 Tab

個人 ID

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

設定	說明
參與方識別碼	你的 AS4 識別碼。知行之橋傳送的訊息必須定址到此識別碼，傳出訊息也使用此值標識訊息發起方。識別碼區分大小寫。
參與方識別碼型別	參與方識別碼的可選型別宣告。如果指定，請提供該識別碼所屬的域。

個人憑證

與私有解密憑證和可選簽章憑證相關的設定。

設定	說明
私密金鑰憑證	用於解密傳入訊息的私密金鑰憑證；除非設定了單獨的簽章憑證，否則也用於簽章傳出訊息。切勿與外部方共享此憑證。單擊建立憑證按鈕可生成可用於 AS4 交易的自簽章憑證；同時還會生成一個同名、副檔名為 `.cer` 的對應公開金鑰憑證。支援 PKCS#12 憑證（.pfx 或 .p12）。
私密金鑰憑證密碼	存取私密金鑰憑證所需的密碼。
簽章憑證	用於簽章傳出訊息的可選私密金鑰憑證。設定後，將使用它代替私密金鑰憑證進行簽章。當交易夥伴要求使用單獨的簽章和解密憑證時（例如 eDelivery V2 或 ENTSOG V4 配置檔案），請設定此項。
簽章憑證密碼	存取簽章憑證所需的密碼。

輪轉憑證

設定	說明
輪轉私密金鑰憑證	一個輔助私密金鑰憑證；如果使用私密金鑰憑證解密失敗，可用它解密傳入訊息。僅在更換憑證且需要重疊期以接收使用舊憑證或新憑證加密的傳入訊息時，才使用此設定。輪轉憑證絕不會用於簽章傳出訊息；傳送給仍在使用舊憑證的交易夥伴時，這可能導致簽章驗證問題。
輪轉私密金鑰憑證密碼	存取輪轉私密金鑰憑證所需的密碼。

日誌

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

設定	描述
日誌級別	端口生成的日誌的詳細程度。當請求支援時，請將其設定為 Debug。
日誌輪換間隔	建立新日誌檔案之前等待的天數。
日誌刪除間隔	刪除舊日誌檔案之前等待的天數。

應用程式 URL

與從公網存取知行之橋相關的設定和顯示值。

設定	說明
接收 URL	知行之橋偵聽傳入 AS4 訊息的 URL。請與所有交易夥伴共享此 URL。

其他

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

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

端口配置

配置全域 AS4 配置檔案設定後，可在工作流程頁面為每個交易夥伴建立並配置單獨的 AS4 端口。

設定 Tab

配置

設定	說明
端口 ID	端口的靜態唯一識別碼。
端口型別	顯示端口名稱及其功能說明。
端口描述	可選欄位，用於自由描述端口及其在工作流程中的作用。
連線	可用 AS4 連線清單。選擇現有連線，或單擊建立新增新連線。有關新增連線頁面中選項的說明，請參閱建立連線。

連線資訊

與指定交易夥伴連線參數相關的設定。

設定	說明
訊息傳送安全性	是否簽章和/或加密傳出的 AS4 訊息。強烈建議使用簽章和加密。
訊息接收安全性	是否要求傳入的 AS4 訊息包含簽章和/或加密。如果收到的訊息缺少必需的安全參數，將引發錯誤。
壓縮	是否壓縮傳出訊息的負載。
訊息分割區通道	AS4 交換應透過的通道。如果未指定通道，則會隱式分配預設訊息分割區通道（MPC）。傳送或接收拉取請求時，MPC 很重要，因為只有分配的 MPC 中排隊的訊息才會作為拉取請求的回應傳回。

回執

與傳送 AS4 訊息時請求回執相關的設定。

設定	說明
啟用回執	是否應傳回回執以回應傳入 AS4 訊息，以及是否期望對傳出的 AS4 訊息傳回回執。
傳輸	回執是作為傳出 AS4 訊息的直接回應傳回（同步），還是稍後透過單獨連線傳回（非同步）。除非 AS4 訊息非常大（常見閾值為 50MB），導致處理訊息並傳遞同步回執可能使連線逾時時長緊張，否則建議使用同步回執。

業務協議詳情

與 AS4 業務協議共享詳情相關的設定。配置前應與交易夥伴確認這些值。

設定	說明
服務	接受訊息的業務流程。
服務操作	業務流程中正在執行的操作或活動。
服務型別	為服務提供上下文的可選限定符。
傳送方角色	訊息來源方的角色。根據夥伴協議，傳送和接收 AS4 請求時這些角色可以顛倒，也可以保持不變。此值用於生成的 AS4 SOAP 信封的 `PartyInfo` 元素中。
接收方角色	訊息交付目標方的角色。根據夥伴協議，傳送和接收 AS4 請求時這些角色可以顛倒，也可以保持不變。此值用於生成的 AS4 SOAP 信封的 `PartyInfo` 元素中。

進階設定

設定	說明
本地檔案命名方案	為端口輸出的訊息分配檔名的方案。可以在檔名中動態使用宏，以包含識別碼、時間戳等資訊。更多資訊，請參閱宏。

進階 Tab

訊息屬性

可以提供一組以名稱-值對形式指定的自定義訊息屬性，作為傳出訊息的一部分包含在內。在 UI 中設定名稱-值對，等同於在訊息到達 AS4 端口之前對訊息執行 <arc:set attr="Header:AS4-MessageProperty" value="Name=Value" />。可以根據訊息內容動態覆蓋訊息屬性，或指定 string 以外的型別。為此，請使用類似以下指令碼新增訊息頭：

<arc:set attr="Header:AS4-MessageProperty" value="PModeName=http://example.org/pmode;Country=LU" />
<arc:set attr="Header:AS4-MessagePropertyType" value="PModeName=string;Country=string" />

AS4-MessagePropertyType 中指定的名稱必須與 AS4-MessageProperty 中使用的名稱匹配。多個屬性用分號分隔。例如，以下範例在上述指令碼基礎上擴充套件了一個 integer 屬性：

<arc:set attr="Header:AS4-MessageProperty" value="PModeName=http://example.org/pmode;Country=LU;MessageCount=5" />
<arc:set attr="Header:AS4-MessagePropertyType" value="PModeName=string;Country=string;MessageCount=integer" />

其他設定

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

設定	說明
附加 XML 檔案	XML 負載應作為 MIME 附件打包到 SOAP 訊息中，還是直接包含在 SOAP 正文中。
重複訊息操作	當端口收到包含此前見過的 Message Id 的 AS4 訊息時，應如何處理。端口透過_記住_在重複間隔指定分鐘數內接收的 Message Id 來檢測重複訊息。選項：繼續 — 像處理其他檔案一樣處理重複檔案。忽略 — 忽略傳入檔案，且不將其寫入接收資料夾。失敗 — 引發錯誤且不處理該檔案。
重複間隔	具有相同 Message Id 的訊息被視為重複的分鐘數。如果設定為 0，Message Id 將一直儲存到伺服器重啟。
拉取 URL	傳送拉取請求的 URL 端點。僅當它與夥伴 URL 不同時才需要。
回執 URL	傳送回執的 URL 端點。僅當它與夥伴 URL 不同時才需要。
處理延遲	放入交易 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

自動化設定

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

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

自動化狀態

效能

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

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

警示 Tab

SLA Tab

建立連線

建立新連線時，首先提供一個名稱，然後完成以下設定。 用於識別並連線到特定 AS4 交易夥伴的設定。

設定	說明
參與方識別碼	目標交易夥伴專用的 AS4 參與方識別碼。此值用於傳出請求的報頭中以指示預期接收者，也用於將傳入的 AS4 訊息路由到相應的 AS4 端口。識別碼區分大小寫。
參與方識別碼型別	參與方識別碼的可選型別宣告。如果指定，請提供該識別碼所屬的域。
URL	傳送傳出 AS4 訊息的交易夥伴公共端點。
協議	管理交換的共享 AS4 協議。在 ENTSOG 配置檔案中，此項為必需。
連線逾時（秒）	端口在擲回逾時錯誤之前等待連線回應的時長（秒）。
配置檔案	AS4 交換中使用的 AS4 配置檔案。配置檔案有助於確定共享配置設定，以確保夥伴之間相容。可用配置檔案包括：`Standard`、`ENTSOG`、`e-SENS`、`BDEW`、`ENTSOG V4` 和 `eDelivery V2`。如果使用 BDEW，則需要一些額外配置。詳情請參閱配置 BDEW 配置檔案。多個進階設定（包括加密演算法、簽章演算法、安全權杖格式和 SSL 啟用協議）允許選擇 `Auto` 值。使用 `Auto` 時，端口會根據配置檔案設定自動為每個設定選擇適當的值。如有需要，仍可手動覆蓋這些值。
加密憑證	傳送訊息時用於 AS4 加密的公開金鑰憑證。該憑證必須與交易夥伴的私密金鑰憑證配對，交易夥伴在共享 AS4 配置詳情時應提供公開金鑰憑證。
驗證憑證	接收訊息時用於驗證 AS4 簽章的公開金鑰憑證。此欄位通常不是必需的；大多數 AS4 參與方使用同一個私密金鑰憑證進行簽章和解密。如果未指定此值，應用程式將使用加密憑證驗證簽章。
TLS 伺服器憑證	用於驗證 TLS/SSL 伺服器身份的公開金鑰憑證。如果交易夥伴未提供 TLS 伺服器憑證，可以將此設定留空，以允許底層 OS/JVM 執行憑證驗證；也可以將其設定為 `Any Certificate`，以無條件信任目標伺服器的身份。
輪轉驗證憑證	一個輔助憑證；如果使用驗證憑證驗證失敗，可用它驗證訊息簽章。僅在更換憑證且需要重疊期時使用此設定。

進階連線設定

單擊進階 Tab 設定以下連線選項。

權杖認證

與使用和要求權杖認證相關的設定。

設定	說明
權杖認證（接收）	傳入 AS4 訊息是否必須包含認證權杖。如果啟用，傳入訊息必須包含與此選項下設定的使用者名稱和密碼欄位匹配的使用者名稱憑據。
權杖認證（傳送）	傳出 AS4 訊息是否應包含認證權杖。如果啟用，傳出訊息將包含與此選項下設定的使用者名稱和密碼欄位匹配的使用者名稱憑據。
密碼型別	使用者名稱權杖應採用純文字格式還是加密摘要格式。

備用本地配置檔案

此特定 AS4 端口中用於覆蓋配置檔案頁面 AS4 配置的設定。設定備用本地配置檔案後，可以為某些交易夥伴使用不同的本地憑證和識別碼。

設定	說明
參與方識別碼	你的 AS4 識別碼。覆蓋“配置檔案”頁面上的參與方識別碼。
參與方識別碼型別	你的 AS4 識別碼型別（可選）。覆蓋“配置檔案”頁面上的參與方識別碼型別。
私密金鑰憑證	用於解密傳入訊息的私密金鑰憑證；除非設定了單獨的簽章憑證，否則也用於簽章傳出訊息。覆蓋“配置檔案”頁面上的私密金鑰憑證。
私密金鑰憑證密碼	存取本地私密金鑰憑證所需的密碼。
簽章憑證	用於簽章傳出訊息的可選私密金鑰憑證。設定後，覆蓋“配置檔案”頁面上的簽章憑證。
簽章憑證密碼	存取簽章憑證所需的密碼。
憑證主題	指定憑證庫中本地憑證的唯一名稱（DN），用於簽章或解密訊息。

TLS 用戶端認證

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

設定	說明
使用配置檔案設定	是否使用“配置檔案”頁面上配置的私密金鑰憑證作為用戶端認證的 TLS 憑證。
私密金鑰憑證	TLS 用戶端認證期間提供的私密金鑰憑證。僅當不使用“配置檔案”頁面中的同一私密金鑰憑證時適用。
私密金鑰憑證密碼	存取 TLS 用戶端憑證所需的密碼。
憑證主題	指定憑證庫中本地憑證的唯一名稱（DN），用於 TLS 認證。

其他設定

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

設定	說明
協議引用 P-Mode	共享 AS4 協議的處理模式屬性。如果使用此項，請提供 `PMode.Id` 參數。
接收協議引用 P-Mode	共享 AS4 接收協議的處理模式屬性。如果使用此項，請提供 `PMode.Id` 參數。
協議引用型別	共享 AS4 協議的引用型別屬性。雙方應協商確定此值的含義。
加密演算法	如果需要訊息加密，應使用哪種加密演算法。
安全權杖格式	指定在加密和簽章時包含在訊息中的安全權杖格式。選項： Auto（根據配置檔案自動選擇）。 X.509（DN 格式的主題）。 Binary（Base64 編碼的公開金鑰）。 KeyIdentifier（X.509 Subject-Key-Identifier 格式）。 BinaryPKIPath（Base64 編碼的 X509 公開金鑰憑證有序清單）。
簽章安全權杖格式	指定簽章時使用的安全權杖格式（可選）。如果設定此值，則簽章時將使用該值，而不是安全權杖格式的值。選項： Auto（根據配置檔案自動選擇）。 X.509（DN 格式的主題）。 Binary（Base64 編碼的公開金鑰）。 KeyIdentifier（X.509 Subject-Key-Identifier 格式）。 BinaryPKIPath（Base64 編碼的 X509 公開金鑰憑證有序清單）。
簽章演算法	簽章傳出訊息時使用的演算法。相應回執也會請求使用同一演算法。設定為 `Auto` 時，端口會根據選定配置檔案自動選擇適當的值。
啟用的 TLS 協議	建立傳出連線時支援的 TLS/SSL 協議清單。最佳實踐是僅使用 TLS 協議。SSL v2 和 SSL v3 被認為存在漏洞，只有在夥伴不支援更高版本時才應使用。請注意，TLS v1.3 尚未被普遍採用，如果目標伺服器不支援，可能會被拒絕。
簽章憑證	用於為此端口簽章傳出訊息的可選私密金鑰憑證。設定後，覆蓋 AS4 配置檔案頁面上配置的簽章憑證。
簽章憑證密碼	存取和使用與簽章憑證關聯的私密金鑰所需的密碼。
RSA 雜湊演算法	RSA 簽章操作中用於建立訊息摘要的加密雜湊演算法（例如 SHA-256）。
引用雜湊演算法	引用中使用的加密雜湊演算法（例如 SHA-256），用於確保單個訊息部分的完整性。
標準化頒發者主題	允許標準化憑證頒發者和主題唯一名稱的格式，以實現一致的憑證驗證。預設值為 `false`。
金鑰加密演算法	用於加密保護訊息負載的對稱會話金鑰的演算法（例如 RSA-OAEP 或 RSA-v1.5）。
MGF1 雜湊演算法	金鑰加密期間作為 RSA-OAEP 填充一部分，在掩碼生成函式 1（MGF1）中使用的雜湊演算法。
OAEP 參數	最佳非對稱加密填充（OAEP）中使用的可選參數，用於在 RSA 加密期間提供額外隨機化。
轉換回執	在簽章前對回執和確認訊息應用 XML 規範化或其他轉換的設定。預設值為 `true`。
簽章拉取請求	是否對傳送的 AS4 拉取請求訊息進行數字簽章，以從交易夥伴伺服器檢索訊息。
啟用引用權杖型別	是否在訊息頭中包含安全權杖引用資訊，以指定如何識別憑證和金鑰。
接收方金鑰	訊息接收方的公開金鑰或憑證，用於加密訊息負載以進行機密傳輸。
金鑰派生方法	AS4 安全處理中用於從共享金鑰或金鑰協商協議派生加密金鑰的演算法。

配置 BDEW 配置檔案

BDEW（Bundesverband der Energie- und Wasserwirtschaft，即德國能源和水工業聯合會）AS4 配置檔案是由德國能源和水務行業定義的訊息規範。配置 AS4 端口使用 BDEW 配置檔案時，必須先新增以下訊息頭，然後才能將訊息傳遞給端口。

<arc:set attr="output.header:AS4-DataProperty#" value="[Filename]; BDEWDocumentType=MSCONS" />
<arc:set attr="output.header:AS4-DataProperty#" value="[Filename]; BDEWDocumentDate=202205011630" />
<arc:set attr="output.header:AS4-DataProperty#" value="[Filename]; BDEWDocumentNo=1234567AB" />
<arc:set attr="output.filepath" value="[filepath]" />
<arc:push item="output" />

個人配置檔案配置

AS4 配置檔案包含交易夥伴用於識別你的關鍵資訊。它在“配置檔案”頁面的 AS4 Tab 中配置。首先，請指定以下資訊：

參與方識別碼
個人憑證

參與方識別碼

與電子郵件交換中的電子郵件地址類似，它用於標識 AS4 傳輸中的夥伴。將參與方識別碼設定為能有意義地標識你或你的組織的值。此處設定的值會在知行之橋發起的 AS4 傳輸標頭中傳送。參與方識別碼是共享配置檔案資訊時與交易夥伴交換的資訊之一。交易夥伴應在其 AS4 系統中使用此值，以便處理來自該識別碼的請求。

個人憑證

私密金鑰憑證用於解密傳入訊息；除非配置了單獨的簽章憑證，否則也用於簽章傳出訊息。AS4 配置檔案使用 PKCS#12 格式（.pfx 或 .p12 檔案）的私密金鑰憑證。某些 AS4 配置檔案（包括 eDelivery V2 和 ENTSOG V4）要求簽章和解密使用不同的憑證。在這些情況下，除了私密金鑰憑證外，還需要配置簽章憑證。簽章憑證是僅用於簽章傳出訊息的獨立私密金鑰憑證；私密金鑰憑證仍用於解密。

配置簽章憑證後，驗證憑證欄位必須填入交易夥伴簽章憑證的公開金鑰，而不是其加密憑證。如果兩者不匹配，傳出訊息將因簽章驗證錯誤而失敗。

如果使用要求簽章和解密憑證分離的配置檔案（例如 eDelivery V2 或 ENTSOG V4），交易夥伴很可能也使用單獨的簽章憑證。在這種情況下，請與交易夥伴確認用於簽章驗證的憑證，並將驗證憑證設定為其簽章憑證的公開金鑰，而不是其加密憑證。

在私密金鑰憑證下拉功能表中單擊上傳憑證，從磁碟選擇現有憑證。
單擊建立憑證建立新的自簽章憑證。這會建立一個新的私密金鑰憑證以及同名的公開金鑰憑證（.cer 檔案）。

接收 URL

此值基於設定 > 進階中的基礎 URL 和預設的知行之橋偵聽端點生成。請與交易夥伴共享此值，以便他們能夠成功向知行之橋傳送 AS4 訊息。

交易夥伴設定

交易夥伴負責提供連線其 AS4 端點所需的特定設定。每個 AS4 端口都必須配置為單一交易夥伴關係。以下 AS4 配置選項為必需：

交易夥伴識別碼
夥伴 URL
交易夥伴憑證
使用回執
服務和服務操作

交易夥伴識別碼

交易夥伴提供其參與方識別碼，這是其配置檔案中用於在 AS4 傳輸中標識組織的部分。該識別碼用於傳出請求的標頭，以指示預期接收者。

此值區分大小寫，因此配置新的交易夥伴時，請確保大小寫正確。

夥伴 URL

夥伴 URL 是交易夥伴的 AS4 系統偵聽傳入訊息的公共端點。收到交易夥伴提供的 URL 後，請使用 Web 瀏覽器測試該 URL，以檢測任何網路或連線問題。在某些情況下，如果交易夥伴使用不同 URL 推送 AS4 傳輸、拉取 AS4 傳輸以及傳回非同步回執，可能會提供多個 URL。請在“進階” Tab 的拉取 URL 和回執 URL 下配置其他 URL。

交易夥伴憑證

每個 AS4 端口都必須配置目標交易夥伴的公開金鑰憑證。交易夥伴會提供加密和驗證與其交換的 AS4 訊息所需的憑證。知行之橋接受 X.509 公開金鑰憑證（副檔名為 .cer、.der 或 .pem 的檔案）。通常，交易夥伴會提供一個憑證，應將其配置在加密憑證欄位中。如果交易夥伴提供多個憑證，則必須說明每個憑證的用途。如果夥伴提供完整憑證鏈（例如從商業憑證頒發機構取得），則只需配置葉子憑證（憑證鏈中的最後一個憑證）。有時可能需要單獨的公開金鑰憑證來驗證夥伴的數字簽章。在這種情況下，請在設定 Tab > 交易夥伴憑證 > 驗證憑證中設定簽章驗證憑證。如果交易夥伴要求 TLS/SSL 連線，他們可以提供其 TLS 伺服器的公開金鑰憑證。應在 TLS 伺服器憑證下設定該憑證。或者，可以將此欄位設定為 Any Certificate，以隱式信任目標 TLS 伺服器的身份。

使用回執

請求回執可確保 AS4 訊息的不可否認性；換句話說，訊息成功送達後不可被否認。因此，強烈建議啟用使用回執欄位。請務必提前與交易夥伴就回執使用達成一致。預設情況下，回執會同步傳遞，也就是作為 AS4 訊息的直接回應傳回。非同步回執則稍後透過單獨連線傳遞。除非 AS4 訊息非常大，導致處理並傳遞同步回執可能使連線逾時時長緊張，否則建議使用同步回執。

服務和服務操作

服務、服務操作和其他業務協議詳情應與交易夥伴溝通確認。這些值有助於定義與所交換 AS4 訊息關聯的業務邏輯，以及各方應如何解讀這些訊息。

從 SMP 匯入

如果交易夥伴具有服務中繼資料釋出者（SMP）配置檔案，可以在設定 Tab > 交易夥伴資訊中單擊從 SMP 匯入按鈕匯入這些設定。隨後出現的提示需要提供用於取得 SMP 配置檔案的 SML 域、參與者 ID 和 Scheme，以及文件 ID 和 Scheme。端口設定會自動填充從 SMP 配置檔案讀取的值。

傳送和接收檔案

配置 AS4 配置檔案和特定於夥伴的 AS4 端口後，即可安全地傳送和接收檔案。

傳送檔案

在 AS4 端口中，交易 Tab 顯示應傳送到目標交易夥伴的檔案。如果在自動化 Tab 上啟用了傳送自動化，到達端口交易 Tab 的檔案會自動封裝並傳送。展開與已傳輸檔案關聯的行，即可存取所有傳輸的日誌檔案。 建立測試檔案按鈕可生成一組簡單的測試檔案，以傳送給交易夥伴。

重發和重試

當預期交易夥伴傳回非同步回執，但其未在重發間隔時長內（預設為 60 分鐘）傳回時，將觸發 AS4 重發。隨後應用程式會嘗試重新傳送該傳輸。應用程式將繼續重發訊息，直到收到回執或**最大嘗試次數（非同步）**用盡為止。當交易夥伴的 HTTP 回應表明伺服器未收到傳輸（回應不是肯定的 200 OK 狀態）時，將觸發重試。這可能表示網路或連線問題，且通常是暫時性的。應用程式每隔重試間隔分鐘重試一次傳輸，直到傳輸被接收或最大嘗試次數用盡為止。

接收檔案

在 AS4 端口中，交易 Tab 顯示應用程式已接收並路由到該端口的檔案（基於傳入 AS4 訊息中的 AS4 識別碼）。展開每個檔案行可顯示該傳輸的可用日誌清單。這些檔案可在端口的交易 Tab 中檢視。如果端口連線到工作流程中的其他端口，檔案會自動從 AS4 端口的交易 Tab 移動到工作流程中下一個端口的交易 Tab。

​核心功能

​概觀

​配置檔案配置

​AS4 配置檔案 Tab

​個人 ID

​個人憑證

​輪轉憑證

​日誌

​應用程式 URL

​其他

​端口配置

​設定 Tab

​配置

​連線資訊

​回執

​業務協議詳情

​進階設定

​進階 Tab

​訊息屬性

​其他設定

​代理設定

​訊息

​日誌

​其他

​自動化 Tab

​自動化設定

​自動化狀態

​效能

​警示 Tab

​SLA Tab

​建立連線

​進階連線設定

​權杖認證

​備用本地配置檔案

​TLS 用戶端認證

​其他設定

​配置 BDEW 配置檔案

​個人配置檔案配置

​參與方識別碼

​個人憑證

​接收 URL

​交易夥伴設定

​交易夥伴識別碼

​夥伴 URL

​交易夥伴憑證

​使用回執

​服務和服務操作

​從 SMP 匯入

​傳送和接收檔案

​傳送檔案

​重發和重試

​接收檔案

​宏

​範例

核心功能

概觀

配置檔案配置

AS4 配置檔案 Tab

個人 ID

個人憑證

輪轉憑證

日誌

應用程式 URL

其他

端口配置

設定 Tab

配置

連線資訊

回執

業務協議詳情

進階設定

進階 Tab

訊息屬性

其他設定

代理設定

訊息

日誌

其他

自動化 Tab

自動化設定

自動化狀態

效能

警示 Tab

SLA Tab

建立連線

進階連線設定

權杖認證

備用本地配置檔案

TLS 用戶端認證

其他設定

配置 BDEW 配置檔案

個人配置檔案配置

參與方識別碼

個人憑證

接收 URL

交易夥伴設定

交易夥伴識別碼

夥伴 URL

交易夥伴憑證

使用回執

服務和服務操作

從 SMP 匯入

傳送和接收檔案

傳送檔案

重發和重試

接收檔案

宏

範例