Azure API を Google SecOps と統合する

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

ユースケース

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

  • ユニバーサル Microsoft 365 調査: カスタム HTTP リクエスト機能を使用して、Microsoft Graph エンドポイントをクエリします。これにより、アナリストは Teams、SharePoint、Exchange のデータを単一のインターフェースから収集できます。

  • カスタム インシデント修復: 専用の「ワンクリック」アクションが利用できない場合に、ターゲットを絞った POST リクエストまたは PATCH リクエストを実行して Azure サービスの脅威を修復し、新たな脆弱性に迅速に対応します。

  • 自動データ取り込み: さまざまな Azure リポジトリからセキュリティ イベントと監査ログの取り込みをスケジュール設定して、クラウド環境の包括的な可視性を維持します。

  • 安全なマルウェア処理: 組み込みのパスワード保護された ZIP アーカイブ機能を使用して、不審なファイルを安全にダウンロードして分析します。これにより、悪意のあるコンテンツが誤って実行されるのを防ぐことができます。

  • 永続的な認証管理: 更新トークン更新ジョブを使用して OAuth 2.0 トークンを自動的にローテーションし、自動化されたハンドブックとハンティング ジョブが Microsoft 365 サービスへの安全なアクセスを中断なく維持できるようにします。

始める前に

Google SecOps で統合を構成する前に、次のものが揃っていることを確認してください。

  • Microsoft Entra ID アプリケーション: API 通信を容易にするために Microsoft Entra ID ポータルに登録されたアプリケーション。

  • クライアント ID とクライアント シークレット: アプリケーション登録から生成された有効な認証情報。

  • テナント ID: Azure Active Directory インスタンスの固有識別子。

  • リダイレクト URL: 統合パラメータで指定されたリダイレクト URI と一致する、構成済みのリダイレクト URI。

  • API 権限（スコープ）: クエリする Azure サービスに基づいてアプリケーションに割り当てられる特定の権限。

  • 更新トークン: 永続的な委任アクセスに必要な 90 日間有効なトークン。

  • 更新トークンの更新ジョブ: トークンの有効期限切れによる統合エラーを防ぐために使用される重要なセキュリティ自動化。

Azure API 認証の設定

Azure API 統合では、2 種類の認証がサポートされています。必要な権限のセットは、クエリする特定の API リクエストと Azure サービスによって異なります。

  • アプリケーション権限: API リクエストは、Microsoft Entra ID で構成されたアプリケーションの観点から実行されます。この設定には、クライアント ID とクライアント シークレットのみが必要です。

  • 委任された権限: API リクエストは、権限借用が構成されている特定のユーザーに代わって実行されます。

委任認証を確立する

委任された権限を使用するには、次の手順で最初の更新トークンを手動で生成する必要があります。

  1. 統合構成で Client ID、Client Secret、Scope、Redirect URL、Tenant ID を指定します。

  2. Get Authorization アクションを実行します。

  3. アクションによって生成されたリンクをブラウザで開き、リダイレクトされたリンクをコピーします。

  4. リダイレクトされたリンクを Generate Token アクションの入力として指定します。

  5. アクションによって返されたトークンをコピーし、統合構成時に Refresh Token に入力します。

更新トークンの更新を構成する

最初の更新トークンの有効期間は 90 日間です。サービスの中断が発生しないようにするには、更新トークンの更新ジョブを構成して、統合インスタンスの更新トークンを自動的に更新します。

統合のパラメータ

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

パラメータ 説明
Microsoft Login API Root

必須。

Azure API 認証に使用される Microsoft Identity Platform ログイン サービスの API ルート。

デフォルト値は https://login.microsoftonline.com です。
Microsoft Graph API Root

必須。

Azure API オペレーションに使用される Microsoft Graph サービスの API ルート。

デフォルト値は https://graph.microsoft.com です。
Client ID

必須。

Azure API アカウントのクライアント ID。
Client Secret

必須。

Azure API アカウントのクライアント シークレット。
Tenant ID

必須。

