概况
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:
Configure the required settings in the SaaS application
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.readokta.users.lifecycle.deactivate用于 禁用用户okta.users.lifecycle.clearSessions用于 撤销登录会话,在管理员控制台中显示为清除用户的会话
两个生命周期权限也包含在
okta.users.lifecycle.manage中。
API 令牌继承其创建账户的权限。只读管理员角色用于应用活动是不够的。
使用一个专用账户,其生命周期和权限已为此集成管理。停用账户同时也会停用其 API 令牌。
步骤 1:在 Okta 中配置集成
使用您的 Okta 组织的基本 URL,包括 https://,作为Okta 域名 URL。包括示例:
https://companyname.okta.comhttps://companyname.okta-emea.comhttps://companyname.oktapreview.com
不要使用包含-admin的管理员控制台 URL或附加/admin。如果您的组织使用自定义域名用于 Okta API,请使用该基本 URL。有关详细信息,请参阅 Okta 组织。
为此连接器创建一个单独的 SSWS API 令牌,而不是重用应用活动令牌。像对待密码一样对待令牌。不要将它放在源代码管理、票据或聊天中。
在 Okta 中配置集成:
识别您的 Okta 组织的基本 URL。复制并保存Okta 域名 URL,以便输入到 CMA 中。
使用专用账户登录 Okta 管理员控制台。
导航到 安全性 > API。
选择 令牌 标签页。
点击 创建令牌。
输入描述性名称,例如
Cato Remediation Actions。根据您组织的安全策略配置令牌的网络区域限制。确保限制允许 Cato 服务连接到您的 Okta 组织。
点击 创建令牌。
复制并保存API 令牌,以便输入到 CMA 中。有关 Okta 程序,请参阅 管理 Okta API 令牌。
SSWS令牌从创建或最后使用开始保持有效期为30天。每个成功的 API 请求刷新30天不活动期。令牌轮换是手动的。
轮换 API 令牌:
使用上面的程序创建替代令牌。
使用替代令牌更新 CMA 中的连接器。
确认其连接状态为已连接。
在 Okta 中撤销旧令牌。
步骤2:在CMA中创建API连接器
在应用程序需要的集成设置之后,将详情添加到 CMA。
在CMA中创建API连接器:
从导航菜单中,点击资源 > 集成。
点击已配置集成标签页。
点击新建。新集成面板打开。
选择您要添加的SaaS应用程序。
在内功能下拉菜单中选择补救操作。
添加在步骤一中创建的详细信息。
SaaS应用户: Okta
名称: 为集成输入名称
描述: 可选地输入描述
Okta域名网址: 输入步骤1中标识的基本网址
API令牌: 仅粘贴令牌值,不包括
SSWS前缀
点击保存。
该应用在集成应用表格中可见,并具有已连接状态。
已知局限性
停用是破坏性的: Okta从所有分配的应用程序中取消用户权限。这可能会销毁用户数据,例如电子邮件或文件。 Okta记录此操作为不可恢复。
会话撤销: Okta指出,撤销登录会话不会清除为网络或本机应用生成的会话。
确切的电子邮件匹配: 请求的电子邮件必须与存储的Okta登录或主要电子邮件完全匹配,包括字母大小写。否则,操作报告失败,原因是没有Okta用户匹配请求的电子邮件。
令牌所有者: 禁用用户和撤销登录会话无法针对拥有连接器的API令牌账户。停用该账户将使令牌作废。
连接状态: 已连接仅确认令牌可以列出用户。缺失的停用或会话清除权限在操作运行时报告为失败结果。
令牌生命周期: 如果其创建账户被停用,SSWS令牌将无效。它在30天内未使用后过期。