> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Netskope 整合設定

> 將 Netskope 連接至 Living Security，以取得網頁、雲端、驗證、資料保護及威脅活動。

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>相關資源</h2>
    <ul>
      <li>
        <a href="/zh-Hant/signals/data-sources">了解整合資料如何轉換為人員風險管理訊號</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">探索 Living Security 整合</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">開啟 Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">申請 Living Security 示範</a>
      </li>
    </ul>
  </>;

export const EgressIpSafelist = ({system}) => <Note>
    <strong>請將 Living Security 同步作業的全部四個輸出 IP 位址</strong>新增至{' '}
    {system} 的允許清單。若 {system} 要求使用 CIDR 表示法，請將每個位址分別以單一主機形式輸入，並加上 <code>/32</code>：
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    流量可能從這四個位址中的任何一個送出，因此僅將其中部分位址加入允許清單，會導致間歇性的同步失敗。這四個位址在 Living Security 的所有區域中皆相同。如需完整清單、變更政策及疑難排解資訊，請參閱{' '}
    <a href="/zh-Hant/integrations/managing/egress-ip-addresses">
      設定整合輸出 IP 位址
    </a>。
  </Note>;

export const ConnectInPlatform = ({tile, children}) => <Step title="在 Living Security Platform 中輸入憑證">
    <p>
      由擁有 Living Security 存取權限的人員完成——即計畫負責人，或已受邀的系統管理員（委派設定）。
    </p>
    <ol>
      <li>
        前往 <strong>設定 → 集成 → 目錄</strong>，找到{' '}
        <strong>{tile}</strong> 圖磚，然後按一下 <strong>連接</strong>。
      </li>
      <li>
        填寫以下欄位，然後按一下 <strong>連接</strong>。
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>本指南適用於貴組織的 {system} 管理員。</strong>內容涵蓋在 {system} 中建立 API
      憑證的步驟，此操作需要 {system} 的管理員存取權限，而非 Living Security Platform 的存取權限。
    </p>
    <p>
      如果您是 Living Security 的<strong>方案負責人</strong>，且並非 {system} 的管理員，
      請將本頁面轉交給負責管理 {system} 的人員。對方完成 A 部分後，會將憑證交還給您
      （若您已邀請對方加入平台，對方也可以直接輸入憑證）。
      {recommendDelegated && <>
          {' '}由於設定過程會產生敏感的金鑰資料，建議採用{' '}
          <strong>委派設定</strong>方式，避免將密鑰傳回給您。
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="Netskope" />

## 此整合提供的內容

Netskope 可提供經過標準化的網頁、雲端、驗證、資料保護及威脅活動。經審查的範例包括：

* `web.ai.visited` — 造訪 AI 網站
* `data.bulk.uploaded` — 大量資料上傳
* `geo.impossible` — 登入之間出現不可能的移動

目前的連線使用 REST API v2；現有客戶可能會看到舊版 REST 變體。請參閱[整合資料如何轉換為訊號](/zh-Hant/signals/data-sources)。

## Living Security 所需資訊

| 憑證 | 說明 |
| - | - |
| **API token** | 從 Netskope 管理主控台產生的 REST API v2 權杖 |
| **Tenant subdomain** | 您的 Netskope 租用戶子網域（例如：`acme.goskope.com` 中的 `acme`） |

**所需的端點存取權：**

| 端點 | 用途 |
| - | - |
| `/api/v2/events/data/alert` | 威脅警示、原則違規、DLP 事件、惡意軟體偵測 |
| `/api/v2/events/data/page` | 網頁活動 — 瀏覽行為、允許與封鎖的網站、雲端應用程式存取 |

\*\*所需角色：\*\***Tenant Admin** 或具備 **Settings → Tools** 存取權的同等角色

<Note>
  此整合需要 **v2 API 權杖**，而非 v1 權杖。v1 權杖使用查詢參數驗證，無法用於 v2 API 端點。
</Note>

### 先決條件

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

***

## 第 A 部分 — 在 Netskope 中

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

<Steps>
  <Step title="前往 REST API v2 權杖管理">
    1. 在 `https://<tenant>.goskope.com` 登入您的 Netskope 管理主控台。
    2. 在左側導覽中，按一下 **Settings**。
    3. 在 **Tools** 下，選取 **REST API v2**。
  </Step>

  <Step title="建立新權杖">
    1. 按一下 **New Token**。
    2. 輸入具描述性的名稱（例如：`Living Security Platform`）。
    3. 在端點存取權下，啟用下列存取權：

    | 端點 | 所需存取權 |
    | - | - |
    | `/api/v2/events/data/alert` | 讀取 |
    | `/api/v2/events/data/page` | 讀取 |

    <Warning>
      請同時授予**兩個**端點的存取權。它們分別提供兩個獨立的資料流 — `alerts` 與
      `events` — 若權杖僅限於其中一個端點，仍可成功連線，
      但缺少端點所對應的資料流將不會傳回任何資料，也不會出現任何錯誤
      說明原因。
    </Warning>

    <Note>
      這兩個端點是 Living Security 唯一需要的端點。
      除此之外不授予其他權限，符合最小權限原則。
    </Note>

    4. 按一下 **Save**（或 **Generate Token**）。
  </Step>

  <Step title="複製並儲存您的權杖">
    **請立即複製權杖**並妥善保存。

    <Warning>
      Netskope 僅在建立時顯示權杖值**一次**。若您在未複製的情況下離開此頁面，就必須刪除該權杖並建立新的權杖。
    </Warning>
  </Step>

  <Step title="設定 IP 允許清單（如適用）">
    若您的 Netskope 租用戶已啟用 IP 允許清單，您必須加入 Living Security 的輸出 IP 範圍。

    1. 在 Netskope 管理主控台中，前往 **Settings → Administration → IP Allowlist**。
    2. 若已啟用 IP 允許清單，請將每個 [Living Security 輸出 IP 位址](/zh-Hant/integrations/managing/egress-ip-addresses)新增至 **Custom IP** 清單。

    <EgressIpSafelist system="Netskope" />

    <Warning>
      若已啟用 IP 允許清單，連線對話方塊仍會顯示成功，但在加入正確的 IP 之前，資料同步將會失敗並出現 `401 Unauthorized`。
    </Warning>
  </Step>

  <Step title="確認您的租用戶子網域">
    您的租用戶子網域是 Netskope 管理主控台 URL 的前置部分。

    若您的主控台 URL 為 `https://acme.goskope.com`，則您的子網域為 `acme`。

    請僅輸入單純的子網域 — 不含 `https://`、不含 `.goskope.com`，也不含結尾斜線。

    <Note>
      連線對話方塊接受多種輸入形式（單純子網域、完整主機名稱或完整 URL），並會自動標準化。不過，建議輸入單純的子網域。
    </Note>
  </Step>
</Steps>

***

## 第 B 部分 — 在 Living Security Platform 中

*由方案負責人完成此步驟；若採用委派設定，則由系統管理員完成。*

<Steps>
  <ConnectInPlatform tile="Netskope (v2 API)">
    | 欄位 | 值 |
    | - | - |
    | **API 金鑰** | 第 A 部分步驟 3 中取得的權杖 |
    | **Tenant subdomain** | 第 A 部分步驟 5 中的子網域（例如：`acme`） |

    <img src="https://mintcdn.com/livingsecurity/oVkrOMkYmNevekTI/integrations/images/netskope-v2-api/connect-dialog.png?fit=max&auto=format&n=oVkrOMkYmNevekTI&q=85&s=89b64e78a14c51a0977c3a2a28418988" alt="Netskope v2 API 的 Living Security 連線對話方塊" style={{maxWidth: "450px"}} width="576" height="356" data-path="integrations/images/netskope-v2-api/connect-dialog.png" />
  </ConnectInPlatform>
</Steps>

您現在已連接至 Netskope (v2 API)。

***

## 疑難排解

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    常見原因：

    1. **權杖已被撤銷或已過期** — 請產生新的權杖
    2. **使用 v1 權杖** — v1 權杖透過查詢參數進行驗證，無法用於 v2 端點。請從 **Settings → Tools → REST API v2** 產生新的 v2 權杖
    3. **IP 允許清單封鎖了要求** — 若您的租用戶已啟用 IP 允許清單，請確認全部四個 [Living Security 輸出 IP 位址](/zh-Hant/integrations/managing/egress-ip-addresses)皆已列入允許清單
  </Accordion>

  <Accordion title="403 Forbidden">
    建立權杖時未授予 `/api/v2/events/data/alert` 或 `/api/v2/events/data/page` 的存取權。權杖的端點權限在建立後無法變更 — 請建立具備兩者讀取權限的新權杖，然後重新連線。
  </Accordion>

  <Accordion title="警示有送達，但缺少網頁活動（或相反）">
    權杖缺少兩個必要端點其中之一。若權杖僅限於
    `/api/v2/events/data/alert` 或僅限於 `/api/v2/events/data/page`，仍可連線，
    但缺少端點所對應的資料流會持續為空，且不會有任何提示。

    權杖建立後，端點權限即無法變更 — 請產生具備兩個端點
    讀取權限的新權杖，然後重新連線。
  </Accordion>

  <Accordion title="同步原本正常，現在卻失敗並出現 401">
    若已啟用 IP 允許清單，Living Security 的輸出 IP 位址可能已變更。請查看[設定整合輸出 IP 位址](/zh-Hant/integrations/managing/egress-ip-addresses)，並更新 **Custom IP** 清單使其一致。
  </Accordion>

  <Accordion title="使用 v1 權杖而非 v2 權杖">
    v1 與 v2 權杖使用不同的驗證機制：

    * **v1**：查詢參數（`token=...`）
    * **v2**：標頭（`Netskope-Api-Token: ...`）

    Living Security 使用 v2 驗證。請從 **Settings → Tools → REST API v2**（而非舊版 v1 權杖頁面）產生新的權杖。
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.