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 フィードを作成する
フィードを作成する
- [設定] > [データ マネジメント] > [フィード] に移動します。SIEM のみのプラットフォームを使用している場合は、[設定] > [フィード] に移動します。
- [Add New Feed] をクリックします。
- 次のページで、[単一のフィードを構成する] をクリックします。
- [フィード名] フィールドに、フィードの名前を入力します(例:
Bitbucket Webhook Logs)。 - [Source type] として [Webhook] を選択します。
- [ログタイプ] として [Atlassian Bitbucket] を選択します。
- [次へ] をクリックします。
- 次の入力パラメータの値を指定します。
- Split delimiter(省略可): 複数行のイベントを分割する区切り文字を入力します。一般的な値:
\n- 改行区切り文字(NDJSON で最も一般的)- 各リクエストに 1 つのイベントが含まれている場合は、空のままにします
- Asset namespace: アセットの名前空間。
- Ingestion labels: このフィードのイベントに適用されるラベル。
- Split delimiter(省略可): 複数行のイベントを分割する区切り文字を入力します。一般的な値:
- [次へ] をクリックします。
- [Finalize] 画面で新しいフィードの設定を確認し、[送信] をクリックします。
秘密鍵を生成して保存する
フィードを作成したら、認証用の秘密鍵を生成する必要があります。
- フィードの詳細ページで、[秘密鍵を生成] をクリックします。
- ダイアログに秘密鍵が表示されます。
- 秘密鍵をコピーして安全に保存します。
フィード エンドポイント URL を取得する
- フィードの [詳細] タブに移動します。
- [エンドポイント情報] セクションで、[フィードのエンドポイント URL] をコピーします。
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>形式のリソースパスです。次の手順で使用するため、この URL を保存します。
[完了] をクリックします。
Google Cloud API キーを作成する
Google SecOps では、認証に API キーが必要です。 Google Cloud コンソールで制限付き API キーを作成します。
API キーを作成する
- Google Cloud コンソールの [認証情報] ページに移動します。
- プロジェクト(Google SecOps インスタンスに関連付けられているプロジェクト)を選択します。
- [認証情報を作成] > [API キー] をクリックします。
- API キーが作成され、ダイアログに表示されます。
- [API キーを編集] をクリックしてキーを制限します。
API キーを制限する
- [API キー] の設定ページで、次の操作を行います。
- 名前: わかりやすい名前を入力します(例:
Webhook API Key)。
- 名前: わかりやすい名前を入力します(例:
- [API の制限] で次の操作を行います。
- [キーを制限] を選択します。
- [API を選択] プルダウンで、Google SecOps API を検索して選択します。
- [保存] をクリックします。
- ページ上部の [API キー] フィールドから API キーの値をコピーします。
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 を作成する
- ワークスペースまたはリポジトリの管理者として Bitbucket Cloud にログインします。
- Webhook を構成するリポジトリに移動します。
- [Repository settings] > [Webhooks] に移動します。
- [Add webhook] をクリックします。
- 次の構成情報を指定します。
- タイトル: わかりやすい名前を入力します(例:
SIEM Webhook)。 - URL: 上記の API キーとシークレットを含む完全なエンドポイント URL を貼り付けます。
- ステータス: [有効] を選択します。
- トリガー: [トリガーの全リストから選択] を選択し、送信するイベントを選択します。
- リポジトリ: Push、Fork、Commit Comment Created
- pull リクエスト: 作成、更新、承認、不承認、マージ、拒否、コメント作成
- 問題: 作成、更新、コメント作成
- タイトル: わかりやすい名前を入力します(例:
- [保存] をクリックします。
Bitbucket データセンターで Webhook を作成する
- プロジェクト管理者またはリポジトリ管理者として Bitbucket データセンターにログインします。
- Webhook を構成するプロジェクトまたはリポジトリに移動します。
- [Project settings] > [Webhooks](プロジェクト レベルの場合)または [Repository settings] > [Webhooks](リポジトリ レベルの場合)に移動します。
- [Create webhook] をクリックします。
- 次の構成情報を指定します。
- 名前: わかりやすい名前を入力します(例:
SIEM Webhook)。 - URL: 上記の API キーとシークレットを含む完全なエンドポイント URL を貼り付けます。
- ステータス: [有効] を選択します。
- イベント: 転送するイベントを選択します。
- リポジトリ: 参照の変更、フォーク、コメントの追加
- pull リクエスト: オープン、ソース ブランチの更新、変更、レビュー担当者の更新、承認、未承認、作業が必要、マージ、拒否、削除、コメントの追加
- 名前: わかりやすい名前を入力します(例:
- [保存] をクリックします。
Webhook の配信を確認する
- Webhook を作成したら、リポジトリでアクションを実行します(例: commit を push する)。
- [Repository settings] > [Webhooks] に移動します。
- Webhook の横にある [リクエストを表示] をクリックします。
- リクエストに 200 ステータス コードが表示され、正常に配信されたことを確認します。
詳細については、Bitbucket Cloud Webhook のドキュメントまたは Bitbucket Data Center Webhook のドキュメントをご覧ください。
認証方法のリファレンス
Google SecOps の Webhook フィードは、複数の認証方法をサポートしています。ベンダーがサポートしている方法を選択してください。
方法 1: カスタム ヘッダー(推奨)
ベンダーがカスタム 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 のプロフェッショナルから回答を得ることができます。