仕様

IBM Cloud® Activity Tracker Event Routing を使用して、 IBM Cloud で、グローバルおよびロケーションベースのイベントデータの両方について、監査イベントをルーティングする方法を設定します。イベントは、Cloud Auditing Data Federation (CADF) 標準に準拠しています。

Activity Tracker Event Routingサービス

アカウントの構成

アカウントで Activity Tracker Event Routing を設定するには、監査イベントの転送先と保存先を定義します。 1 つ以上のターゲット、および 1 つ以上の経路を構成する必要があります。アカウント設定も構成する必要があります。

ターゲットは、監査イベントを保管できるリソースを定義します。
経路は、アカウント内で監査イベントがルーティングされる場所を決定するルールを定義します。
アカウント設定の構成では、アカウント内でイベントが収集されるデフォルト・ターゲット、構成の管理が許可されるエンドポイントのタイプ、およびアカウント内のデータの保管が許可されるロケーションなどの情報を定義します。

グローバル・イベントおよびロケーション・ベースのイベントを収集できます。

グローバル・イベントは、すべてのリージョンでデータとリソースが広く同期されるようなアクティビティーがアカウント内で行われたことを報告するものです。
ロケーション・ベースのイベントは、IBM データ・センターのロケーション (米国南部や米国東部) 内にホストされている IBM Cloud サービスによってアカウント内で生成されたアクティビティーを報告するものです。

アカウントごとに、イベントが収集される地域を選択できます。

アカウント構成設定

Activity Tracker Event Routing アカウントを行う際、以下の情報のいずれかを定義することができます

IBM Cloud アカウント内で、 Activity Tracker Event Routing アカウントの設定メタデータが保存されている場所。

メタデータでは、任意のリージョンのアカウント全体で使用可能なターゲット/ルーティング/設定データを参照します。

Activity Tracker Event Routing が利用可能な、サポート対象の場所ならどこでもお選びいただけます。詳しくは、ロケーションを参照してください。

金融サービスの検証済みロケーションや EU 管理地域などの企業または業界のコンプライアンス要件、およびデータの常駐要件を考慮します。
そのアカウント内で、 Activity Tracker Event Routing アカウントの設定を管理することが許可されているエンドポイントの種類。

パブリック・エンドポイント、プライベート・エンドポイント、またはその両方を構成できます。
アカウント管理者が監査イベントを収集するターゲットを定義できる場所。

Activity Tracker Event Routing が利用可能な、サポート対象の場所ならどこでもお選びいただけます。詳しくは、ロケーションを参照してください。

金融サービスの検証済みロケーションや EU 管理地域などの企業または業界のコンプライアンス要件、およびデータの常駐要件を考慮します。
アカウント内に、サポートされている Activity Tracker Event Routing の場所から監査イベントを収集するターゲットが1つ以上あり、それらのターゲットについて、監査イベントのルーティング方法をまだ設定していない場合。

複数のターゲットを定義すると、すべてのデフォルト・ターゲットは、アカウント内のルーティング先を示すルーティング・ルールがない監査イベントのコピーを取得します。アカウントごとに最大 2 つのデフォルト・ターゲットを定義できます。

Activity Tracker Event Routing アカウント設定を構成または変更する際は、以下の点に留意してください

Activity Tracker Event Routing アカウントを変更するたびに、新しいリクエストで渡されたデータが、既存の設定データを上書きします。アカウント設定の更新を実行するときに、既存のデータが新しい要求に含まれて削除されないようにする必要があります。
--private-api-endpoint-only TRUEを設定してパブリック・エンドポイントを無効にする前に、アカウントにプライベート・エンドポイントへのアクセス権限があることを確認してください。これを行うには、コマンドibmcloud account showを実行します。 VRF Enabledが true で、Service Endpoint Enabledが true の場合は、プライベート・エンドポイントへのアクセス権限があります。プライベート・エンドポイントへのアクセス権限がない場合は、パブリック・エンドポイントを再度有効にすることができなくなります。パブリック・エンドポイントを再度有効にするには、プライベート・エンドポイントにアクセスする必要があるからです。

ターゲット

