Okta: 配置修复操作集成

Prev Next

概况

XOps integrations let you take response actions in connected third-party applications as part of an investigation. You can revoke a user’s sessions or disable their account in your single sign-on (SSO) provider or a specific application. These actions help you contain threats by restricting access to affected accounts. To enable these actions, configure a connector for the relevant third-party application.

For more information, see Mitigating Threats in XOps Stories.

To configure the Remediation Actions integration, you need to:

  1. Configure the required settings in the SaaS application

  2. Create the API connector in the CMA

A XOps license is required for Remediation Actions integrations.

连接 Okta 的好处

Okta 修复操作连接器使 Cato 在调查期间可以对 Okta 用户账户采取响应措施。它使用一个单独的 API 令牌,不影响其他 Okta 连接器,例如应用程序活动。

  • 禁用用户: 查找与请求电子邮件匹配的 Okta 登录或主要电子邮件的用户并停用该账户。账户状态变为已取消配置。如果账户已停用,则操作报告该条件并成功。

  • 撤销登录会话: 查找与请求电子邮件匹配的 Okta 登录或主要电子邮件的用户并清除所有活跃的 Okta 会话。它撤销了发给用户的 OpenID Connect 和 OAuth 访问及刷新令牌。还会清除记住的多因素认证 (MFA) 设备,并提示用户在下一次登录时在每个设备上使用 MFA。账户没有被停用。此操作适用于任何用户状态,包括已停用用户。

每个操作都基于电子邮件在一个用户上运行,并报告已完成或失败并提供原因。

配置 Okta 集成

要配置集成,请识别您的 Okta 域,创建专用 API 令牌,并在 Cato 管理应用程序 (CMA) 中创建连接器。

Prerequisites

  • 一个 Okta 管理员账户,可以创建 API 令牌、停用用户并清除他们的会话。使用 超级管理员角色或具有这些权限的自定义管理员角色:

    • okta.users.read

    • okta.users.lifecycle.deactivate 用于 禁用用户

    • okta.users.lifecycle.clearSessions 用于 撤销登录会话,在管理员控制台中显示为清除用户的会话

    两个生命周期权限也包含在okta.users.lifecycle.manage中。

API 令牌继承其创建账户的权限。只读管理员角色用于应用活动是不够的。

使用一个专用账户,其生命周期和权限已为此集成管理。停用账户同时也会停用其 API 令牌。

步骤 1:在 Okta 中配置集成

使用您的 Okta 组织的基本 URL,包括 https://,作为Okta 域名 URL。包括示例:

  • https://companyname.okta.com

  • https://companyname.okta-emea.com

  • https://companyname.oktapreview.com

不要使用包含-admin的管理员控制台 URL或附加/admin。如果您的组织使用自定义域名用于 Okta API,请使用该基本 URL。有关详细信息,请参阅 Okta 组织。

为此连接器创建一个单独的 SSWS API 令牌,而不是重用应用活动令牌。像对待密码一样对待令牌。不要将它放在源代码管理、票据或聊天中。

在 Okta 中配置集成:

  1. 识别您的 Okta 组织的基本 URL。复制并保存Okta 域名 URL,以便输入到 CMA 中。

  2. 使用专用账户登录 Okta 管理员控制台。

  3. 导航到 安全性 > API。

  4. 选择 令牌 标签页。

  5. 点击 创建令牌。

  6. 输入描述性名称,例如 Cato Remediation Actions。

  7. 根据您组织的安全策略配置令牌的网络区域限制。确保限制允许 Cato 服务连接到您的 Okta 组织。

  8. 点击 创建令牌。

  9. 复制并保存API 令牌,以便输入到 CMA 中。有关 Okta 程序,请参阅 管理 Okta API 令牌。

SSWS令牌从创建或最后使用开始保持有效期为30天。每个成功的 API 请求刷新30天不活动期。令牌轮换是手动的。

轮换 API 令牌:

  1. 使用上面的程序创建替代令牌。

  2. 使用替代令牌更新 CMA 中的连接器。

  3. 确认其连接状态为已连接。

  4. 在 Okta 中撤销旧令牌。

步骤2:在CMA中创建API连接器

在应用程序需要的集成设置之后,将详情添加到 CMA。

在CMA中创建API连接器:

  1. 从导航菜单中,点击资源 > 集成。

  2. 点击已配置集成标签页。

  3. 点击新建。新集成面板打开。

  4. 选择您要添加的SaaS应用程序。

  5. 在内功能下拉菜单中选择补救操作。

  6. 添加在步骤一中创建的详细信息。

    • SaaS应用户: Okta

    • 名称: 为集成输入名称

    • 描述: 可选地输入描述

    • Okta域名网址: 输入步骤1中标识的基本网址

    • API令牌: 仅粘贴令牌值,不包括 SSWS 前缀

  7. 点击保存。

该应用在集成应用表格中可见,并具有已连接状态。

已知局限性

  • 停用是破坏性的: Okta从所有分配的应用程序中取消用户权限。这可能会销毁用户数据,例如电子邮件或文件。 Okta记录此操作为不可恢复。

  • 会话撤销: Okta指出,撤销登录会话不会清除为网络或本机应用生成的会话。

  • 确切的电子邮件匹配: 请求的电子邮件必须与存储的Okta登录或主要电子邮件完全匹配,包括字母大小写。否则,操作报告失败,原因是没有Okta用户匹配请求的电子邮件。

  • 令牌所有者: 禁用用户和撤销登录会话无法针对拥有连接器的API令牌账户。停用该账户将使令牌作废。

  • 连接状态: 已连接仅确认令牌可以列出用户。缺失的停用或会话清除权限在操作运行时报告为失败结果。

  • 令牌生命周期: 如果其创建账户被停用,SSWS令牌将无效。它在30天内未使用后过期。