> ## 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-Hans/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-Hans/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-Hans/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** 权限，或具有 **设置 → 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. 在左侧导航栏中，点击 **设置**。
    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. 点击 **保存**（或 **Generate Token**）。
  </Step>

  <Step title="复制并保存您的令牌">
    **请立即复制令牌**并妥善保存。

    <Warning>
      Netskope **仅在创建时显示一次**令牌值。如果您在未复制的情况下离开该页面，则必须删除该令牌并重新创建。
    </Warning>
  </Step>

  <Step title="配置 IP 允许列表（如适用）">
    如果您的 Netskope 租户已启用 IP 允许列表，则必须添加 Living Security 的出口 IP 范围。

    1. 在 Netskope 管理控制台中，转到 **设置 → 管理 → IP Allowlist**。
    2. 如果已启用 IP 允许列表，请将每个 [Living Security 出口 IP 地址](/zh-Hans/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 端点。请从 **设置 → Tools → REST API v2** 生成新的 v2 令牌
    3. **IP 允许列表阻止了请求** — 如果您的租户已启用 IP 允许列表，请确认全部四个 [Living Security 出口 IP 地址](/zh-Hans/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-Hans/integrations/managing/egress-ip-addresses)，并更新 **Custom IP** 列表以保持一致。
  </Accordion>

  <Accordion title="使用了 v1 令牌而非 v2 令牌">
    v1 和 v2 令牌使用不同的身份验证机制：

    * **v1**：查询参数（`token=...`）
    * **v2**：标头（`Netskope-Api-Token: ...`）

    Living Security 使用 v2 身份验证。请从 **设置 → Tools → REST API v2**（而非旧版 v1 令牌页面）生成新令牌。
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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