Atlassian Bitbucket のログを収集する

パーサーのバージョン: 2.0

以下でサポートされています。

このドキュメントでは、Webhook を使用してログを Google Security Operations に push するように Atlassian Bitbucket を構成する方法について説明します。

Atlassian Bitbucket は、Git ベースのソースコード リポジトリ ホスティング サービスです。開発チームにコード コラボレーション、pull リクエスト ワークフロー、CI / CD パイプラインを提供します。Bitbucket は、クラウドとセルフホスト(データセンター)の両方のデプロイをサポートしています。

始める前に

次の前提条件を満たしていることを確認します。

  • Google SecOps インスタンス
  • 管理者アクセス権を持つ Atlassian Bitbucket Cloud または Data Center インスタンス
  • Google Cloud コンソールへのアクセス(API キーの作成用)

Google SecOps で Webhook フィードを作成する

フィードを作成する

  1. [設定] > [データ マネジメント] > [フィード] に移動します。SIEM のみのプラットフォームを使用している場合は、[設定] > [フィード] に移動します。
  2. [Add New Feed] をクリックします。
  3. 次のページで、[単一のフィードを構成する] をクリックします。
  4. [フィード名] フィールドに、フィードの名前を入力します(例: Bitbucket Webhook Logs)。
  5. [Source type] として [Webhook] を選択します。
  6. [ログタイプ] として [Atlassian Bitbucket] を選択します。
  7. [次へ] をクリックします。
  8. 次の入力パラメータの値を指定します。
    • Split delimiter(省略可): 複数行のイベントを分割する区切り文字を入力します。一般的な値:
      • \n - 改行区切り文字(NDJSON で最も一般的)
      • 各リクエストに 1 つのイベントが含まれている場合は、空のままにします
    • Asset namespace: アセットの名前空間。
    • Ingestion labels: このフィードのイベントに適用されるラベル。
  9. [次へ] をクリックします。
  10. [Finalize] 画面で新しいフィードの設定を確認し、[送信] をクリックします。

秘密鍵を生成して保存する

フィードを作成したら、認証用の秘密鍵を生成する必要があります。

  1. フィードの詳細ページで、[秘密鍵を生成] をクリックします。
  2. ダイアログに秘密鍵が表示されます。
  3. 秘密鍵をコピーして安全に保存します。

フィード エンドポイント URL を取得する

  1. フィードの [詳細] タブに移動します。
  2. [エンドポイント情報] セクションで、[フィードのエンドポイント URL] をコピーします。
  3. URL の形式は次のとおりです。

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import
    

    ここで、{region} は Google SecOps インスタンスのリージョン(us、europe、asia-southeast1 など)、{parent} は projects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE> 形式のリソースパスです。

  4. 次の手順で使用するため、この URL を保存します。

  5. [完了] をクリックします。

Google Cloud API キーを作成する

Google SecOps では、認証に API キーが必要です。 Google Cloud コンソールで制限付き API キーを作成します。

API キーを作成する

  1. Google Cloud コンソールの [認証情報] ページに移動します。
  2. プロジェクト(Google SecOps インスタンスに関連付けられているプロジェクト)を選択します。
  3. [認証情報を作成] > [API キー] をクリックします。
  4. API キーが作成され、ダイアログに表示されます。
  5. [API キーを編集] をクリックしてキーを制限します。

API キーを制限する

  1. [API キー] の設定ページで、次の操作を行います。
    • 名前: わかりやすい名前を入力します(例: Webhook API Key)。
  2. [API の制限] で次の操作を行います。
    1. [キーを制限] を選択します。
    2. [API を選択] プルダウンで、Google SecOps API を検索して選択します。
  3. [保存] をクリックします。
  4. ページ上部の [API キー] フィールドから API キーの値をコピーします。
  5. API キーを安全に保存します。

Atlassian Bitbucket Webhook を構成する

Webhook URL を作成する

  • Google SecOps エンドポイント URL と API キーを組み合わせます。

    <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>
    
  • 例:

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
    

