Skip to main content
部分供應商會將 API 存取限制在一份經核准的來源 IP 位址清單內。啟用該限制後,您必須將供應商設定為接受來自 Living Security 輸出 IP 位址的流量,否則整合將在網路層遭到拒絕。 本頁列出這些位址。

共有兩組

Living Security 透過兩個不同的網路連線至您的供應商,兩者分別負責整合的不同部分。 大多數整合只需要同步組。特定一群整合則永久需要兩組,請參閱需要兩組位址的整合。

整合同步流量

這四個位址對所有 Living Security 區域皆相同。託管於歐盟的客戶與託管於美國的客戶使用相同的這四個位址。 若供應商接受以逗號分隔的清單:

平台流量

與同步位址不同,這些位址會因區域而異。請僅使用託管您組織之區域的那一對位址。若您不確定是哪個區域,請在進行任何設定之前先詢問您的 Customer Success Manager——若將錯誤區域的位址加入允許清單,整合會失敗,而且其症狀看起來與允許清單毫無關聯。 若供應商接受以逗號分隔的清單:

對外手冊行動

預設情況下,寫回已連線系統的手冊行動會經由與資料同步相同的路徑,因此是從同步位址發出。無需額外設定。 管理員可以將個別連線切換為直接輸出,這會使該連線的行動改由您所在區域的平台位址發出。此設定正是為以下情況而設:供應商執行個體依來源 IP 限制 API 存取,並需要一組數量少、穩定且由 Living Security 擁有的位址加入允許清單。少數供應商因完全無法代理,一律使用直接輸出。 若您只將同步位址加入允許清單,之後有人將某個連線切換為直接輸出,該連線的行動將開始失敗,但其同步仍會正常運作。

需要兩組位址的整合

對大多數整合而言,Living Security 的整合服務會自行取得並更新存取權杖,所有流量僅從同步位址到達您的供應商。 對於下列整合,該服務無法更新權杖,因此由 Living Security 平台直接產生權杖——在您建立連線時產生一次,之後只要連線仍處於啟用狀態就會持續產生。這些權杖請求是從平台位址發出。排程的資料同步仍從同步位址發出。
在連線存續期間,兩組位址都必須保留在允許清單中。 平台位址並非僅在設定時才需要。只要整合處於啟用狀態,權杖更新就會以短週期執行,因此在成功設定後移除這些位址,會導致整合在權杖下次到期時中斷。
若您的供應商的權杖端點與其資料 API 是同一個主機(這很常見),則該主機必須同時接受來自兩個網路的流量。

將所需組別中的每個位址都加入

流量可能從組內任一位址發出,且特定請求使用哪一個位址並不固定。只將其中一部分加入允許清單會造成難以診斷的間歇性失敗:部分請求成功、部分失敗,而且其模式看起來與設定無關。 這同樣適用於平台的那一對位址,就如同適用於同步的四個位址一樣。每個區域運行兩個位址,請求可能落在其中任一個。
這些位址是穩定的,但並非永久不變。 我們致力於保持其不變,僅在極少數的特殊情況下才會變更,例如底層基礎架構供應商發生變動。由於位址有可能變更,請將本頁加入書籤。如果先前運作正常的整合開始失敗,請在開立支援案件之前回到此處,確認您的允許清單與上述位址相符。

哪些整合需要這些設定

IP 允許清單是您的供應商中的設定,而非 Living Security 中的設定。僅當您的組織已啟用該限制時才適用。如果您尚未在供應商中啟用 IP 限制,則無需採取任何動作。 下列供應商通常需要此設定: 其他供應商可能提供類似的設定。請查看目錄中該供應商的頁面以及供應商自身的文件。

允許清單缺漏或過時的症狀

兩組位址的失敗方式相反。在變更任何設定之前,請先將症狀對應到相應的組別。

連線成功,但資料從未送達

這是缺少同步位址的特徵。 憑證是在建立連線時經由一條通常不受相同限制約束的路徑進行驗證,因此 Living Security 中的連線對話方塊會回報成功。失敗會稍後才出現,也就是在排程同步執行而遭到封鎖時。 請留意下列情況:
  • 連線顯示為已連線,但各資料流回報沒有任何記錄。
  • 同步執行失敗,並出現 401 Unauthorized 或 403 Forbidden。
  • 一個運作了數月的整合在您這邊沒有任何變更的情況下開始失敗。

完全無法建立連線

這是缺少平台位址的特徵,且僅適用於需要兩組位址的整合中列出的整合。 請留意下列情況:
  • 設定在取得存取權杖時失敗,且不會建立任何連線。
  • 錯誤回報無法連線到某個主機,且背後沒有任何 HTTP 回應。
  • 供應商自身的登入記錄或條件式存取記錄顯示有來自您尚未加入允許清單之位址的請求遭到封鎖。
完全無法連線並非憑證問題。由於尚未進行任何驗證,輪換密鑰或重新產生用戶端憑證都無濟於事。來源位址未列入允許清單是最常見的原因,不過主機名稱錯誤、連接埠錯誤或供應商端中斷,從我們這邊看起來也是相同的情況。
之後若您變更允許清單而移除了平台位址,症狀又會有所不同:一個已正常運作數週的整合會在數分鐘內停止運作,因為下一次權杖更新遭到封鎖。

本頁不涵蓋網路釣魚模擬的投遞

本頁上的位址適用於整合流量——即 Living Security 為匯入資料及執行手冊行動而對您已連線的系統所發出的 API 呼叫。 網路釣魚模擬電子郵件投遞的允許清單是另一項獨立的設定,有其專屬的位址、寄件者網域及可下載的允許清單套件。請前往設定 → 網路釣魚模擬 → Allowlisting 完成設定。該流程請參閱網路釣魚模擬設定。 將本頁上的位址加入允許清單,並不會使模擬的網路釣魚電子郵件得以投遞;完成模擬的允許清單設定,也不會使受限制的供應商 API 變得可連線。若兩者都會用到,請兩者都進行設定。

取得協助

如果在您為所在區域將位址加入允許清單後,整合仍持續失敗,請聯絡您的 Customer Success Manager 或 support@livingsecurity.com。請提供供應商名稱、失敗的資料流或失敗的設定步驟,以及時間戳記,以便我們與輸出記錄進行比對。