Azure API アカウントのテナント ID。
Refresh Token

省略可。

Azure API アカウントへの委任アクセスに使用される更新トークン。

このトークンは 90 日間有効で、初期設定で取得されます。
Verify SSL

省略可。

選択すると、統合は Azure API サーバーに接続するときに SSL 証明書を検証します。

デフォルトで有効になっています。
Redirect URL

省略可。

Microsoft Entra ID アプリケーションに関連付けられているリダイレクト URI。

デフォルト値は http://localhost です。
Test URL

必須。

GET リクエストを使用して Azure API への認証を検証するために使用される URL。
Scopes

必須。

Azure API 認証のスコープのカンマ区切りのリスト。

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

省略可。

リクエストに使用される HTTP メソッド（動詞）。

値は次のいずれかになります。

  • GET
  • POST
  • PUT
  • PATCH
  • DELETE
  • HEAD
  • OPTIONS

デフォルト値は GET です。
URL Path

必須。

リクエストが実行される API エンドポイント。このパスには、必要に応じてクエリ パラメータを含めることができます。
URL Params

省略可。

URL のクエリ パラメータ。JSON オブジェクトとして指定します。

このパラメータは、URL Path で定義済みのクエリ パラメータに追加されるため、このパラメータの入力方法として推奨されます。
Headers

省略可。

HTTP リクエストのヘッダー。JSON オブジェクトとして指定します。

ヘッダーは、認証などの要素を制御し、Body Payload の形式を定義します（Content-Type を使用）。
Cookie

省略可。

HTTP Cookie ヘッダーに構築された Cookie。JSON オブジェクトとして提供されます。

このパラメータは、Headers で指定された Cookie 値をオーバーライドします。
Body Payload

省略可。

HTTP リクエストのコンテンツ ペイロード。JSON オブジェクトとして指定します。

リクエストの形式（JSON または form-urlencoded）は、Headers で設定された Content-Type によって決まります。
Expected Response Values

省略可。

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

省略可。

選択すると、アクションはレスポンス データをファイルとして保存し、ケースウォールに添付します。

ファイルは .zip 拡張子でアーカイブされます。Password Protect Zip が有効になっていない限り、この zip はパスワードで保護されません。
Password Protect Zip

省略可。

選択すると、ダウンロードした ZIP アーカイブ（Save To Case Wall を使用して作成）がパスワード（infected など）で暗号化されます。

このオプションは、不審なファイルや悪意のある可能性のあるファイルを扱う際に、誤って実行されないようにするために使用します。

デフォルトで有効になっています。
Follow Redirects

省略可。

選択すると、アクションは HTTP リダイレクト レスポンス（301 や 302 ステータス コードなど）を自動的にたどり、最終的なリンク先 URL に到達します。

デフォルトで有効になっています。
Fail on 4xx/5xx

省略可。

選択すると、HTTP レスポンスがクライアント エラー（4xx）またはサーバーエラー（5xx）のステータス コードを返したときに、アクションは明示的にステップを失敗させます。

デフォルトで有効になっています。
Base64 Output

省略可。

選択すると、アクションは HTTP レスポンス本文を Base64 でエンコードされた文字列に変換します。これは、ダウンロードしたファイルの処理や保存に役立ちます。

エンコードされた文字列は 15 MB 以下にする必要があります。
Fields To Return

必須。

アクションが出力で返すフィールドのカンマ区切りのリスト。

値は次のいずれかになります。

  • response_data
  • redirects
  • response_code
  • response_cookies
  • response_headers
  • apparent_encoding

デフォルト値は response_data,redirects,response_code,response_cookies,response_headers,apparent_encoding です。
Request Timeout

必須。

リクエストが中止される前に、アクションがサーバーからデータが送信されるのを待機する最大時間（秒単位）。

デフォルト値は 120 です。

アクションの出力

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

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

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

