API Designer 中 Webhook API 的 CORS 設定指南
跨網域資源共享 (CORS) 是一種瀏覽器安全機制,它限制網頁向服務於該網頁的網域以外的其他網域發出請求。這樣做是為了保護用戶免受惡意網站未經許可嘗試訪問其他網站的敏感資料的侵害。
概覽
Vtiger 的 API 設計器是一個強大的工具,它為開發人員提供了一個工作台,幫助他們輕鬆建立基於 HTTP 的自訂 API。這些 API 可以與 VTAP JavaScript API 或外部應用程式無縫整合。
我們在 API 設計器中新增了一項功能,用於指定允許的網域名稱(可列入白名單的網域)。只有這些列入白名單的網域才被允許發出 CORS 請求。
讓我們進一步了解CORS及其應用。
目標
啟用 CORS 的主要目標:
技術實施
在 API 設計器中建立 Webhook API 時,可以選擇 新增網域 到配置中。此網域代表將從 Vtiger 發出請求或接收資料的來源(網站或應用程式)。
新增網域後:
此設定可確保 webhook API 可以安全地按預期運行,而無需後端代理或變通方法,同時仍可控制哪些網域可以與 Vtiger 互動。
例
如果託管在 https://app.example.com 上的 Web 應用程式嘗試向 https://api.vtiger.com 上的 API 發送請求,則瀏覽器將阻止該請求,除非 API 透過 CORS 標頭明確允許該請求。
為了使這種互動成為可能且安全,伺服器必須使用特殊的標頭(如 Access-Control-Allow-Origin)進行回應,以告知瀏覽器哪些來源(網域)被允許存取它。
對於 Vtiger 來說,啟用 CORS 白名單 允許受信任的網域與 CRM 互動(例如傳送 webhook 請求或呼叫 API),而不會被瀏覽器阻止。
用例
您有一個託管在 https://portal.mycompany.com 的前端應用程序,該應用程式需要將 webhook API 請求發送到 https://crm.mycompany.com 上的 Vtiger CRM 實例。
問題
瀏覽器因 CORS 錯誤阻止了請求:從來源「https://portal.mycompany.com」訪問「https://crm.mycompany.com/webhook」的存取已被 CORS 策略阻止。
解決方案 將 https://portal.mycompany.com 新增至 Vtiger 中的 CORS 白名單。之後,瀏覽器將允許該請求,因為回應將包含正確的標頭。
優勢
我們相信這些範例將改善您使用 Vtiger CRM 的體驗。我們希望確保開發人員和 CRM 使用者能夠相互分享資訊和知識,以進一步增強 CRM 的功能。
敬請關注。祝您編碼愉快!
註冊以接收最新更新!
我看過了 如何得知我們? Vtiger。