Oracle EBS 整合實戰：Web Service 介面層架構設計、安全通訊與標準請求交互模式

整體架構：雙層分離

┌─────────────────────────────────────┐
│      第三方廠商系統 (總部/海外 IDC)  │
└──────────────┬──────────────────────┘
               │ HTTPS / Web Service
┌──────────────▼──────────────────────┐
│        WS 介面層 (Windows + IIS)     │
│  - 安全驗證 (API Key / JWT / mTLS)   │
│  - 請求路由 / 格式轉換 / 錯誤包裝    │
└──────────────┬──────────────────────┘
               │ JDBC / OCI
┌──────────────▼──────────────────────┐
│      Oracle EBS 核心區               │
│  - 正式表 (Base Tables)             │
│  - 介面表 (Interface Tables)        │
│  - 標準請求 (Concurrent Programs)   │
└─────────────────────────────────────┘

技術需求分類與處理模式

標準請求機制

• EBS 內建 Concurrent Program，負責驗證、轉換、導入正式表。
• 錯誤記錄於介面表錯誤欄位或專用錯誤表，WS 讀取回傳給呼叫端。
• 優點：保留 EBS 業務邏輯、觸發器、鎖定機制，避免直接寫表破壞一致性。

Web Service 介面層關鍵實作

1. 安全通訊

• 傳輸層：強制 HTTPS (TLS 1.2+)。
• 應用層驗證：每個第三方系統分配唯一 32 字節 API Key，請求 Header 攜帶 X-API-Key，雙向驗證 (請求/回應皆簽章)。
• IP 白名單 + API Key 雙重防護。

2. 介面契約設計

• 採用 RESTful JSON (首選) 或 SOAP XML，跨語言/平台。
• 統一回應格式：

  {
    "success": true,
    "data": { ... },
    "error": { "code": "", "message": "" },
    "trace_id": "uuid"
  }

• 冪等性設計：關鍵寫入 API 支援 Idempotency-Key，防重複提交。

3. 非同步處理流程

1. WS 接收請求 → 寫入介面表 → 回傳 202 Accepted + request_id。
2. 背景 Worker 提交標準請求 (DBMS_SCHEDULER / Concurrent Manager)。
3. 第三方系統輪詢 GET /status/{request_id} 或註冊 Webhook 回調。

部署拓撲建議

• WS 伺服器置於 DMZ，僅開放 443 埠對外，內網連線 EBS 資料庫 (1521/2484)。
• 高可用：WS 叢集 (NLB/HAProxy) + Oracle RAC / Data Guard。
• 監控：API 延遲、錯誤率、佇列積壓、標準請求完成狀態。

結語

EBS 整合核心原則：「不繞過介面表、不繞過標準請求、介面層統一安全與協議轉換」。Web Service 層將資料庫連線封裝為標準 HTTPS API，解決跨網段、跨平台、安全合規等難題，是現代化 EBS 整合的標準架構。