Google Cloud API

このドキュメントでは、Google Cloud API を構成して Google Security Operations と統合する方法について説明します。

ユースケース

Google Cloud API 統合では、Google SecOps の機能を使用して、次のユースケースをサポートします。

  • リソース管理の自動化: Compute Engine や Cloud Storage などの Google Cloudサービス全体でアクションを実行して、脅威を修正したり、インフラストラクチャを動的に管理したりします。

  • ID とアクセス ガバナンス: 検出されたセキュリティ インシデントに応じて、Identity and Access Management のポリシーまたはロールをプログラムで調整します。

  • カスタム API オーケストレーション: 専用の統合がない有効な Google Cloud API とやり取りして、複雑なハンドブックに最大限の柔軟性を提供します。

  • 鍵なし認証: Workload Identity を使用して Google Cloud リソースに安全にアクセスし、静的サービス アカウント キーに関連するリスクを排除します。

始める前に

Google SecOps プラットフォームで統合を構成する前に、次のものが揃っていることを確認してください。

  • ターゲット API の有効化: 自動化する特定のGoogle Cloud サービスを特定して有効にします。

  • IAM 権限: 実行する特定のアクションに必要なロールが ID に付与されていることを確認します。

  • 認証方法: 推奨される Workload Identity またはサービス アカウントの JSON キーのいずれかを選択します。

ターゲット API を特定して有効にする

この統合は汎用ゲートウェイであるため、固定 API はありません。要件は、特定のユースケースによって異なります。統合を介して実行するには、プロジェクトでターゲット API（Compute Engine、Cloud Storage、IAM など）を有効にする必要があります。

次の手順で、ターゲット API を特定して有効にします。

  1. Google Cloud コンソールで、[API とサービス] > [ライブラリ] に移動します。

  2. 必要なサービスを検索して有効にします。

IAM 権限を構成する

この統合で使用されるサービス アカウントまたは ID には、適切な IAM ロールが必要です。

  • 最小権限の原則: 目的の API 呼び出しに必要な特定のロールのみを付与します。

  • 動的要件: 権限はオペレーションによって異なります。たとえば、リソースの管理には、リソースの一覧表示とは異なるロールが必要です。

認証方法を選択する

Google SecOps は、この統合で次の 2 つの認証パスをサポートしています。

Workload Identity を使用して認証する（推奨）

Workload Identity は、長期間有効な JSON キーを管理またはローテーションする必要がないため、最も安全な方法です。サービス アカウントの権限借用を使用して、プラットフォームがリソースに安全にアクセスできるようにします。

Google SecOps インスタンスの ID を特定する

インスタンスの一意の ID を確認する手順は次のとおりです。

  1. Google SecOps で、[Content Hub] > [Response Integrations] に移動します。

  2. [Google Cloud API] 統合を選択します。

  3. [Workload Identity Email] フィールドに、ターゲット サービス アカウントのメールアドレスを入力します。

  4. [保存] をクリックし、[テスト] をクリックします。テストは失敗することが想定されます。

  5. [テスト] の右側にある close_small をクリックし、gke-init-python@... または soar-python@... で始まる ID メールアドレスのエラー メッセージを検索します。

  6. この固有のメールアドレスをコピーします。

権限の借用を付与する

次の手順で、インスタンス ID にリソースへのアクセスを認可します。

  1. Google Cloud コンソールで、[IAM と管理] > [サービス アカウント] に移動します。

    [サービス アカウント] に移動

  2. 対象のサービス アカウントを選択し、[権限] > [アクセスを許可] に移動します。

  3. 一意のメールアドレスを [新しいプリンシパル] フィールドに貼り付け、サービス アカウント トークン作成者ロール（roles/iam.serviceAccountTokenCreator）を割り当てます。

JSON キーを使用して認証する

この方法は、Workload Identity が環境で使用できない場合にのみ使用してください。

サービス アカウントの JSON キーを使用して統合を認証する手順は次のとおりです。

  1. Google Cloud コンソールで、サービス アカウントを作成します。

  2. [鍵] タブに移動し、[鍵を追加] > [新しい鍵を作成] を選択します。

  3. 鍵のタイプとして JSON を選択し、ファイルをダウンロードします。

  4. このファイルの内容全体をコピーし、Google SecOps での統合構成時に Service Account Json File Content に貼り付けます。

