Crear integraciones webhook para Automation

Para enviar mensajes mediante manuales de procedimientos durante una automatización, cree una integración. Las integraciones se pueden invocar durante una automatización mediante la acción aws:invokeWebhook en su manual de procedimientos. Si aún no ha creado un manual de procedimientos, consulte Creación de webhooks para integraciones. Para obtener más información acerca de la acción aws:invokeWebhook, consulte aws:invokeWebhook: invocar una integración de webhook de Automation.

Como se muestra en los siguientes procedimientos, puede crear una integración mediante la consola de Automatización de Systems Manager o su herramienta de la línea de comandos preferida.

Creación de integraciones (consola)

Para crear una integración para Automation (consola)

1. Abra la consola de AWS Systems Manager en https://console.aws.amazon.com/systems-manager/.

2. En el panel de navegación, elija Automation.

3. Elija la pestaña Integrations (Integraciones).

4. Seleccione Add integration (Agregar integración) y elija Webhook.

5. Ingrese los valores obligatorios y los valores opcionales que desee incluir para la integración.

6. Elija Add (Agregar) para crear la integración.

Creación de integraciones (línea de comandos)

Para crear una integración mediante herramientas de la línea de comandos, debe crear el parámetro SecureString obligatorio para una integración. Automation utiliza un espacio de nombres reservado en Parameter Store, una capacidad de Systems Manager, para almacenar información sobre su integración. Si crea una integración mediante la AWS Management Console, Automation se encarga de este proceso por usted. Después del espacio de nombres, debe especificar el tipo de integración que desea crear y, a continuación, el nombre de la integración. Actualmente, Automation admite la integración de tipos webhook.

Los campos admitidos para las integraciones de tipo webhook son las siguientes:

• Descripción

• headers

• payload

• URL

Antes de empezar

Si aún no lo ha hecho, instale y configure la AWS Command Line Interface (AWS CLI) o las AWS Tools for PowerShell. Para obtener información, consulte Instalación o actualización de la última versión de la AWS CLI e Instalación de AWS Tools for PowerShell.

Para crear una integración para Automation (línea de comandos)

• Ejecute los siguientes comandos para crear el parámetro SecureString para una integración. Reemplace cada example resource placeholder por su propia información. El espacio de nombres /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/ está reservado en Parameter Store para las integraciones. El nombre del parámetro debe utilizar este espacio de nombres seguido del nombre de la integración. Por ejemplo /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/myWebhookIntegration.

  Linux & macOS

  aws ssm put-parameter \
      --name "/d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/myWebhookIntegration" \
      --type "SecureString" \
      --data-type "aws:ssm:integration" \
      --value '{"description": "My first webhook integration for Automation.", "url": "myWebHookURL"}'

  Windows

  aws ssm put-parameter ^
      --name "/d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/myWebhookIntegration" ^
      --type "SecureString" ^
      --data-type "aws:ssm:integration" ^
      --value  "{\"description\":\"My first webhook integration for Automation.\",\"url\":\"myWebHookURL\"}"

  PowerShell

  Write-SSMParameter `
      -Name "/d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/myWebhookIntegration" `
      -Type "SecureString"
      -DataType "aws:ssm:integration"
      -Value '{"description": "My first webhook integration for Automation.", "url": "myWebHookURL"}'

Creación de webhooks para integraciones

Al crear webhooks con su proveedor, tenga en cuenta lo siguiente:

• El protocolo debe ser HTTPS.

• Se admiten encabezados de solicitud personalizados.

• Se puede especificar un cuerpo de la solicitud predeterminado.

• El cuerpo de la solicitud predeterminado se puede anular cuando se invoca una integración mediante la acción aws:invokeWebhook.