Skip to main content

​
此集成提供的数据

Netskope 可提供经过规范化的网页、云、身份验证、数据保护和威胁活动数据。已审核的示例包括：
  • web.ai.visited — 访问了 AI 网站
  • data.bulk.uploaded — 批量数据上传
  • geo.impossible — 登录之间出现不可能的旅行
当前连接使用 REST API v2；现有客户可能会看到旧版 REST 变体。请参阅集成数据如何转化为信号。

​
Living Security 所需的信息

所需的端点访问权限： **所需角色：**具有 Tenant Admin 权限，或具有 设置 → 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. 在左侧导航栏中，点击 设置。
  3. 在 Tools 下，选择 REST API v2。
2

创建新令牌

  1. 点击 New Token。
  2. 输入一个具有描述性的名称（例如 Living Security Platform）。
  3. 在端点访问权限下，启用以下访问权限：
请同时授予两个端点的权限。它们分别为两个独立的数据流 — alerts 和 events — 提供数据；即使令牌仅限于其中一个端点，连接仍会成功。 但缺少权限的端点所对应的数据流将不返回任何数据，且不会出现任何错误提示来说明原因。
这两个端点是 Living Security 唯一需要的端点。除此之外不授予任何其他权限，符合最小权限原则。
  1. 点击 保存（或 Generate Token）。
3

复制并保存您的令牌

请立即复制令牌并妥善保存。
Netskope 仅在创建时显示一次令牌值。如果您在未复制的情况下离开该页面，则必须删除该令牌并重新创建。
4

配置 IP 允许列表（如适用）

如果您的 Netskope 租户已启用 IP 允许列表，则必须添加 Living Security 的出口 IP 范围。
  1. 在 Netskope 管理控制台中，转到 设置 → 管理 → 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 端点。请从 设置 → 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 身份验证。请从 设置 → Tools → REST API v2（而非旧版 v1 令牌页面）生成新令牌。