Cloud Storage での Cloud Audit Logs

このページでは、Cloud Storage で Cloud Audit Logs を使用する場合の補足情報を提供します。Cloud Audit Logs を使用すると、Cloud Storage で実行された API オペレーションのログを生成できます。

概要

Google Cloud サービスにより監査ログが書き込まれ、Google Cloud リソース内で「誰が、いつ、どこで、何をしたか」の確認に役立ちます。また、リソースにアクセスする方法についてより詳細な情報として、監査ログにカスタム情報を追加することもできます。

Google Cloud プロジェクトで記録されるのは、その Google Cloud プロジェクト内に直接存在するリソースの監査ログのみです。フォルダ、組織、請求先アカウントなど、その他の Google Cloud リソースには、そのエンティティ自体の監査ログが記録されます。

Cloud Audit Logs の概要については、Cloud Audit Logs の概要をご覧ください。監査ログ形式の詳細については、監査ログについてをご覧ください。

利用可能な監査ログ

Cloud Storage では、次の種類の監査ログを使用できます。

管理アクティビティ監査ログ: Cloud Storage リソースへのアクセス権を変更するオペレーションと、バケット、マネージドフォルダ、インベントリレポートの構成を作成、削除、変更するオペレーションが記録されます。管理アクティビティ監査ログは無効にできません。
データアクセス監査ログ: 管理アクティビティ監査ログで追跡されないオペレーションのエントリ。データアクセス監査ログには、さらにいくつかのサブタイプがあります。
- ADMIN_READ: アクセス構成の読み取り、バケットメタデータの読み取り、プロジェクト内のバケットの一覧表示を行うオペレーションのエントリ。
- DATA_READ: バケット以外の Cloud Storage リソースの読み取りまたは一覧表示を行うオペレーションのエントリ。
- DATA_WRITE: オブジェクトと XML API マルチパートアップロードの作成、削除、変更を行うオペレーションのエントリ。
データアクセス監査ログを受信するには、監査ログを明示的に有効にする必要があります。

Cloud Audit Logs では、Cloud Storage の監査ログだけでなく、Storage Insights の監査ログも作成できます。Storage Insights の監査ログは、インベントリレポートの構成が作成、更新、取得されるたびに、またインベントリレポートが取得される際に生成されます。

監査ログの種類の詳細については、監査ログの種類をご覧ください。

監査対象のオペレーション

次の表に、監査ログタイプに対応する Cloud Storage オペレーションを示します。

監査ログのタイプ	サブタイプ	Cloud Storage のオペレーション
管理アクティビティ	`ADMIN_WRITE`	IAM ポリシーの設定 / 変更オブジェクトの ACL の変更³ バケットの作成バケットの削除バケットのメタデータの更新マネージドフォルダの作成マネージドフォルダの削除インベントリレポートの構成の作成インベントリレポートの構成の更新インベントリレポートの構成の削除
データアクセス	`ADMIN_READ`	IAM ポリシーの取得オブジェクトの ACL の取得バケットのメタデータの取得バケットのリストの表示
データアクセス	`DATA_READ`	オブジェクトデータの取得オブジェクトメタデータの取得オブジェクトの一覧表示マネージドフォルダのメタデータの取得マネージドフォルダの一覧表示オブジェクトのコピー¹ オブジェクトの作成¹ 進行中の XML API マルチパートアップロードのリスト取得 XML API マルチパートアップロードのパートのリスト取得インベントリレポートの構成の取得インベントリレポートの構成の一覧表示インベントリレポートの取得インベントリレポートの一覧表示
データアクセス	`DATA_WRITE`	オブジェクトの作成オブジェクトの削除² ACL 以外のオブジェクトメタデータの更新² オブジェクトのコピー¹ オブジェクトの作成¹ XML API マルチパートアップロードの開始 XML API マルチパートアップロードのパートの作成 XML API マルチパートアップロードの中止² XML API マルチパートアップロードの完了

¹ これらのオペレーションにはデータの読み取りと書き込みの両方が含まれます。そのため、これらのオペレーションでは 2 つのログエントリが生成されます。

² Cloud Audit Logs は、オブジェクトのライフサイクル管理または Autoclass 機能によって行われた処理をログに記録しません。これらの処理を追跡する方法については、ライフサイクルの処理を追跡するためのオプションをご覧ください。

³ オブジェクト作成時に ACL が初期設定される場合、管理アクティビティ監査ログは生成されません。また、オブジェクト ACL が一般公開に設定されている場合、そのオブジェクトまたはその ACL への読み書きで監査ログは生成されません。

監査ログ形式

監査ログエントリには、次の要素が含まれます。