ターゲットは、監査イベントが収集される場所を定義します。

ターゲットに関する以下の情報に注意してください。

各アカウントには、最大 16 個のターゲットを定義できます。
各アカウントは、最大 2 つのデフォルト・ターゲットを持つことができます。デフォルト・ターゲットは、アカウントのルーティング・ルールで明示的に管理されていない監査イベントが送信されるリソースを定義します。
ターゲットは次のようになります。
- IBM Cloud Object Storage (COS) バケット
- IBM® Event Streams for IBM Cloud®トピック
- IBM Cloud Logsの提供
- IBM Cloud App Configuration のサービス
すべてのターゲットには、任意の Activity Tracker Event Routing API エンドポイントからアクセスできます。
ターゲットは 1 つの領域内に作成されますが、複数の領域にまたがって表示されます。
ターゲットは、イベントが生成されるのと同じアカウントで定義することも、別のアカウントで定義することもできます。
Cloud Object Storage または Event Streams ターゲットを定義する際は、APIキーまたはサービス間認証を使用してイベントをアップロードできます。
アカウント内のターゲットは、 Activity Tracker Event Routing CLI を使用して管理できるほか、 Activity Tracker Event Routing REST API や Terraform スクリプトを使用してプログラム的に管理することもできます。
ターゲットを管理するには、IAM 権限が必要です。詳細については、「タスク別の IAM アクション」を参照してください。

次の表は、有効なターゲット・タイプの概要です。

ターゲットのリスト
ターゲット	タイプ	詳細
IBM Cloud Object Storage (COS)	`cloud_object_storage`	COSターゲットの管理
IBM® Event Streams for IBM Cloud®	`event_streams`	IBM® Event Streams for IBM Cloud®ターゲットの管理
IBM Cloud Logs	`cloud_logs`	Cloud Logs ターゲットの管理
IBM Cloud App Configuration	`app_config`	App Configuration のターゲットの管理

経路

ルートは、アカウントで生成された監査イベントがルーティングされる場所を示すルールを定義します。

経路はアカウントの下でグローバルになり、Activity Tracker Event Routing がデプロイされているすべての地域で評価されます。
経路は、任意の地域の IBM Cloud® Activity Tracker Event Routing API エンドポイントから管理できます。
1 つのアカウントに対して最大 30 のルートを定義できます。
デフォルトでは、アカウントには 0 個の経路が構成されています。
経路ごとに最大 10 個のルールを構成できます。ルーティング・ルールは、監査イベントがルーティングされるロケーションと関連ターゲットを示します。
ルールごとに最大 8 つのロケーションを構成できます。
ルールごとに最大 3 つのターゲット (target_ids) を構成できます。
経路は独立して処理されます。同じイベントに一致するルールを持つ複数の経路がある場合、そのイベントは複数のターゲットに送信されます。
ルールは順番に処理されます。イベントの処理には、最初に一致したルール (例えば、location) が使用されます。イベントが処理されると、その経路の定義内の後続の規則によって処理されることはありません。他のルールによって処理されなかったすべてのイベントに対してデフォルト・ルールを指定する場合は、routeのrules定義でルール ("locations" : ["*"]) を最終ルールとして指定します。
イベントがどのルールにも一致せず、デフォルト・ターゲットが構成されていない場合、イベントはドロップされ、どのターゲットにもルーティングされません。
rules構成に対する更新には、すべてのlocationルールが含まれている必要があります。更新すると、既存のルール・セットが破棄され、指定された構成に置き換えられます。
アカウント内のルートは、 Activity Tracker Event Routing CLI を使用して管理できるほか、 Activity Tracker Event Routing REST API や Terraform スクリプトを使用してプログラム的に管理することもできます。
経路を管理するには、IAM 権限が必要です。詳細については、 Activity Tracker Event Routingアクションを参照してください。

監査イベントの収集

IBM Cloud アカウントで監査イベントを収集するには、 Activity Tracker Event Routing API、 Activity Tracker Event Routing CLI、およびTerraformスクリプトを使用して、 Activity Tracker Event Routing を設定できます。

詳しくは、イベントの収集を参照。