本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

透過 Webhook 叫用 DevOps 代理程式

Webhook 可讓外部系統自動觸發 AWS DevOps 代理程式調查。這可整合票證系統、監控工具，以及可在事件發生時傳送 HTTP 請求的其他平台。

先決條件

在設定 Webhook 存取之前，請確定您有：

Webhook 類型

AWS DevOps Agent 支援下列類型的 Webhook：

Webhook 身分驗證方法

Webhook 的身分驗證方法取決於它與哪個整合相關聯：

HMAC 身分驗證 – 用於：

承載字符身分驗證 – 用於：

了解 HMAC 身分驗證

HMAC （以雜湊為基礎的訊息驗證碼） 是一種密碼編譯機制，可驗證 Webhook 請求的完整性和真實性。當您使用 HMAC 身分驗證傳送 Webhook 時，您會使用私密金鑰搭配 SHA-256 演算法，將請求時間戳記和承載雜湊在一起來產生簽章。 AWS DevOps 代理程式會在其端獨立運算相同的雜湊，並比較兩個簽章。如果相符，則會接受請求。

由於時間戳記包含在簽章中，HMAC 也提供重播保護： AWS DevOps 代理程式可以拒絕過去時間戳記太久的請求，防止攻擊者擷取和重新傳送有效的請求。

在 HMAC 和承載字符之間進行選擇

設定 Webhook 存取

步驟 1：導覽至 Webhook 組態

步驟 2：產生 Webhook 登入資料

對於整合特定的 Webhook：

當您完成第三方整合的組態時，Webhook 會自動產生。Webhook 端點 URL 和登入資料會在整合設定程序結束時提供。

對於一般 Webhook：

步驟 3：設定外部系統

使用 Webhook 端點 URL 和登入資料，將外部系統設定為將請求傳送至 AWS DevOps 代理程式。特定組態步驟取決於您的外部系統。

管理 Webhook 登入資料

移除登入資料 – 若要刪除 Webhook 登入資料，請前往 Webhook 組態區段，然後按一下移除。移除登入資料後，Webhook 端點將不再接受請求，直到您產生新的登入資料為止。

重新產生登入資料 – 若要產生新的登入資料，請先移除現有的登入資料，然後產生新的金鑰對或字符。

使用 Webhook

Webhook 請求格式

若要觸發調查，您的外部系統應將 HTTP POST 請求傳送至 Webhook 端點 URL。

對於第 1 版 (HMAC 身分驗證）：

標頭：

HMAC 簽章是透過使用 SHA-256 使用您的私密金鑰簽署請求內文來產生。

對於第 2 版 （承載字符身分驗證）：

標頭：

請求內文：

請求內文應包含事件的相關資訊：

json

{
  "title": "Incident title",
  "severity": "high",
  "affectedResources": ["resource-id-1", "resource-id-2"],
  "timestamp": "2025-11-23T18:00:00Z",
  "description": "Detailed incident description",
  "data": {
    "metadata": {
        "region": "us-east-1",
        "environment": "production"
    }
  }
}

承載結構描述：

{
    eventType: 'incident';
    incidentId: string;
    action: 'created' | 'updated' | 'closed' | 'resolved';
    priority: "CRITICAL" | "HIGH" | "MEDIUM" | "LOW" | "MINIMAL";
    title: string;
    description?: string;
    timestamp?: string;
    service?: string;
    // The original event generated by service is attached here.
    data?: object;
}

範例程式碼

第 1 版 (HMAC 身分驗證） - JavaScript：

const crypto = require('crypto');

// Webhook configuration
const webhookUrl = 'https://your-webhook-endpoint.amazonaws.com/invoke';
const webhookSecret = 'your-webhook-secret-key';

// Incident data
const incidentData = {  
    eventType: 'incident',
    incidentId: 'incident-123',
    action: 'created',
    priority: "HIGH",
    title: 'High CPU usage on production server',
    description: 'High CPU usage on production server host ABC in AWS account 1234 region us-east-1',
    timestamp: new Date().toISOString(),
    service: 'MyTestService',
    data: {
      metadata: {
        region: 'us-east-1',
        environment: 'production'
      }
    }
};

// Convert data to JSON string
const payload = JSON.stringify(incidentData);
const timestamp = new Date().toISOString();
const hmac = crypto.createHmac("sha256", webhookSecret);
hmac.update(`${timestamp}:${payload}`, "utf8");
const signature = hmac.digest("base64");

// Send the request
fetch(webhookUrl, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-amzn-event-timestamp': timestamp,
    'x-amzn-event-signature': signature
  },
  body: payload
})
.then(res => {
  console.log(`Status Code: ${res.status}`);
  return res.text();
})
.then(data => {
  console.log('Response:', data);
})
.catch(error => {
  console.error('Error:', error);
});