ログエントリ自体。これは LogEntry オブジェクトです。よく使用されるフィールドは次のとおりです。
- logName には、リソース ID と監査ログの種類が含まれます。
- resource には、監査対象オペレーションのターゲットが含まれます。
- timestamp には、監査対象オペレーションの時間が含まれます。
- protoPayload には、監査対象の情報が含まれます。
監査ロギングデータ。ログエントリの protoPayload フィールドに保持される AuditLog オブジェクトです。
リクエストとレスポンスの詳細情報など、オプションの Cloud Storage 固有の監査情報については、詳細な監査ロギングモードをご覧ください。監査ログにカスタム情報を追加するために、詳細な監査ロギングを適用する必要はないことに留意してください。

これらのオブジェクトのその他のフィールドと、その解釈方法については、監査ログについてをご覧ください。

ログ名

Cloud Audit Logs のログ名にはリソース識別子が含まれています。これは、監査ログを所有する Google Cloud プロジェクトまたは他の Google Cloud エンティティを示しています。これにより、ログに管理アクティビティまたはデータアクセスの監査ログデータが含まれているかどうかがわかります。

リソース識別子の変数を含む監査ログ名は次のとおりです。

   projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity
   projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access

   folders/FOLDER_ID/logs/cloudaudit.googleapis.com%2Factivity
   folders/FOLDER_ID/logs/cloudaudit.googleapis.com%2Fdata_access

   billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com%2Factivity
   billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com%2Fdata_access

   organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com%2Factivity
   organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com%2Fdata_access

サービス名

Cloud Storage 監査ログでは、サービス名 storage.googleapis.com が使用されます。

Storage Insights の監査ログでは、サービス名 storageinsights.googleapis.com が使用されます。

すべての Cloud Logging API サービス名とそれに対応するモニタリング対象リソースタイプの一覧については、サービスとリソースのマッピングをご覧ください。

リソースタイプ

Cloud Storage 監査ログでは、リソースタイプ gcs_bucket が使用されます。

Cloud Logging でモニタリングされるすべてのリソースタイプのリストと記述情報については、モニタリング対象リソースタイプをご覧ください。

監査ロギングの有効化

管理アクティビティ監査ログは常に有効になっています。無効にすることはできません。

データアクセス監査ログはデフォルトで無効になっており、明示的に有効にしない限り書き込まれません。

データアクセス監査ログの一部またはすべてを有効にする方法については、データアクセス監査ログを構成するをご覧ください。

権限とロール

IAM の権限とロールにより、Google Cloud リソース内の監査ログデータにアクセス可能かどうか判断されます。

ユースケースに適用する Logging 固有の権限とロールを決定する際は、次の点を考慮してください。

