Webhook和AEM活動

瞭解如何在webhook上接收AEM事件,並檢閱事件詳細資訊,例如裝載、標題和中繼資料。

在此範例中,利用Adobe提供的​ 託管webhook ​可讓您接收AEM事件,而不需要設定您自己的webhook。 此Adobe提供的webhook託管於Glitch,這個平台以提供有助於建置和部署Web應用程式的網頁式環境而聞名。 不過,您也可以選擇使用您自己的webhook選項(若偏好使用)。

先決條件

若要完成本教學課程,您需要:

IMPORTANT
AEM as a Cloud Service事件僅適用於搶鮮版模式的註冊使用者。 若要在您的AEM as a Cloud Service環境中啟用AEM事件,請連絡AEM-Eventing團隊

存取webhook

若要存取Adobe提供的webhook,請按照以下步驟操作:

  • 確認您可以在新的瀏覽器分頁中存取問題 — 託管的webhook

    問題 — 託管的webhook

  • 輸入您webhook的唯一名稱,例如<YOUR_PETS_NAME>-aem-eventing,然後按一下​ 連線。 您應該會看到Connected to: ${YOUR-WEBHOOK-URL}訊息出現在畫面上。

    問題 — 建立webhook

  • 記下​ Webhook URL。 在本教學課程的後半部分,您會用到它。

在Adobe Developer Console專案中設定webhook

若要在上述webhook URL上接收AEM活動,請按照以下步驟操作:

  • Adobe Developer Console中,導覽至您的專案並按一下以開啟專案。

  • 在​ 產品與服務 ​區段下,按一下應將AEM事件傳送至webhook之所需事件卡片旁的省略符號...,並選取​ 編輯

    Adobe Developer Console專案編輯

  • 在新開啟的​ 設定事件註冊 ​對話方塊中,按一下​ 下一步 ​以繼續進行​ 如何接收事件 ​步驟。

    Adobe Developer Console專案設定

  • 在​ 如何接收事件 ​步驟中,選取​ Webhook ​選項並貼上您先前從Glitch託管的Webhook複製的​ Webhook URL,然後按一下​ 儲存已設定的事件

    Adobe Developer Console專案Webhook

  • 在Glitch Webook頁面中,您應該會看到GET請求,這是Adobe I/O事件傳送以驗證webhook URL的挑戰請求。

    問題 — 挑戰要求

觸發AEM事件

若要從已在上述AEM as a Cloud Service專案中註冊的Adobe Developer Console環境觸發AEM事件,請遵循下列步驟:

  • 透過Cloud Manager存取並登入您的AEM as a Cloud Service作者環境。

  • 根據您的​ 訂閱事件,建立、更新、刪除、發佈或取消發佈內容片段。

檢閱事件詳細資料

完成上述步驟後,您應該會看到AEM活動已傳送至webhook。 在Glitch webhook頁面中尋找POST請求。

問題 — POST要求

以下是POST請求的主要詳細資料:

  • 路徑: /webhook/${YOUR-WEBHOOK-URL},例如/webhook/AdobeTM-aem-eventing

  • 標頭:由Adobe I/O事件傳送的請求標頭,例如:

{
"connection": "close",
"x-forwarded-for": "34.205.178.127,::ffff:10.10.10.136,::ffff:10.10.84.114",
"x-forwarded-proto": "https,http,http",
"x-forwarded-port": "443,80,80",
"host": "lovely-ancient-coaster.glitch.me",
"content-length": "826",
"x-adobe-public-key2-path": "/prod/keys/pub-key-IkpzhSpTw0.pem",
"x-adobe-delivery-id": "18abfb47-d24a-4684-ade8-f442a3444033",
"x-adobe-provider": "aemsites_7ABB3E6A5A7491460A495D61@AdobeOrg_acct-aem-p46652-e1074060@adobe.com",
"x-adobe-public-key1-path": "/prod/keys/pub-key-Ptc2pD9vT9.pem",
"x-adobe-event-id": "a0f3fb7d-b02c-4612-aac6-e472b80af793",
"x-adobe-event-code": "aem.sites.contentFragment.modified",
"user-agent": "Adobe/1.0",
"x-adobe-digital-signature-2": "zGLso15+6PV6X6763/x6WqgxDlEXpkv5ty8q4njaq3aUngAI9VCcYonbScEjljRluzjZ05uMJmRfNxwjj60syxEJPuc0dpmMU635gfna7I4T7IaHs496wx4m2E5mvCM+aKbNQ+NPOutyTqI8Ovq29P2P87GIgMlGhAtOaxRVGNc6ksBxc2tCWbrKUhW8hPJ0sHphU499dN4TT32xrZaiRw4akT3M/hYydsA8dcWpJ7S4dpuDS21YyDHAB8s9Dawtr3fyPEyLgZzpwZDfCqQ8gdSCGqKscE4pScwqPkKOYCHDnBvDZVe583jhcZbHGjk7Ncp/FrgQk7avWsk5XlzcuA==",
"x-adobe-digital-signature-1": "QD7THFJ1vmJqD/BatIpzO6+ACQ9cSKPR7XVaW0LI7cN/xs7ucyri6dmkerOPe9EJpjGoqCg8rxWedrIRQB3lgVskChbHH3Ujx5YG0aTQLSd1Lsn5CFbW1U0l0GqId9Cnd6MccrqSznZXcdW1rMFuRk8+gqwabBifSaLbu3r30G5hmqQd72VtiYTE4m23O3jYIMiv62pRP+a+p4NjNj1XG320uRSry+BPniTjDJ6oN/Ng7aUEKML8idZ/ZTqeh/rJSrVO95UryUolFDRwDkRn5zKonbvhSLAeXzaPhvimWUHtldq9M1WTyRMpsBk8BRzaklxlq+woJ2UjYPUIEzjotw==",
"accept-encoding": "deflate,compress,identity",
"content-type": "application/cloudevents+json; charset=UTF-8",
"x-forwarded-host": "lovely-ancient-coaster.glitch.me",
"traceparent": "00-c27558588d994f169186ca6a3c6607d4-a7e7ee36625488d4-01"
}
  • body/payload:Adobe I/O事件傳送的要求內文,例如:
{
  "specversion": "1.0",
  "type": "aem.sites.contentFragment.modified",
  "source": "acct:aem-p46652-e1074060@adobe.com",
  "id": "bf922a49-9db4-4377-baf4-70e96e15c45f",
  "time": "2023-12-12T20:36:43.583228Z",
  "dataschema": "https://ns.adobe.com/xdm/aem/sites/events/content-fragment-modified.json",
  "datacontenttype": "application/json",
  "data": {
    "user": {
      "imsUserId": "933E1F8A631CAA0F0A495E53@80761f6e631c0c7d495fb3.e",
      "principalId": "xxx@adobe.com",
      "displayName": "First LastName",
    },
    "path": "/content/dam/wknd-shared/en/adventures/beervana-portland/beervana-in-portland",
    "model": {
      "id": "/conf/wknd-shared/settings/dam/cfm/models/adventure"
    },
    "id": "9a2d3e6a-efda-4079-a86e-0ef2ede692da",
    "properties": [
      {
        "name": "groupSize",
        "changeType": "modified"
      }
    ]
  },
  "event_id": "a0f3fb7d-b02c-4612-aac6-e472b80af793",
  "recipient_client_id": "f51ea733ba404db299fefbf285dc1c42"
}

您可以看到AEM事件詳細資料具有在webhook中處理事件所需的所有必要資訊。 例如,事件型別(type)、事件來源(source)、事件識別碼(event_id)、事件時間(time)和事件資料(data)。

其他資源

recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69