Google Cloud API を Google SecOps SOAR と統合する

この統合には、次のパラメータが必要です。

パラメータ 説明
Test URL Optional

Google Cloud API への認証を検証するためのテスト URL。このパラメータは GET リクエストを使用します。
Service Account Json File Content Optional

サービス アカウント キーの JSON ファイルの内容。

このパラメータ、Workload Identity Email パラメータ、または前述のすべての統合パラメータを設定できます。

このパラメータを構成するには、サービス アカウントの作成時にダウンロードしたサービス アカウント キーの JSON ファイルの内容をすべて指定します。

サービス アカウントを認証方法として使用する方法については、サービス アカウントの概要とサービス アカウントの権限借用をご覧ください。

この統合では、サービス アカウント キーの JSON ファイルを使用した認証が、Workload Identity のメールよりも優先されます。
Organization ID Optional

統合で使用する組織 ID。

アクションの実行中にこのパラメータから値を取得するには、プレースホルダ {{org_id}} を設定します。
Project ID Optional

統合で使用するプロジェクト ID。

アクションの実行中にこのパラメータから値を取得するには、プレースホルダ {{project_id}} を設定します。
Quota Project ID Optional

Google Cloud API と課金に使用する Google Cloud プロジェクト ID。このパラメータでは、サービス アカウントに Service Usage Consumer ロールを付与する必要があります。

このパラメータ値は、すべての API リクエストに添付されます。

このパラメータに値を設定しない場合、統合は Google Cloud サービス アカウントからプロジェクト ID を取得します。
Workload Identity Email Optional

サービス アカウントのクライアント メールアドレス。

このパラメータまたは Service Account Json File Content パラメータを構成できます。

この統合では、サービス アカウント キーの JSON ファイルを使用した認証が Workload Identity のメールよりも優先されます。

Workload Identity でサービス アカウントの権限を借用するには、サービス アカウントの Google SecOps インスタンス ID に Service Account Token Creator ロールを付与します。Workload Identity とその操作方法の詳細については、ワークロードの ID をご覧ください。
OAuth Scopes Optional

Google Cloud API リクエストの実行に必要な OAuth スコープのカンマ区切りのリスト。
Verify SSL 必須

選択すると、統合によって Google Cloud サービスへの接続用の SSL 証明書が有効かどうかが検証されます。

デフォルトで選択されます。

Google SecOps で統合を構成する手順については、統合を構成するをご覧ください。

必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できます。複数のインスタンスの構成とサポートの詳細については、複数のインスタンスのサポートをご覧ください。

操作

アクションの詳細については、 デスクから保留中のアクションに対応するとケースで手動アクションを実行するをご覧ください。

HTTP リクエストを実行する

[Execute HTTP Request] アクションを使用して、ターゲット URL に対してカスタマイズされた HTTP API リクエストを作成して実行します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションの動作

このアクションは、非同期ポーリング、動的ペイロードの構築、ファイル管理などの複雑な動作をサポートします。

非同期ポーリング

Expected Response Values が指定されている場合、アクションは非同期モードで動作します。このモードでは、アクションはターゲット エンドポイントを繰り返しポーリングして、レスポンスの状態を追跡します（たとえば、長時間実行タスクの完了を待機します）。

このアクションは、パラメータで指定された JSON 条件に対してレスポンス本文を評価し、条件が満たされるか、アクションがタイムアウトに達するまで実行を継続します。

条件ロジック

このアクションは、レスポンスの状態を追跡するために次のロジックをサポートしています。

  • 単一フィールドの一致: アクションは、特定のフィールドが単一の値に達するまで待機します。

    {
  "state": "finished"
}

  • 複数の値（OR ロジック）: フィールドが指定されたリスト内のいずれかの値と一致すると、アクションの実行が停止します。これは、不要なポーリングを回避するために「成功」状態と「エラー」状態の両方で停止する場合に便利です。

    {
  "state": ["finished", "error"]
}

  • 複数のフィールド（AND ロジック）: 指定されたすべてのフィールドがそれぞれの値と同時に一致するまで、アクションは待機します。

    {
  "state": "finished",
  "percentage": "100"
}

  • 結合ロジック: JSON オブジェクト内で複数の条件を結合できます。

    {
  "state": ["finished", "error"],
  "percentage": "10"
}
JSON 解析の動作

