概况
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.
连接Box的好处
Box补救操作连接器允许Cato在调查期间对Box用户采取响应操作。它使用具有写入权限的独立Box平台应用程序,而不影响其他Box连接器,例如应用活动和数据发现。
禁用用户:找到匹配请求电子邮件的托管Box用户,无视字母大小写,并将账户状态设置为不活跃。用户无法再登录,并被注销所有Box应用程序。用户的文件夹和文件对协作者隐藏,直到账户被重新激活。协作者保留其权限级别。用户的内容、群组和席位被保留。如果用户已不活跃,操作会报告该状况并成功。
撤销登录会话:以同样的方式找到托管用户,并请求Box终止所有活跃会话。账户仍然活跃且密码不变,因此用户可以再次登录。 Box将会话终止作为后台作业运行。当Box接受作业,操作成功,作业结果在Box管理员事件中显示。操作也会对不活跃用户运行。
每个操作针对一个用户运行,以电子邮件识别,并报告已完成或失败以及原因。失败原因包括电子邮件丢失、找不到匹配用户或用户查找或操作请求中出现Box错误。当Box返回错误代码和消息时,它们会在结果中出现。
配置 Box 集成
要配置(集成,请创建并授权专用的Box平台应用程序,然后在Cato管理应用程序中创建连接器。
Prerequisites
- Box企业许可证
- 能够创建平台应用程序并为企业批准的Box管理员
- 在创建应用程序的 Box 账户中启用了双重认证。没有它,客户端密钥不可用。
管理用户范围授予对管理用户的广泛权限,包括更改登录、重置密码、变更角色和管理其企业内容。为此连接器使用专用平台应用程序。不要将此范围添加到其他 Box 连接器使用的应用中。
步骤 1:在 Box 中配置集成
创建带企业访问和权限管理用户的专用平台应用程序。
要在 Box 中配置集成:
- 登录到 Box 开发者控制台,网址是
https://<your_tenant>.app.box.com/developers/console。 - 创建平台应用程序。
- 选择自定义应用并输入名称。选择 集成 作为目的,并选择 安全 & 合规 作为类别。
- 选择服务器认证(客户端凭据授权),然后点击创建应用。
- 在常规设置页面,复制并保存企业 ID以便输入到 CMA。此值作为Box 主题 ID输入。
- 在配置页面,点击获取客户端密钥。复制并保存客户端 ID和客户端密钥以便输入到 CMA。
- 在配置页面,将应用访问级别设置为应用 + 企业访问。此设置提供了对企业用户的访问权限,而不仅仅是应用的用户。
- 在应用范围下,选择管理用户,然后点击保存更改。此范围用于通过电子邮件查找用户、禁用用户和结束登录会话。
- 进入授权页面,点击审查并提交。
- 让Box管理员使用电子邮件通知为企业批准应用程序。
安全地存储客户端密钥。不要将其放在源代码管理、工单或聊天中。如果更改应用的范围,则 Box 管理员必须从 管理控制台 > 平台 > 平台应用程序 重新授权应用。
步骤2:在CMA中创建API连接器
在设置集成并应用必需的应用程序后,在CMA中添加详细信息。
对于Box,选择Box的OAuth2认证并输入第1步的凭据。
要在CMA中创建API连接器:
- 从导航菜单中,点击资源 > 集成。
- 点击已配置集成标签页。
- 点击新建。新集成面板打开。
- 选择您要添加的SaaS应用程序。
- 在功能下拉菜单中选择补救动作。
- 加入在步骤1中创建的详细信息。
- SaaS应用程序:Box
- 选择Box的OAuth2认证
- 客户端ID:输入第1步的客户端ID
- 客户端密钥:输入第1步的客户端密钥
- Box主体ID(企业ID):输入第1步的企业ID
- 输入集成的名称
- (可选)输入描述
- 点击 保存。
该应用在集成应用表格中可见,并具有已连接状态。
已知局限性
仅限管理用户:两个操作仅查找您Box企业中的管理用户。外部合作者未找到,即使其登录信息与要求的电子邮件匹配。操作报告没有用户匹配。
连接器服务账户:连接器自己的服务账户不能成为目标。通过Box用户搜索不会返回服务账户。目标到该账户登录的操作报告没有用户匹配。
后续登录:后续登录不会被撤销登录会话阻止。账户保持活跃,密码不变。用户或任何持有其凭据的人可以再次登录。使用禁用用户来阻止访问。
会话终止结果:通过撤销登录会话不会报告结束的会话数量。 Box在后台任务运行之前接受请求,而不检查用户的会话。检查Box管理员事件以获取任务结果。
合作伙伴访问内容:用户的文件和文件夹在账户重新激活之前由禁用用户设置为不可见。内容仍然保留在 Box 内。要恢复登录和协作者访问权限,请在 Box 管理控制台中将用户状态设置为活跃。
连接状态:连接测试仅检查登录和用户查找。已连接确认 Cato 可以使用应用的凭证进行认证并列出企业管理的用户。当操作运行时,缺少禁用用户或结束会话权限报告为 Box 错误的失败结果。
认证:仅支持 OAuth 2.0 客户端凭证流。