Skip to main content

​
此整合提供的內容

Netskope 可提供經過標準化的網頁、雲端、驗證、資料保護及威脅活動。經審查的範例包括：
  • web.ai.visited — 造訪 AI 網站
  • data.bulk.uploaded — 大量資料上傳
  • geo.impossible — 登入之間出現不可能的移動
目前的連線使用 REST API v2；現有客戶可能會看到舊版 REST 變體。請參閱整合資料如何轉換為訊號。

​
Living Security 所需資訊

所需的端點存取權： **所需角色：**Tenant Admin 或具備 Settings → Tools 存取權的同等角色
此整合需要 v2 API 權杖，而非 v1 權杖。v1 權杖使用查詢參數驗證，無法用於 v2 API 端點。

​
先決條件

  • 您必須在 Netskope 中具備 Tenant Admin 存取權，才能管理 REST API 權杖。

​
第 A 部分 — 在 Netskope 中

由您的 Netskope 管理員完成以下步驟。
1

前往 REST API v2 權杖管理

  1. 在 https://<tenant>.goskope.com 登入您的 Netskope 管理主控台。
  2. 在左側導覽中，按一下 Settings。
  3. 在 Tools 下，選取 REST API v2。
2

建立新權杖

  1. 按一下 New Token。
  2. 輸入具描述性的名稱（例如：Living Security Platform）。
  3. 在端點存取權下，啟用下列存取權：
請同時授予兩個端點的存取權。它們分別提供兩個獨立的資料流 — alerts 與 events — 若權杖僅限於其中一個端點，仍可成功連線， 但缺少端點所對應的資料流將不會傳回任何資料，也不會出現任何錯誤 說明原因。
這兩個端點是 Living Security 唯一需要的端點。 除此之外不授予其他權限，符合最小權限原則。
  1. 按一下 Save（或 Generate Token）。
3

複製並儲存您的權杖

請立即複製權杖並妥善保存。
Netskope 僅在建立時顯示權杖值一次。若您在未複製的情況下離開此頁面，就必須刪除該權杖並建立新的權杖。
4

設定 IP 允許清單（如適用）

若您的 Netskope 租用戶已啟用 IP 允許清單，您必須加入 Living Security 的輸出 IP 範圍。
  1. 在 Netskope 管理主控台中，前往 Settings → Administration → IP Allowlist。
  2. 若已啟用 IP 允許清單，請將每個 Living Security 輸出 IP 位址新增至 Custom IP 清單。
若已啟用 IP 允許清單，連線對話方塊仍會顯示成功，但在加入正確的 IP 之前，資料同步將會失敗並出現 401 Unauthorized。
5

確認您的租用戶子網域

您的租用戶子網域是 Netskope 管理主控台 URL 的前置部分。若您的主控台 URL 為 https://acme.goskope.com，則您的子網域為 acme。請僅輸入單純的子網域 — 不含 https://、不含 .goskope.com，也不含結尾斜線。
連線對話方塊接受多種輸入形式（單純子網域、完整主機名稱或完整 URL），並會自動標準化。不過，建議輸入單純的子網域。

​
第 B 部分 — 在 Living Security Platform 中

由方案負責人完成此步驟；若採用委派設定，則由系統管理員完成。
您現在已連接至 Netskope (v2 API)。

​
疑難排解

常見原因：
  1. 權杖已被撤銷或已過期 — 請產生新的權杖
  2. 使用 v1 權杖 — v1 權杖透過查詢參數進行驗證，無法用於 v2 端點。請從 Settings → Tools → REST API v2 產生新的 v2 權杖
  3. IP 允許清單封鎖了要求 — 若您的租用戶已啟用 IP 允許清單，請確認全部四個 Living Security 輸出 IP 位址皆已列入允許清單
建立權杖時未授予 /api/v2/events/data/alert 或 /api/v2/events/data/page 的存取權。權杖的端點權限在建立後無法變更 — 請建立具備兩者讀取權限的新權杖，然後重新連線。
權杖缺少兩個必要端點其中之一。若權杖僅限於 /api/v2/events/data/alert 或僅限於 /api/v2/events/data/page，仍可連線， 但缺少端點所對應的資料流會持續為空，且不會有任何提示。權杖建立後，端點權限即無法變更 — 請產生具備兩個端點 讀取權限的新權杖，然後重新連線。
若已啟用 IP 允許清單，Living Security 的輸出 IP 位址可能已變更。請查看設定整合輸出 IP 位址，並更新 Custom IP 清單使其一致。
v1 與 v2 權杖使用不同的驗證機制：
  • v1：查詢參數（token=...）
  • v2：標頭（Netskope-Api-Token: ...）
Living Security 使用 v2 驗證。請從 Settings → Tools → REST API v2（而非舊版 v1 權杖頁面）產生新的權杖。