Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Creazione di integrazioni webhook per Automazione
<a name="creating-webhook-integrations"></a>

Creare un'integrazione ti permette di inviare messaggi utilizzando webhook durante un'automazione. Le integrazioni possono essere richiamate durante un'automazione utilizzando l'operazione `aws:invokeWebhook` nel tuo runbook. Se non hai ancora creato un webhook, consulta [Creazione di webhook per integrazioni](#creating-webhooks). Per ulteriori informazioni sulle operazioni di `aws:invokeWebhook`, consulta [`aws:invokeWebhook`: richiamo dell'integrazione di un webhook di Automation](invoke-webhook.md).

Come illustrato nelle procedure seguenti, puoi creare un'integrazione utilizzando la console di Systems Manager Automation o lo strumento a riga di comando desiderato. 

## Creazione di integrazioni (console)
<a name="creating-integrations-console"></a>

**Creazione di un'integrazione per Automazione (console)**

1. Apri la AWS Systems Manager console all'indirizzo [ https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Nel pannello di navigazione, scegli **Automazione**.

1. Seleziona la scheda **Integrazioni**.

1. Seleziona **Aggiungi integrazione** e scegli **Webhook**.

1. Inserisci i valori obbligatori e tutti i valori facoltativi che desideri includere per l'integrazione.

1. Scegli **Aggiungi** per creare l'integrazione.

## Creazione di integrazioni (riga di comando)
<a name="creating-integrations-commandline"></a>

Per creare un'integrazione utilizzando gli strumenti a riga di comando, devi creare il parametro `SecureString` obbligatorio per un'integrazione. L'automazione utilizza uno spazio dei nomi riservato Parameter Store per archiviare le informazioni sull'integrazione. Se crei un'integrazione utilizzando il Console di gestione AWS, Automation gestisce questo processo per te. Dopo namespace, devi specificare il tipo di integrazione che desideri creare e quindi il nome dell'integrazione. Attualmente, Automation supporta integrazioni di tipo `webhook`.

I campi supportati per le integrazioni di tipo `webhook` sono i seguenti:
+ Description
+ headers
+ payload
+ URL

**Prima di iniziare**  
Se non l'hai già fatto, installa e configura AWS Command Line Interface (AWS CLI) o AWS Strumenti per PowerShell. Per informazioni, consulta le pagine [Installazione o aggiornamento della versione più recente di AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) e [Installazione di AWS Strumenti per PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html).

**Per creare un'integrazione per Automazione (riga di comando)**
+ Esegui i comandi seguenti per creare il parametro `SecureString` obbligatorio per un'integrazione. Sostituisci ogni {{example resource placeholder}} con le tue informazioni. Il namespace di `/d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/` è riservato in Parameter Store per le integrazioni. Il nome del tuo paramento deve utilizzare questo namespace seguito dal nome dell'integrazione. Ad esempio, `/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}}"}'
  ```

------

## Creazione di webhook per integrazioni
<a name="creating-webhooks"></a>

Quando crei webhook con il provider, nota quanto segue:
+ Il protocollo deve essere HTTPS.
+ Sono supportate le intestazioni delle richieste personalizzate.
+ È possibile specificare un corpo della richiesta predefinito.
+ Il corpo della richiesta predefinito può essere ignorato quando viene richiamata un'integrazione utilizzando l'operazione `aws:invokeWebhook`.