AEM Webhooks y eventos de
AEM Obtenga información sobre cómo recibir eventos de en un webhook y revisar los detalles del evento, como carga útil, encabezados y metadatos.
En este ejemplo, el uso de un gancho web hospedado proporcionado por el Adobe AEM le permite recibir eventos de sin necesidad de configurar su propio gancho web. Este webhook proporcionado por el Adobe está hospedado en Glitch, una plataforma conocida por ofrecer un entorno basado en la web propicio para generar e implementar aplicaciones web. Sin embargo, la opción de usar su propio webhook también está disponible si se prefiere.
Requisitos previos
Para completar este tutorial, necesita lo siguiente:
-
Entorno de AEM as a Cloud Service AEM con ventilación de eventos habilitada.
-
Proyecto de Adobe Developer Console AEM configurado para eventos de.
Acceso al webhook
Para acceder al webhook proporcionado por el Adobe, siga estos pasos:
-
Verifique que puede acceder al Glitch - webhook alojado en una nueva pestaña del navegador.
-
Escribe un nombre único para tu webhook, por ejemplo
<YOUR_PETS_NAME>-aem-eventingy haz clic en Conectar. Debería verConnected to: ${YOUR-WEBHOOK-URL}mensaje en la pantalla.
-
Tome nota de la URL de webhook. Lo necesita más adelante en este tutorial.
Configuración del webhook en un proyecto de Adobe Developer Console
AEM Para recibir eventos de en la URL del gancho web anterior, siga estos pasos:
-
En Adobe Developer Console, navegue hasta el proyecto y haga clic para abrirlo.
-
AEM En la sección Productos y servicios, haga clic en los puntos suspensivos
...junto a la tarjeta de eventos que desee que envíe eventos de la al gancho web y seleccione Editar.
-
En el diálogo Configurar el registro de eventos que acaba de abrir, haga clic en Siguiente para continuar con el paso Cómo recibir eventos.
-
En el paso Cómo recibir eventos, selecciona la opción Webhook, pega la URL de Webhook que copiaste anteriormente del webhook alojado en Glitch y haz clic en Guardar eventos configurados.
-
En la página de Glitch, debería ver una solicitud de GET, es una solicitud de desafío enviada por los Eventos de Adobe I/O para comprobar la URL del webhook.
Déclencheur AEM de eventos de
Para obtener un déclencheur AEM de eventos de la desde el entorno de AEM as a Cloud Service que se ha registrado en el proyecto de Adobe Developer Console anterior, siga estos pasos:
-
Acceda a su entorno de creación de AEM as a Cloud Service e inicie sesión a través de Cloud Manager.
-
Según sus Eventos suscritos, cree, actualice, elimine, publique o cancele la publicación de un fragmento de contenido.
Revisar detalles del evento
AEM Después de completar los pasos anteriores, debería ver los eventos de la que se entregan al webhook. Busque la solicitud del POST en la página de gancho web de Glitch.
Estos son los detalles clave de la solicitud del POST:
-
ruta:
/webhook/${YOUR-WEBHOOK-URL}, por ejemplo/webhook/AdobeTM-aem-eventing -
encabezados: encabezados de solicitud enviados por los eventos de Adobe I/O, por ejemplo:
{
"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"
}
- cuerpo/carga útil: cuerpo de la solicitud enviado por los eventos del Adobe I/O, por ejemplo:
{
"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 Puede ver que los detalles del evento de la tienen toda la información necesaria para procesar el evento en el webhook. Por ejemplo, el tipo de evento (type), el origen de evento (source), el identificador de evento (event_id), la hora del evento (time) y los datos de evento (data).
Recursos adicionales
- [El código fuente del gancho web Glitch](https://glitch.com/edit/#!/precioso-antiguo-montaña rusa) está disponible para consulta.