{
   "response_data": {
       "data": {
           "relationships": {
               "comment": [
                   {
                       "name": "example_resource_name",
                       "description": "Description of the object to which the comment belongs."
                   },
                   {
                       "name": "example_user_role",
                       "description": "Description of the user role associated with the comment."
                   }
               ]
           }
       }
   },
   "redirects": [],
   "response_code": 200,
   "cookies": {},
   "response_headers": {
       "Content-Type": "application/json",
       "X-Cloud-Trace-Context": "REDACTED_TRACE_ID",
       "Date": "REDACTED_DATE_TIME",
       "Server": "REDACTED_SERVER_NAME",
       "Content-Length": "REDACTED_VALUE"
   },
   "apparent_encoding": "ascii"
}
出力メッセージ

HTTP リクエストを実行アクションは、次の出力メッセージを返すことができます。

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

Successfully executed API request.

Successfully executed API request, but the status code 4xx_OR_5xx was returned. Please check the request or try again later.

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

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

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

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

スクリプトの結果名 値
is_success true または false

承認の取得

[Get Authorization] アクションを使用して OAuth フローを開始し、委任認証に必要なアクセスコードを含むリンクを取得します。

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

アクションへの入力

Get Authorization アクションには、次のパラメータが必要です。

パラメータ 説明
Oauth Scopes

必須。

アクセス トークンと更新トークンのアクセスレベルを定義する権限（スコープ）のカンマ区切りのリスト。

デフォルト値は user.read, offline_access です。

アクションの出力

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

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

Get Authorization アクションは、次の出力メッセージを返すことができます。

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

Authorization URL generated successfully. To obtain a URL with access code,Please navigate to the link below as the user that you want to run the integration with., to get a URL with access code. Provide the URL with the access code should be provided next in the Generate Token action.

 アクションが成功しました。
Failed to generate the authorization URL! Error is ERROR_REASON

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

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

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

スクリプトの結果名 値
is_success true または false

トークンを生成

委任認証に必要な永続的な更新トークンを取得するには、[Generate Token] アクションを使用します。

このトークンは、Get Authorization アクションから受信した認証 URL を使用して生成されます。

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

アクションへの入力

トークンを生成アクションには、次のパラメータが必要です。

パラメータ 説明
Authorization URL

必須。

Get Authorization アクションから受信した認証コードを含む、リダイレクトされた完全な URL。この URL は、更新トークンのリクエストと生成に使用されます。

アクションの出力

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

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

Generate Token アクションは、次の出力メッセージを返すことができます。

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

Successfully fetched the refresh token: TOKEN_VALUE. Enter this token in the integration configuration to enable the integration to authenticate with delegated permissions on behalf of the user that performed the configuration steps. Note: We strongly recommend you configure the "Refresh Token Renewal Job" after you generate the initial refresh token so the job automatically renews and keeps the token valid.

 アクションが成功しました。
Failed to get the refresh token! Error is ERROR_REASON

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

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

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

スクリプトの結果名 値
is_success true または false

Ping

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

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

アクションへの入力

なし

アクションの出力

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

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

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

{
    "endpoint": "https://api.example-cloud-provider.com/v1.0/health"
}
出力メッセージ

Ping アクションは、次の出力メッセージを返すことができます。

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

Successfully tested connectivity.

 アクションが成功しました。
Failed to test connectivity. ERROR_REASON

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

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

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

スクリプトの結果名 値
is_success true または false

ジョブ

ジョブの詳細については、 新しいジョブを構成すると 高度なスケジューリングをご覧ください。

更新トークンの更新ジョブ

更新トークン更新ジョブを使用して、統合用に構成された更新トークンを定期的に更新します。

デフォルトでは、更新トークンは 90 日ごとに有効期限が切れます。更新トークンを最新の状態に保つため、このジョブを 7 日または 14 日ごとに自動的に実行するように構成することをおすすめします。

ジョブ パラメータ

更新トークン更新ジョブには、次のパラメータが必要です。

パラメータ 説明
Integration Environments

省略可。

ジョブが更新トークンを更新する統合環境名のカンマ区切りのリスト。

各環境名は二重引用符で囲む必要があります。

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