第 1 版 (HMAC 身分驗證） - cURL：

#!/bin/bash

# Configuration
WEBHOOK_URL="https://event-ai.us-east-1.api.aws/webhook/generic/YOUR_WEBHOOK_ID"
SECRET="YOUR_WEBHOOK_SECRET"

# Create payload
TIMESTAMP=$(date -u +%Y-%m-%dT%H:%M:%S.000Z)
INCIDENT_ID="test-alert-$(date +%s)"

PAYLOAD=$(cat <<EOF
{
"eventType": "incident",
"incidentId": "$INCIDENT_ID",
"action": "created",
"priority": "HIGH",
"title": "Test Alert",
"description": "Test alert description",
"service": "TestService",
"timestamp": "$TIMESTAMP"
}
EOF
)

# Generate HMAC signature
SIGNATURE=$(echo -n "${TIMESTAMP}:${PAYLOAD}" | openssl dgst -sha256 -hmac "$SECRET" -binary | base64)

# Send webhook
curl -X POST "$WEBHOOK_URL" \
-H "Content-Type: application/json" \
-H "x-amzn-event-timestamp: $TIMESTAMP" \
-H "x-amzn-event-signature: $SIGNATURE" \
-d "$PAYLOAD"

第 2 版 （承載字符身分驗證） - JavaScript：

function sendEventToWebhook(webhookUrl, secret) {
  const timestamp = new Date().toISOString();
  
  const payload = {
    eventType: 'incident',
    incidentId: 'incident-123',
    action: 'created',
    priority: "HIGH",
    title: 'Test Alert',
    description: 'Test description',
    timestamp: timestamp,
    service: 'TestService',
    data: {}
  };

  fetch(webhookUrl, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-amzn-event-timestamp": timestamp,
      "Authorization": `Bearer ${secret}`,  // Fixed: template literal
    },
    body: JSON.stringify(payload),
  });
}

第 2 版 （承載字符身分驗證） - cURL：

#!/bin/bash

# Configuration
WEBHOOK_URL="https://event-ai.us-east-1.api.aws/webhook/generic/YOUR_WEBHOOK_ID"
SECRET="YOUR_WEBHOOK_SECRET"

# Create payload
TIMESTAMP=$(date -u +%Y-%m-%dT%H:%M:%S.000Z)
INCIDENT_ID="test-alert-$(date +%s)"

PAYLOAD=$(cat <<EOF
{
"eventType": "incident",
"incidentId": "$INCIDENT_ID",
"action": "created",
"priority": "HIGH",
"title": "Test Alert",
"description": "Test alert description",
"service": "TestService",
"timestamp": "$TIMESTAMP"
}
EOF
)

# Send webhook
curl -X POST "$WEBHOOK_URL" \
-H "Content-Type: application/json" \
-H "x-amzn-event-timestamp: $TIMESTAMP" \
-H "Authorization: Bearer $SECRET" \
-d "$PAYLOAD"

故障診斷 Webhook

如果您沒有收到 200

收到 200 和 Webhook 等訊息表示已通過身分驗證，且訊息已排入佇列，供系統驗證和處理。如果您沒有得到 200，但 4xx 最有可能是身分驗證或標頭有問題。嘗試使用 curl 選項手動傳送，以協助偵錯身分驗證。

如果您收到 200，但調查未開始

可能的原因是承載格式錯誤。

如果您收到 200 且調查立即取消

您很可能已達到該月的限制。如果適用，請與您的 AWS 聯絡人討論，要求變更費率限制。

相關主題