条件を評価する際、アクションは次のルールに従います。

  • グローバル検索: このアクションは、JSON レスポンス オブジェクト全体で指定されたキーを検索します。親オブジェクト名を先頭に付けたり、接頭辞を使用したりせずに、JSON に表示されているとおりにキー名を指定します（例: "data_state" や "data-state" ではなく "state" を使用します）。

  • 複数の同一キー: レスポンスに、JSON 階層の異なるレベルで同じ名前のキーが複数含まれている場合、想定される出力は、一致するすべてのキー名が同一の想定される値を満たしている場合にのみ到達します。

    たとえば、JSON レスポンスで finished 状態を検索し、他の状態を無視するには、Expected Response Values のすべての state キーを finished に設定します。

    {
"data": {
  "state": "finished"
  },
  "state": "finished"
}
本文ペイロードの作成

このアクションは、Headers で指定された Content-Type ヘッダーに基づいてリクエスト本文を作成します。

これは、次の作成例で使用される Body Payload 入力です。

{
  "Id": "123123",
  "sorting": "asc"
}

  • application/x-www-form-urlencoded: アクションはペイロードを Id=123123&sorting=asc として生成します。

  • application/json: このアクションにより、次の JSON ペイロードが生成されます。

    {
  "Id": "123123",
  "sorting": "asc"
}

  • XML: サードパーティ プロダクトで XML が必要な場合は、XML 形式の入力を Body Payload に直接指定します。

    <?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="[http://schemas.xmlsoap.org/soap/envelope/](http://schemas.xmlsoap.org/soap/envelope/)">
<soap:Body>
  <NumberToWords xmlns="[http://www.dataaccess.com/webservicesserver/](http://www.dataaccess.com/webservicesserver/)">
    <ubiNum>500</ubiNum>
  </NumberToWords>
</soap:Body>
</soap:Envelope>
ファイル操作

このアクションは、ファイルを管理するための次のワークフローをサポートしています。

  • ファイルのダウンロード:

    • ファイルデータを base64 形式の JSON 結果の一部として返すには、[Base64 Output] を選択します。

    • ファイルを ZIP アーカイブとしてケースウォールに直接保存するには、Save To Case Wall を選択します。

  • ファイルのアップロード: ファイルをアップロードするには、ファイルを base64 エンコード文字列に変換し、Body Payload 値の一部として含めます。

    次の例は、base64 でエンコードされた文字列に変換された画像ファイルを示しています。

    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

  • セキュリティ: 機密ファイル（マルウェアなど）の場合は、Password Protect Zip を選択します。これにより、Save To Case Wall を使用して作成された保存済みの ZIP アーカイブが、パスワード infected で自動的に暗号化されます。

ハンドブック ブロックの構成

次の構成は、ハンドブック ブロック内で HTTP リクエストを実行 アクションを使用する方法を示しています。この例では、プレースホルダと入力接頭辞を適用する方法について説明します。

ブロック入力をプレースホルダとして使用する場合は、Input. 接頭辞（例: [Input.comment]）を含める必要があります。

  • Method: PUT

  • URL パス:

    https://{API_URL}/[Input.table_name]/[Input.sys_id]

  • ヘッダー:

    {
  "Content-type": "application/json; charset=utf-8",
  "Accept": "application/json",
  "User-Agent": "GoogleSecops"
}

  • 本文ペイロード:

    {
  "work_notes": "[Input.comment]"
}

アクションへの入力

HTTP リクエストを実行アクションには、次のパラメータが必要です。

パラメータ 説明
Method Optional

リクエストで使用するメソッド。

デフォルト値は GET です。

指定できる値は次のとおりです。
  • GET
  • POST
  • PUT
  • PATCH
  • DELETE
  • HEAD
  • OPTIONS
URL Path Optional

実行する URL。

デフォルト値は https:// です。
URL Params Optional

URL パラメータ。

このアクションでは、URL パスパラメータで直接指定した値とともに、指定された値が使用されます。

このパラメータには、入力として JSON オブジェクト形式が必要です。デフォルト値は次のとおりです。

{
    "URL Field Name": "URL_FIELD_VALUE"
    }
Headers Optional

HTTP リクエストで使用するヘッダー。

