配置跨原點資源共用 (CORS)

配置跨原點資源共用 (CORS)，以容許來自另一個原點的 Web 應用程式存取 Domino Web 伺服器上的資源。

執行這項作業的原因和時機

基於安全原因，大多數瀏覽器都會遵守同源原則規則。此規則限制從某個原點載入的網頁無法存取不同伺服器（或原點）上的資源。CORS 容許您定義同源原則的例外情況。大多數瀏覽器都支援 CORS。

註：
  • 從 Domino 10.0.1 Fix Pack 2 開始，支援 CORS 。
  • Windows、Linux 及 IBM AIX 支援 CORS。IBM i 不支援它。

例如，假設從「伺服器 A」（Apache 伺服器）載入的 Web 應用程式向「伺服器 B」（Domino 伺服器）提出 REST API 要求。在「伺服器 B」上配置 CORS，以容許從「伺服器 A」 載入的網頁可向「伺服器 B」提出 REST API 要求。

CORS 適用於 Domino Access Services (DAS) API，以及 Domino 上管理的其他類型 REST API。實際上，CORS 適用於任何類型的 Domino HTTP 資源。

請完成下列步驟，以在 Domino 伺服器上配置 CORS。

程序

  1. 在 Domino 伺服器的「伺服器」文件中啟用 CORS：
    註： 或者，在網站文件（「配置」標籤）中啟用 CORS。
    1. 開啟 Domino 名錄中的「伺服器」文件。（不支援透過網際網路網站文件進行配置）。
    2. 選取網際網路通訊協定 > HTTP 標籤。
    3. 在 DSAPI 區段中，將下列值新增至 DSAPI 過濾器檔名欄位：
      • (Windows) ncorsext
      • （所有其他平台）corsext
  2. 建立 JSON 檔案，定義可以存取 Domino 伺服器的原點：
    註： 如果您透過網站文件啟用 CORS，請在與網站相關聯的每部伺服器上完成此步驟及下一個步驟。
    1. 在伺服器上的 ...Domino\data\domino 資料夾中建立新資料夾 cors。
    2. 在 cors 資料夾中建立新檔案 cors-rules.json。
    3. 在 cors-rules.json 中，定義 Domino 伺服器可以存取的原點。如需詳細資料，請參閱CORS JSON 配置。
  3. 停止並重新啟動 HTTP 伺服器作業： 
    tell http quit 
load http

結果

HTTP 伺服器啟動時下列訊息表示 CORS 配置正確：
HTTP 伺服器：已順利載入 DSAPI CORS 過濾器
HTTP 伺服器啟動時下列訊息表示 CORS 配置有問題：
HTTP 伺服器：無法載入 DSAPI 模組 ncorsext