Bitbucket Cloud で Webhook を作成する

  1. ワークスペースまたはリポジトリの管理者として Bitbucket Cloud にログインします。
  2. Webhook を構成するリポジトリに移動します。
  3. [Repository settings] > [Webhooks] に移動します。
  4. [Add webhook] をクリックします。
  5. 次の構成情報を指定します。
    • タイトル: わかりやすい名前を入力します(例: SIEM Webhook)。
    • URL: 上記の API キーとシークレットを含む完全なエンドポイント URL を貼り付けます。
    • ステータス: [有効] を選択します。
    • トリガー: [トリガーの全リストから選択] を選択し、送信するイベントを選択します。
      • リポジトリ: Push、Fork、Commit Comment Created
      • pull リクエスト: 作成、更新、承認、不承認、マージ、拒否、コメント作成
      • 問題: 作成、更新、コメント作成
  6. [保存] をクリックします。

Bitbucket データセンターで Webhook を作成する

  1. プロジェクト管理者またはリポジトリ管理者として Bitbucket データセンターにログインします。
  2. Webhook を構成するプロジェクトまたはリポジトリに移動します。
  3. [Project settings] > [Webhooks](プロジェクト レベルの場合)または [Repository settings] > [Webhooks](リポジトリ レベルの場合)に移動します。
  4. [Create webhook] をクリックします。
  5. 次の構成情報を指定します。
    • 名前: わかりやすい名前を入力します(例: SIEM Webhook)。
    • URL: 上記の API キーとシークレットを含む完全なエンドポイント URL を貼り付けます。
    • ステータス: [有効] を選択します。
    • イベント: 転送するイベントを選択します。
      • リポジトリ: 参照の変更、フォーク、コメントの追加
      • pull リクエスト: オープン、ソース ブランチの更新、変更、レビュー担当者の更新、承認、未承認、作業が必要、マージ、拒否、削除、コメントの追加
  6. [保存] をクリックします。

Webhook の配信を確認する

  1. Webhook を作成したら、リポジトリでアクションを実行します(例: commit を push する)。
  2. [Repository settings] > [Webhooks] に移動します。
  3. Webhook の横にある [リクエストを表示] をクリックします。
  4. リクエストに 200 ステータス コードが表示され、正常に配信されたことを確認します。

詳細については、Bitbucket Cloud Webhook のドキュメントまたは Bitbucket Data Center Webhook のドキュメントをご覧ください。

認証方法のリファレンス

Google SecOps の Webhook フィードは、複数の認証方法をサポートしています。ベンダーがサポートしている方法を選択してください。

ベンダーがカスタム HTTP ヘッダーをサポートしている場合は、セキュリティを強化するためにこの方法を使用します。

  • リクエストの形式:

    POST <ENDPOINT_URL> HTTP/1.1
    Content-Type: application/json
    x-goog-chronicle-auth: <API_KEY>
    x-chronicle-auth: <SECRET_KEY>
    
    {
            "event": "data",
            "timestamp": "2025-01-15T10:30:00Z"
    }
    
  • メリット:

    • API キーとシークレットが URL に表示されない
    • より安全(ヘッダーはウェブサーバーのアクセスログに記録されない)
    • ベンダーが対応している場合に推奨される方法

方法 2: クエリ パラメータ

ベンダーがカスタム ヘッダーをサポートしていない場合は、URL に認証情報を追加します。

  • URL 形式:

    <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>
    
  • 例:

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
    
  • リクエストの形式:

    POST <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY> HTTP/1.1
    Content-Type: application/json
    
    {
            "event": "data",
            "timestamp": "2025-01-15T10:30:00Z"
    }
    

デメリット:

  • URL に表示される認証情報
  • ウェブサーバーのアクセスログに記録される可能性がある
  • ヘッダーよりも安全性が低い

方法 3: ハイブリッド(URL + ヘッダー)

一部の構成では、URL に API キー、ヘッダーに秘密鍵を使用します。

  • リクエストの形式:

    POST <ENDPOINT_URL>?key=<API_KEY> HTTP/1.1
    Content-Type: application/json
    x-chronicle-auth: <SECRET_KEY>
    
    {
            "event": "data",
            "timestamp": "2025-01-15T10:30:00Z"
    }
    

