Webhook
プレビュー
Lakewatch は プライベートプレビュー段階です。アクセスをリクエストするには、Databricksアカウントチームにお問い合わせください。
Lakewatch アラートをWebhookにエクスポートします。アラートが作成されると、Lakewatch はそれを設定した HTTPS Endpoint に JSON ペイロードとして送信し、独自の自動化でアラートに対応できるようにします。送信先全体でのエクスポートの動作については、アラート通知先を参照してください。
Webhookへのエクスポートは一方向で、LakewatchからEndpointへのエクスポートのみです。
Webhookペイロード
LakewatchがアラートをWebhookにエクスポートすると、HTTP POSTリクエストでJSONペイロードが送信されます。Lakewatchは、アラートが作成されたときにlakewatch.alert.createdイベントを送信します。また、すでにエクスポートされたアラートの状態、タイトル、重要度、説明、分類、または担当者が変更されたときにもlakewatch.alert.updatedイベントを送信しますが、これは宛先に対して更新配信が有効になっている場合に限られます。アラートが終了すると、alert_stateがRESOLVEDまたはDUPLICATEに設定されたupdatedイベントを受け取ります。独立した終了イベントはありません。更新配信を有効にするには、設定で「 アラートの更新も送信 」を選択します。設定を構成を参照してください。
Lakewatchは各イベントを1回送信し、配信に失敗した場合に再試行しません。アラートはLakewatchに表示されます。
キーはsnake_caseです。Enumフィールドは、数値ではなく、 "SECURITY_ALERT" のような文字列の名前として送信されます。設定されていないオプション フィールドは、 null として送信されるのではなく JSON から省略されるため、欠落している数値フィールドは 0 ではなく存在しません。
ヘッダー
各リクエストには次のヘッダーが含まれています。
Content-Type:application/jsonUser-Agent:Databricks-Webhooks/1.0X-Webhook-Event-TypeイベントタイプX-Delivery-Attempt-Id: 配信試行IDX-Webhook-Timestamp: エポックミリ秒単位の配信時間
エンベロープフィールド
フィールド | 説明 |
|---|---|
|
|
| 各配信で一意です。2回届いたリクエストは同じ値になります。同じアラートのイベントを照合するには、 |
| 配信が送信されたエポック（ミリ秒単位）。アラートが作成された時刻ではありません。 |
| アラートオブジェクト。「アラートフィールド」を参照してください。 |
アラートフィールド
dataオブジェクトにはアラートが含まれています。以下は、ほとんどの利用者が操作するフィールドです：
フィールド | 説明 |
|---|---|
| グローバルに一意のアラート ID (uuidv7)。このフィールドは、同じアラートの |
| 人が読みやすい表示 ID（例： |
|
|
|
|
|
|
| 短いアラートタイトル。 |
|
|
| アラートが割り当てられているプリンシパル。割り当てられるまで設定されないため、 |
| Lakewatch UI内のアラートへのディープリンク。設定解除も可能です。 |
| アラートが作成されたエポックミリ秒。 |
| アラートを作成したプリンシパル: |
ペイロードには、name（アラートのリソース名）、description、rule_version、first_event_summary、first_event_at_millis、last_event_at_millis、total_event_count、triggering_signal（代表的なセキュリティイベント）を含めることもできます。
以下は、lakewatch.alert.createdペイロードの例です。
{
"delivery_attempt_id": "fde7344f-2786-4516-a30b-dbd920207c9c",
"event_type": "lakewatch.alert.created",
"delivery_time_millis": 1790205121081,
"data": {
"name": "rules/4b54c235-39e7-476e-aac8-260f123f4533/alerts/81030035-3fa7-4ac2-859f-4215ebeca2d9",
"alert_id": "81030035-3fa7-4ac2-859f-4215ebeca2d9",
"seq_id": "sec-512",
"alert_type": "SECURITY_ALERT",
"alert_state": "OPEN",
"severity": "Medium",
"title": "Suspicious login activity",
"alert_url": "https://<workspace-host>/lakewatch/explore/alerts/sec-512",
"first_event_summary": "Multiple failed logins from a new location",
"total_event_count": 1,
"created_at_millis": 1790204960768,
"created_by": {
"id": "147014482147330",
"principal_type": "REGULAR_USER",
"email": "analyst@example.com",
"display_name": "Alex Analyst"
}
}
}
updated イベントは同じ形状で、 event_type が lakewatch.alert.updated に設定され、現在の alert_state があり、 classification や assignee などの作成後のフィールドが入力されています。
前提条件
POST リクエストを受け入れ、アラート JSON ペイロードを処理できる HTTPS Endpoint。Endpointはパブリックインターネットからアクセスできる必要があります。Lakewatchは、 Private Service Connect の背後にある Endpoint のようなプライベートネットワークには配信できません。
Webhookをアラート通知先として設定する
アラート の設定セクションで、アラートのWebhook送信先を設定します。
- Lakewatchサイドバーで、 設定 に移動し、 アラート を開きます。
- 配信 で、 アラート通知先 を Webhook に設定します。
- [Webhook URL] に、アラートが送信されるEndpointを入力します。
- 変更を保存します。
アラート設定の全リファレンスについては、「 設定の構成」を参照してください。
トラブルシューティング
- ペイロードがEndpointに到達しません :URLが間違っているか、EndpointがPOST要求を受け入れていません。URL を確認し、Endpoint に到達可能であり、 JSON POST を受け入れることを確認します。
- 構成が保存されません : webhook URLがHTTPSを使用していないか、プライベートネットワークを指しています。URLが
https://で始まり、Endpointがパブリックインターネットからアクセス可能であることを確認します。