このパラメータには、入力として JSON オブジェクト形式が必要です。デフォルト値は次のとおりです。

{
    "Content-Type": "application/json; charset=utf-8",
    "Accept": "application/json",
    "User-Agent" : "GoogleSecOps"
    }
Cookie Optional

Cookie ヘッダーで使用するパラメータ。

このパラメータは、Headers パラメータで指定された Cookie を上書きします。

このパラメータには、入力として JSON オブジェクト形式が必要です。デフォルト値は次のとおりです。

{
    "Cookie_1": "COOKIE_1_VALUE"
    }
Body Payload
 省略可

HTTP リクエストの本文。このアクションは、Headers パラメータで指定された Content-Type ヘッダー値に応じて異なるペイロードを構築します。

このパラメータでは、サードパーティ プロダクトで XML または multipart/form-data コンテンツが必要な場合を除き、JSON オブジェクト形式を入力として指定する必要があります。API リクエストを使用してファイルを送信またはアップロードする場合は、Body Payload パラメータに Base64 でエンコードされたバージョンのファイルを指定し、ヘッダーを "Content-type": "multipart/form-data" に設定します。

デフォルト値は次のとおりです。

{
    "Body Field Name": "BODY_FIELD_VALUE"
    }
Expected Response Values

省略可。

レスポンス本文の必要な状態を定義するフィールド値ペアを含む JSON オブジェクト。
Save To Case Wall Optional

選択すると、アクションによってファイルが保存され、保存されたファイルがケースウォールに添付されます。ファイルは .zip 拡張子でアーカイブされます。.zip ファイルがパスワードで保護されていない。

デフォルトでは選択されていません。
Password Protect Zip Optional

選択すると、Save To Case Wall パラメータを使用して作成された .zip ファイルにパスワードが追加されます。パスワードは infected です。

不審なファイルを操作する場合は、このパラメータを使用します。

デフォルトで選択されます。
Follow Redirects Optional

選択すると、アクションはリダイレクトに従います。

デフォルトで選択されます。
Fail on 4xx/5xx Optional

選択すると、レスポンスのステータス コードが 4xx または 5xx エラーの場合、アクションは失敗します。

デフォルトで選択されます。
Base64 Output Optional

選択すると、アクションはレスポンスを base64 形式に変換します。

このパラメータは、ファイルをダウンロードするときに使用します。

JSON の結果は 15 MB を超えることはできません。

デフォルトでは選択されていません。
Fields To Return 必須

返されるフィールド。値は次のいずれかになります。

  • response_data
  • redirects
  • response_code
  • response_cookies
  • response_headers
  • apparent_encoding
Request Timeout 必須

アクションが失敗する前にサーバーがデータを送信するのを待機する期間。

デフォルト値は 120 秒です。

アクションの出力

Execute HTTP Request アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、HTTP リクエストを実行アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
   "response_data": {
       "data": {
           "relationships": {
               "comment": [
                   {
                       "name": "item",
                       "description": "Object to which the comment belongs to."
                   },
                   {
                       "name": "author",
                       "description": "User who wrote the comment."
                   }
               ]
           }
       }
   },
   "redirects": [],
   "response_code": 200,
   "cookies": {},
   "response_headers": {
       "Content-Type": "application/json",
       "X-Cloud-Trace-Context": "VALUE",
       "Date": "Fri, 03 Nov 2023 16:14:13 GMT",
       "Server": "Google Frontend",
       "Content-Length": "36084"
   },
   "apparent_encoding": "ascii"
}
出力メッセージ

HTTP リクエストを実行アクションでは、次の出力メッセージが表示されます。

出力メッセージ メッセージの説明

Successfully executed API request.

Successfully executed API request, but the status code {4xx/5xx} was returned. Please check the request or try again later.

 アクションが成功しました。
Failed to execute API request. Error: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、HTTP リクエストを実行アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success True または False

Ping

Ping アクションを使用して、 Google Cloudへの接続をテストします。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

なし

アクションの出力

Ping アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Ping アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
"endpoint": "TEST_URL"
}
出力メッセージ

Ping アクションでは、次の出力メッセージが表示されます。

出力メッセージ メッセージの説明
Successfully tested connectivity. アクションが成功しました。
Failed to test connectivity.

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、Ping アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success True または False

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。