認証ヘッダー名

Google SecOps は、認証に次のヘッダー名を受け入れます。

API キーの場合:

  • x-goog-chronicle-auth(推奨)
  • X-Goog-Chronicle-Auth(大文字と小文字を区別しない)

秘密鍵の場合:

  • x-chronicle-auth(推奨)
  • X-Chronicle-Auth(大文字と小文字を区別しない)

Webhook の制限とベスト プラクティス

リクエストに関する上限

上限 値
最大リクエスト サイズ 4 MB
最大 QPS(秒間クエリ数) 15,000
リクエストのタイムアウト 30 秒
再試行の動作 指数バックオフによる自動

UDM マッピング テーブル

ログフィールド UDM マッピング ロジック
actor.display_name principal.user.user_display_name actor.display_name フィールドから取得された値。
actor.nickname principal.user.userid actor.nickname フィールドから取得された値。
actor.account_id principal.user.product_object_id actor.account_id フィールドから取得された値。
actor.uuid principal.user.product_object_id actor.account_id が存在しない場合に actor.uuid フィールドから取得される値。
actor.links.html.href principal.url actor.links.html.href フィールドから取得された値。
repository.full_name target.resource.name repository.full_name フィールドから取得された値。
repository.uuid target.resource.product_object_id repository.uuid フィールドから取得された値。
repository.links.html.href target.url repository.links.html.href フィールドから取得された値。
repository.project.key target.resource.attribute.labels キー「project_key」で Key-Value ペアとして追加されます。
repository.project.name target.resource.attribute.labels キー「project_name」で Key-Value ペアとして追加されます。
repository.workspace.slug target.resource.attribute.labels キー「workspace」で Key-Value ペアとして追加されます。
push.changes[].new.name target.resource.attribute.labels キー「branch_name」で Key-Value ペアとして追加されます。
push.changes[].new.target.hash target.resource.attribute.labels キー「commit_hash」で Key-Value ペアとして追加されます。
push.changes[].new.target.message target.resource.attribute.labels キー「commit_message」で Key-Value ペアとして追加されます。
push.changes[].new.target.date target.resource.attribute.labels キー「commit_date」を持つ Key-Value ペアとして追加されます。
push.changes[].new.target.author.raw target.user.email_addresses 作成者の未加工フィールドから抽出されたメールアドレス。
pullrequest.id target.resource.attribute.labels キー「pullrequest_id」を持つ Key-Value ペアとして追加されます。
pullrequest.title target.resource.attribute.labels キー「pullrequest_title」を持つ Key-Value ペアとして追加されます。
pullrequest.state target.resource.attribute.labels キー「pullrequest_state」で Key-Value ペアとして追加されます。
pullrequest.author.display_name target.user.user_display_name pullrequest.author.display_name フィールドから取得された値。
pullrequest.source.branch.name target.resource.attribute.labels キー「source_branch」を持つ Key-Value ペアとして追加されます。
pullrequest.destination.branch.name target.resource.attribute.labels キー「destination_branch」で Key-Value ペアとして追加されます。
date metadata.event_timestamp ISO8601 タイムスタンプとして解析されます。Webhook ペイロードに存在する場合、イベント タイムスタンプとして使用されます。
metadata.event_type 最初は「GENERIC_EVENT」に設定されます。イベントキーと、principal フィールドと target フィールドの有無に基づいて、「USER_RESOURCE_ACCESS」、「USER_RESOURCE_UPDATE_CONTENT」、「USER_UNCATEGORIZED」に変更しました。
metadata.product_event_type X-Event-Key Webhook ヘッダー値(repo:push、pullrequest:created、pullrequest:updated など)に基づいて設定されます。
metadata.product_name 「Atlassian Bitbucket」に設定します。
metadata.vendor_name 「Atlassian」に設定します。

変更ログ

このパーサーの変更ログを表示する

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