内容

はじめに

このドキュメントでは、親組織がX-Umbrella-OrgIDヘッダーを使用してUmbrella APIで子組織を管理する方法について説明します。

概要

親組織は、次の2つの方法でUmbrella APIで子組織を管理できます。

- 各子組織の代わりにAPIキーを作成し、それらのキーをAPI要求に使用する(UIorprogrammableで)。

- 単一の親組織のAPIキーを使用して、各子組織に代わって直接API要求を行う。

たとえば、セントラルオフィス（親組織）は、すべてのブランチオフィス（子組織）からのイベントデータを含むグローバルセキュリティレポートを生成できます。これは、ブランチごとにAPI要求を発行し、イベント情報を組み合せることによって実現します。

子組織に代わってAPI要求を行う

子組織に対してAPI要求を作成する手順は、次のとおりです。

1. セントラルオフィスの管理者が親組織にAPIキーを作成します。

2. API要求を行う場合は、X-Umbrella-OrgIDヘッダーに子組織のOrgIDを追加します。

3. 親組織のAPIキーからのアクセストークンを使用して、要求を認証します。

例：

複数のブランチの複合セキュリティイベントレポートを生成するために、セントラルオフィスでは、各要求の正しいX-Umbrella-OrgIDヘッダーを使用して、各ブランチオフィスに対してAPIコールを発信します。