

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à.

# Notifiche di eventi segreti
<a name="secret-event-notifications"></a>

Secrets Manager pubblica eventi su Amazon EventBridge quando le etichette di staging cambiano sui tuoi segreti. Puoi creare EventBridge regole che corrispondano a questi eventi e indirizzarle verso obiettivi per creare flussi di lavoro basati sugli eventi.

## Come EventBridge indirizza gli eventi di Secrets Manager
<a name="eventbridge-routes-secretsmanager-events"></a>

Di seguito viene descritto come EventBridge funziona con gli eventi di Secrets Manager.

Come molti AWS servizi, Secrets Manager genera e invia eventi al *bus eventi EventBridge * predefinito. Un bus di eventi è un router che riceve gli eventi e li indirizza verso le destinazioni, o *destinazioni*, specificate dall'utente. Gli obiettivi possono includere altri AWS servizi, applicazioni personalizzate e applicazioni partner SaaS. 

EventBridge indirizza gli eventi in base alle *regole* create sull'event bus. Per ogni regola, specificate un filtro, o *modello di eventi*, per selezionare solo gli eventi desiderati. Ogni volta che un evento viene inviato al bus degli eventi, lo EventBridge confronta con ogni regola. Se l'evento corrisponde alla regola, EventBridge indirizza l'evento verso gli obiettivi specificati.

Il diagramma seguente mostra come EventBridge indirizza gli eventi di Secrets Manager dal bus eventi predefinito alle destinazioni specificate.

![AWS i servizi inviano gli eventi al bus eventi EventBridge predefinito. Se l'evento corrisponde allo schema di eventi di una regola, EventBridge indirizza l'evento ai target specificati per quella regola.](http://docs.aws.amazon.com/it_it/secretsmanager/latest/userguide/images/eventbridge-integration-how-it-works.png)


Per ulteriori informazioni, consulta [Creazione di regole](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) nella *Guida EventBridge per l'utente*.

## Eventi di Secrets Manager
<a name="supported-events-secretsmanager"></a>

Secrets Manager pubblica un `Secret Label Updated` evento nel bus eventi predefinito EventBridge ogni volta che un'etichetta di staging cambia, ad eccezione `AWSPENDING` di e. `AWSPREVIOUS` Ciò include etichette personalizzate. Gli eventi sono abilitati per impostazione predefinita per tutti i segreti. Per utilizzare questi eventi, è necessario creare EventBridge regole corrispondenti e indirizzarli a un obiettivo. Per l'elenco completo dei servizi che puoi utilizzare come destinazioni, consulta la sezione [EventBridge Target](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html) nella *Guida per l'EventBridge utente*.

Secrets Manager non pubblica eventi per le modifiche ai metadati come tag, descrizione, configurazione di rotazione o aggiornamenti delle politiche delle risorse.


| Tipo di dettaglio dell'evento | Description | 
| --- | --- | 
| [Etichetta segreta aggiornata](event-detail-secret-label-updated-secretsmanager.md) | Secrets Manager ha spostato un'etichetta di allestimento a una nuova versione di Secret. | 

### Struttura degli eventi
<a name="eventbridge-event-structure-secretsmanager"></a>

Tutti gli eventi dei AWS servizi contengono due tipi di dati:
+ Un insieme comune di campi contenenti metadati sull'evento, ad esempio il AWS servizio che è l'origine dell'evento, l'ora in cui l'evento è stato generato, l'account e la regione in cui si è verificato l'evento e altri. Per le definizioni di questi campi generali, consulta la [struttura degli eventi](https://docs.aws.amazon.com/eventbridge/latest/ref/overview-event-structure.html) in *Amazon EventBridge Events Reference*. 
+ Un `detail` campo che contiene dati specifici per quel particolare evento di servizio. 

## Creazione di modelli di eventi che corrispondono agli eventi di Secrets Manager
<a name="eventbridge-event-delivery-filter-secretsmanager"></a>

I pattern di eventi sono filtri in cui si specifica quali dati devono contenere gli eventi che si desidera selezionare.

Ogni modello di eventi è un oggetto in formato JSON che contiene:
+ Un attributo `source` che identifica il servizio che invia l'evento. Per gli eventi di Secrets Manager, la fonte è`aws.secretsmanager`.
+ (Facoltativo): Un `detail-type` attributo che contiene una matrice dei nomi degli eventi da abbinare.
+ (Facoltativo): Un attributo `detail` contenente qualsiasi altro dato relativo all’evento da abbinare.

Il seguente schema di eventi corrisponde agli eventi quando l'`AWSCURRENT`etichetta passa a una nuova versione, il che indica che il valore segreto attivo è cambiato:

```
{
  "source": ["aws.secretsmanager"],
  "detail-type": ["Secret Label Updated"],
  "detail": {
    "labelUpdated": ["AWSCURRENT"]
  }
}
```

Il seguente schema di eventi corrisponde alle modifiche delle etichette solo per i segreti i cui nomi iniziano con`MyTestSecret`:

```
{
  "source": ["aws.secretsmanager"],
  "detail-type": ["Secret Label Updated"],
  "detail": {
    "name": [{"prefix": "MyTestSecret"}]
  }
}
```

Il seguente modello di eventi combina i filtri in modo che corrispondano solo in caso di `AWSCURRENT` modifiche ai segreti con nomi che iniziano con`prod/`:

```
{
  "source": ["aws.secretsmanager"],
  "detail-type": ["Secret Label Updated"],
  "detail": {
    "name": [{"prefix": "prod/"}],
    "labelUpdated": ["AWSCURRENT"]
  }
}
```

Se utilizzi etichette temporanee personalizzate nei tuoi flussi di lavoro, puoi abbinare gli eventi per tali etichette. L'esempio seguente corrisponde a quando viene spostata un'etichetta `MyLabel` denominata:

```
{
  "source": ["aws.secretsmanager"],
  "detail-type": ["Secret Label Updated"],
  "detail": {
    "labelUpdated": ["MyLabel"]
  }
}
```

Per ulteriori informazioni sulla scrittura di modelli di eventi, consultate [Event pattern](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) nella *Guida EventBridge per l'utente*.

La creazione del pattern di eventi è una fase del processo più ampio di creazione della regola. Per ulteriori informazioni, consulta [Creazione di regole](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) nella *Guida EventBridge per l'utente*.