ログ閲覧者のロール（roles/logging.viewer）は、管理アクティビティ、ポリシー拒否、システムイベントの監査ログに対する読み取り専用権限を付与します。このロールしかない場合は、_Required バケットと _Default バケットにあるデータアクセスの監査ログを閲覧できません。
プライベートログ閲覧者ロール（(roles/logging.privateLogViewer）には、roles/logging.viewer に含まれる権限に加え、_Required バケットと _Default バケット内のデータアクセス監査ログの読み取り権限が含まれます。

これらのプライベートログがユーザー定義バケットに保存されている場合、それらのバケット内のログを読み取る権限を持つユーザーは、プライベートログを読み取ることができます。ログバケットの詳細については、転送とストレージの概要をご覧ください。

監査ログデータに適用される IAM の権限とロールの詳細については、IAM を使用したアクセス制御をご覧ください。

ログの表示

すべての監査ログに対してクエリを実行することも、監査ログ名でログをクエリすることもできます。監査ログ名には、Google Cloud プロジェクト、フォルダ、請求先アカウント、または監査ロギング情報を表示する組織のリソース識別子が含まれています。クエリでは、インデックス付きの LogEntry フィールドを指定できます。SQL クエリをサポートする [ログ分析] ページを使用する場合は、クエリ結果をグラフとして表示できます。

ログのクエリの詳細については、次のページをご覧ください。

Google Cloud コンソール、Google Cloud CLI、または Logging API を使用して、Cloud Logging で監査ログを表示できます。

コンソール

Google Cloud コンソールでは、ログエクスプローラを使用して、Google Cloud プロジェクト、フォルダ、または組織の監査ログエントリを取得できます。

Google Cloud コンソールのナビゲーションパネルで、[ロギング] を選択してから、[ログエクスプローラ] を選択します。
[ログエクスプローラ] に移動
既存の Google Cloud プロジェクト、フォルダ、または組織を選択します。
すべての監査ログを表示するには、次のいずれかのクエリを [クエリエディタ] フィールドに入力し、[クエリを実行] をクリックします。
```
logName:"cloudaudit.googleapis.com"
```
```
protoPayload."@type"="type.googleapis.com/google.cloud.audit.AuditLog"
```
特定のリソースと監査ログタイプの監査ログを表示するには、[クエリビルダー] ペインで次の操作を行います。
- リソースタイプに、表示する監査ログを含む Google Cloud リソースを選択します。
- [ログ名] で、表示する監査ログタイプを選択します。
  - 管理アクティビティ監査ログの場合は、[activity] を選択します。
  - データアクセス監査ログの場合は、[data_access] を選択します。
  - システムイベント監査ログの場合は、[system_event] を選択します。
  - ポリシー拒否監査ログの場合は、[policy] を選択します。
- [クエリを実行] をクリックします。
これらのオプションが表示されない場合、Google Cloud プロジェクト、フォルダ、または組織で利用可能なその種類の監査ログは存在しないことを意味します。

ログエクスプローラでログを表示する際に問題が発生した場合は、トラブルシューティングの情報をご覧ください。

ログエクスプローラを使用したクエリの詳細については、ログエクスプローラでクエリを作成するをご確認ください。Gemini を使用してログエクスプローラでログエントリを要約する方法については、Gemini の支援を使用してログエントリを要約するをご覧ください。

gcloud

Google Cloud CLI は、Logging API へのコマンドラインインターフェースを提供します。ログ名ごとに有効なリソース識別子を指定します。たとえば、クエリに PROJECT_ID が含まれている場合、指定するプロジェクト ID は、現在選択された Google Cloud プロジェクトを参照している必要があります。

Google Cloud プロジェクトレベルの監査ログエントリを読み取るには、次のコマンドを実行します。

gcloud logging read "logName : projects/PROJECT_ID/logs/cloudaudit.googleapis.com" \
    --project=PROJECT_ID

フォルダレベルの監査ログエントリを読み取るには、次のコマンドを実行します。

gcloud logging read "logName : folders/FOLDER_ID/logs/cloudaudit.googleapis.com" \
    --folder=FOLDER_ID

組織レベルの監査ログエントリを読み取るには、次のコマンドを実行します。

gcloud logging read "logName : organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com" \
    --organization=ORGANIZATION_ID

Cloud 請求先アカウントレベルの監査ログエントリを読み取るには、次のコマンドを実行します。

gcloud logging read "logName : billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com" \
    --billing-account=BILLING_ACCOUNT_ID

1 日以上経過したログを読み取るには、コマンドに --freshness フラグを追加します。

gcloud CLI の使用方法に関する詳細については、gcloud logging read をご覧ください。

API

クエリを作成するときは、ログ名ごとに有効なリソース識別子を指定します。たとえば、クエリに PROJECT_ID が含まれている場合、指定するプロジェクト ID は、現在選択された Google Cloud プロジェクトを参照している必要があります。

たとえば、Logging API を使用してプロジェクトレベルの監査ログエントリを表示する手順は次のとおりです。

entries.list メソッドのドキュメント内の [Try this API] セクションに移動します。
[Try this API] フォームのリクエストの本文に、次のコードを入力します。この事前入力されたフォームをクリックすると、リクエストの本文が自動的に入力されますが、それぞれのログ名に有効な PROJECT_ID を指定する必要があります。
```
{
  "resourceNames": [
    "projects/PROJECT_ID"
  ],
  "pageSize": 5,
  "filter": "logName : projects/PROJECT_ID/logs/cloudaudit.googleapis.com"
}
```
[Execute] をクリックします。

監査ログにカスタム情報を追加する

リクエストに x-goog-custom-audit-KEY: VALUE ヘッダーを含めることで、監査ログにカスタム情報を追加できます。XML API リクエストでは、x-goog-custom-audit-KEY=VALUE クエリパラメータも使用できます。カスタム情報は、監査ログエントリの protoPayload の metadata フィールドに追加されます。

カスタム監査情報を追加する際は、次の検討事項を留意してください。

各 KEY の最大文字数は 64 文字で、VALUE の最大文字数は 1,200 文字です。
各リクエストには、最大 4 つのヘッダーまたはパラメータエントリを組み合わせて含めることができます。

ヘッダーエントリの例

ヘッダーエントリに含めることができる Key-Value ペアの例を以下に示します。

x-goog-custom-audit-job: test-job-id-here
x-goog-custom-audit-user: user ID test 1
x-goog-custom-audit-internal-user-id: MATR2022-11
x-goog-custom-audit-tracking-ticket: TT/1516512851
x-goog-custom-audit-justification: Removed customer identity record at customer request
x-goog-custom-audit-customer-id: USCU12315154

リクエストの例