Erstellen von Webhook-Integrationen für Automation

Um während einer Automatisierung Nachrichten über Webhooks zu senden, erstellen Sie eine Integration. Integrationen können während einer Automatisierung mithilfe der neuen Aktion aws:invokeWebhook in Ihrem Runbook aufgerufen werden. Wenn Sie noch keinen Webhook erstellt haben, finden Sie weitere Informationen unter Erstellen von Webhooks für Integrationen. Weitere Informationen über die Aktion aws:invokeWebhook finden Sie unter aws:invokeWebhook – Automation-Webhook-Integration aufrufen.

Wie in den folgenden Verfahren gezeigt, können Sie Integrationen über die Automation-Konsole von Systems Manager oder mit Ihrem bevorzugten Befehlszeilen-Tool erstellen.

Erstellen von Integrationen (Konsole)

So erstellen Sie eine Integration für Automation (Konsole)

1. Öffnen Sie die AWS Systems Manager-Konsole unter https://console.aws.amazon.com/systems-manager/.

2. Klicken Sie im Navigationsbereich auf Automation.

3. Wählen Sie die Registerkarte Integrations (Integrationen) aus.

4. Wählen Sie Add integration (Integration hinzufügen) und dann Webhook aus.

5. Geben Sie die erforderlichen Werte und optionale Werte ein, die Sie für die Integration einbeziehen möchten.

6. Wählen Sie Add (Hinzufügen) aus, um die Integration zu erstellen.

Erstellen von Integrationen (Befehlszeile)

Um eine Integration mit Befehlszeilen-Tools zu erstellen, muss der erforderliche SecureString-Parameter für eine Integration erstellt werden. Automation nutzt einen reservierten Namespace im Parameter Store, einer Funktion von Systems Manager, um Informationen über Ihre Integration zu speichern. Wenn Sie eine Integration über die AWS Management Console erstellen, übernimmt Automation diesen Vorgang für Sie. Nach dem Namespace geben Sie den Typ der zu erstellenden Integration und dann deren Namen an. Derzeit unterstützt Automation Integrationen vom Typ webhook.

Folgende Felder werden für Integrationen vom Typ webhook unterstützt:

• Beschreibung

• Header

• Nutzlast

• URL

Bevor Sie beginnen

Falls noch nicht erfolgt, installieren und konfigurieren Sie die AWS Command Line Interface (AWS CLI) oder AWS Tools for PowerShell. Weitere Informationen finden Sie unter Installieren oder Aktualisieren der neuesten Version der AWS CLI und Installieren des AWS Tools for PowerShell.

So erstellen Sie eine Integration für Automation (Befehlszeile)

• Führen Sie die folgenden Befehle aus, um den erforderlichen SecureString-Parameter für eine Integration zu erstellen. Ersetzen Sie jeden Beispiel Platzhalter für Ressourcen mit Ihren eigenen Informationen. Der Namespace /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/ ist im Parameter Store für Integrationen reserviert. Im Namen des Parameters muss dieser Namespace verwendet werden, gefolgt vom Namen der Integration. Zum Beispiel /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"}'

Erstellen von Webhooks für Integrationen

Beachten Sie beim Erstellen von Webhooks bei Ihrem Anbieter Folgendes:

• Das Protokoll muss HTTPS lauten.

• Benutzerdefinierte Anforderungs-Header werden unterstützt.

• Ein Standardanforderungstext kann angegeben werden.

• Der Standardanforderungstext kann überschrieben werden, wenn eine Integration mit der Aktion aws:invokeWebhook aufgerufen wird.