--- title: "Okta: 配置修复操作集成" slug: "okta-configuring-the-remediation-actions-integration" updated: 2026-11-17T00:11:28Z published: 2026-11-17T00:11:28Z canonical: "knowledge.catonetworks.com/okta-configuring-the-remediation-actions-integration" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Okta: 配置修复操作集成 ## 概况 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](/v1/docs/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.lifecycle.manage`中。 - `okta.users.read` - `okta.users.lifecycle.deactivate` 用于 **禁用用户** - `okta.users.lifecycle.clearSessions` 用于 **撤销登录会话**,在管理员控制台中显示为**清除用户的会话** 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 组织](https://developer.okta.com/docs/concepts/okta-organizations/)。 为此连接器创建一个单独的 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 令牌](https://help.okta.com/en-us/content/topics/security/api.htm)。 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天内未使用后过期。