简介
本文档介绍父组织如何使用X-Umbrella-OrgID标题通过Umbrella API管理子组织。
概述
父组织可以通过两种方式在Umbrella API中管理子组织:
- 通过代表每个子组织创建API密钥并将这些密钥用于API请求(在UI中或编程中)。
- 通过使用单个父组织API密钥代表每个子组织发出直接API请求。
例如,中央办公室(父组织)可以生成全局安全报告,其中包含所有分支机构(子组织)的事件数据,方法是为每个分支机构发出API请求并组合其事件信息。
代表子组织提出API请求
要为子组织发出API请求,请执行以下操作:
- 中心局管理员在父组织中创建API密钥。
- 发出API请求时,
请添加带有子组织的OrgID的X-Umbrella-OrgIDheader。
- 使用父组织API密钥中的访问令牌对请求进行身份验证。
示例:
为了生成多个分支机构的合并安全事件报告,中心办公室为每个分支机构执行API调用,为每个请求使用正确的X-Umbrella-OrgID头。
