Création d'intégrations webhook pour Automation

Pour envoyer des messages à l'aide de webhooks pendant une automatisation, créez une intégration. Les intégrations peuvent être appelées lors d'une automatisation à l'aide de l'action aws:invokeWebhook dans votre runbook. Si vous n'avez pas encore créé de webhook, consultez Créer des webhooks pour les intégrations. Pour en savoir plus sur l'action aws:invokeWebhook, consultez aws:invokeWebhook : appeler une intégration de webhook Automation.

Comme indiqué dans les procédures suivantes, vous pouvez créer une intégration à l'aide de la console Systems Manager Automation ou de l'outil de ligne de commande de votre choix.

Créer des intégrations (console)

Pour créer une intégration pour Automation (console)

1. Ouvrez la console AWS Systems Manager à l'adresse https://console.aws.amazon.com/systems-manager/.

2. Dans le panneau de navigation de gauche, sélectionnez Automation (Automatisation).

3. Sélectionnez l'onglet Integrations (Intégrations).

4. Sélectionnez Add integration (Ajouter une intégration), puis Webhook.

5. Saisissez les valeurs requises et les valeurs facultatives que vous souhaitez inclure pour l'intégration.

6. Sélectionnez Add (Ajouter) pour créer l'intégration.

Créer des intégrations (ligne de commande)

Pour créer une intégration à l'aide des outils de ligne de commande, vous devez créer le paramètre SecureString requis pour une intégration. Automation utilise un espace de noms réservé dans Parameter Store, une fonctionnalité de Systems Manager, pour stocker des informations sur votre intégration. Si vous créez une intégration à l'aide de la AWS Management Console, Automation gère ce processus à votre place. Après l'espace de noms, vous devez spécifier le type d'intégration que vous souhaitez créer, puis le nom de votre intégration. Automation prend actuellement en charge les intégrations de type webhook.

Les champs pris en charge pour les intégrations de type webhook sont les suivants :

• Description

• headers

• payload

• URL

Avant de commencer

Si vous ne l'avez pas déjà fait, installez et configurez l'AWS Command Line Interface (AWS CLI) ou les AWS Tools for PowerShell. Pour plus d'informations, consultez la section Installation ou mise à jour de la version la plus récente de l'AWS CLI et Installation d'AWS Tools for PowerShell.

Pour créer une intégration pour Automation (ligne de commande)

• Exécutez les commandes suivantes pour créer le paramètre SecureString requis pour une intégration. Remplacez chaque example resource placeholder (espace réservé pour les ressources) avec vos propres informations. L'espace de noms /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/ est réservé dans Parameter Store pour les intégrations. Le nom de votre paramètre doit utiliser cet espace de noms suivi du nom de votre intégration. Par exemple /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"}'

Créer des webhooks pour les intégrations

Lorsque vous créez des webhooks avec votre fournisseur, prenez note des éléments suivants :

• Le protocole doit être HTTPS.

• Les en-têtes de demande personnalisés sont pris en charge.

• Un corps de requête par défaut peut être spécifié.

• Le corps de requête par défaut peut être remplacé lorsqu'une intégration est appelée à l'aide de l'action aws:invokeWebhook.