IBM Cloud Docs
Utilizzo della lista di distribuzione delle notifiche

Utilizzo della lista di distribuzione delle notifiche

La pagina dell'elenco di distribuzione delle notifiche IBM Cloud fornisce un modo per specificare una serie di indirizzi email o webhook per impostare destinazioni adatte per le notifiche sugli eventi a livello dell'account.

Puoi gestire l'elenco di distribuzione delle notifiche utilizzando la console IBM Cloud. È possibile creare un elenco di massimo 10 indirizzi e-mail che possono ricevere le notifiche. Le email che vengono aggiunte all'elenco di distribuzione vengono notificate in merito a qualsiasi evento che influisce sull'account. Devi avere il ruolo di editor o superiore sul servizio di gestione dell'account per aggiungere gli indirizzi email all'elenco di distribuzione. Per ulteriori informazioni, vedi Assegnazione dell'accesso ai servizi di gestione dell'account.

Gli indirizzi email aggiunti all'elenco di distribuzione dal proprietario dell'account ricevono notifiche su qualsiasi incidente, manutenzione, annuncio o bollettino di sicurezza visualizzato nella pagina Notifichedel proprietario dell'account.

Oltre ad aggiungere indirizzi e-mail, è possibile aggiungere fino a 10 webhook a una lista di distribuzione. Gli amministratori degli account possono creare e utilizzare i webhook per configurare un'applicazione in modo che riceva notifiche asincrone ogni volta che si verifica un evento della piattaforma. I webhook registrati inviano le informazioni al sito URL specificato sotto forma di una richiesta HTTP POST con un payload JSON. Il tipo di contenuto della richiesta è 'application/json.

Aggiunta di indirizzi email a un elenco di distribuzione delle notifiche nella console

Per aggiungere email a un elenco di distribuzione notifiche, completare la seguente procedura:

  1. Utilizzando la console IBM Cloud, vai a Gestisci > Account > Elenco di distribuzione notifiche.

  2. Selezionare Aggiungi > E-mail.

  3. Immettere un nome e un indirizzo email.

    Puoi aggiungere fino a 10 indirizzi e-mail all'elenco di distribuzione. Gli indirizzi email non devono corrispondere agli utenti noti in IBM Cloud, puoi aggiungere qualsiasi tipo.

  4. Fai clic su Aggiungi.

Annullamento sottoscrizione dall'elenco di distribuzione

Per annullare la sottoscrizione all'elenco di distribuzione, utilizzare il link nel piè di pagina di qualsiasi email inviata dall'elenco di distribuzione.

Abilitazione di Event Notifications per l'elenco di distribuzione delle notifiche

Con IBM Cloud® Event Notifications, puoi scegliere di consegnare le tue notifiche a diverse destinazioni, inclusi email, SMS o webhook. Event Notifications è un'alternativa all'elenco di distribuzione delle notifiche. Fornisce un modo per ricevere una notifica sugli eventi critici che si verificano nel proprio account e gestire le proprie notifiche in scala. Per ulteriori informazioni, vedi Introduzione a Event Notifications.

Quando si verifica un evento di interesse sulla piattaforma IBM Cloud e viene generato un evento, l'elenco di distribuzione delle notifiche comunica con un'istanza Event Notifications connessa per inoltrare una notifica alla destinazione supportata. Per ulteriori informazioni sulle destinazioni Event Notifications supportate, vedi Destinazioni evento.

Aggiunta di un'istanza Event Notifications all'elenco di distribuzione delle notifiche

Prima di aggiungere un'istanza di Event Notifications all'elenco di distribuzione delle notifiche, assicurarsi di avere già un'istanza del servizioEvent Notifications che si trovi nello stesso account dell'elenco di distribuzione. Se non si dispone di un'istanza del servizio Event Notifications, vedere Per iniziare con Event Notifications. Per aggiungere un'istanza di servizio esistente Event Notifications all'elenco di distribuzione delle notifiche, completare i passaggi seguenti:

  1. Utilizzando la console IBM Cloud, vai a Gestisci > Account > Elenco di distribuzione notifiche.
  2. Fai clic su Add > Event Notifications.
  3. Seleziona un'istanza del servizio Event Notifications dall'elenco di istanze Event Notifications. Se non hai un'istanza del servizio Event Notifications che puoi connettere al tuo account, puoi crearne uno nel catalogoIBM Cloud.
  4. Fai clic su Aggiungi.

Non puoi aggiungere un'istanza del servizio Event Notifications all'elenco di distribuzione notifiche già configurato.

Eliminazione di un'istanza di Event Notifications

Puoi eliminare qualsiasi istanza Event Notifications che hai aggiunto all'elenco di distribuzione delle notifiche completando la seguente procedura:

  1. Seleziona l'istanza del servizio Event Notifications che desideri eliminare dall'elenco di distribuzione delle notifiche e fai clic sull'icona Azioni Azioni.
  2. Fai clic su Delete.

Aggiunta di webhook a una lista di distribuzione

Per aggiungere webhook a una lista di distribuzione, completare i passaggi seguenti:

  1. Andare su Gestione > Account > Elenco di distribuzione delle notifiche nella console IBM Cloud®.

  2. Fare clic su Aggiungi e selezionare Aggiungi webhook.

  3. Inserire un nome identificativo per il webhook e un endpoint URL, dove vengono inviate le notifiche sugli eventi quando il webhook viene attivato. Impostare il sito URL che sarà l'endpoint personalizzato.

    È possibile impostare anche i campi intestazione personalizzata e intestazione sicura. È possibile specificarli facendo clic su Aggiungi intestazione o Aggiungi intestazione sicura. Se si sceglie di aggiungere un'intestazione sicura per le credenziali, queste vengono trasmesse crittografate insieme ai dati privati. Questo tipo di intestazione può essere cancellato, ma non può essere modificato in seguito. È possibile modificare ed eliminare facilmente le intestazioni personalizzate in un secondo momento.

    Se non si desidera più ricevere notifiche, è possibile eliminare facilmente il webhook dall'elenco di distribuzione facendo clic sull'icona Azioni Icona > Elimina nella riga del webhook.

    È possibile selezionare l'account IBM Cloud da utilizzare facendo clic sul selettore di account nella console. Gli utenti dell'account selezionato ricevono notifiche su tutti gli eventi che riguardano l'account.

Quando si riceve una notifica tramite un webhook, un payload viene inviato all'endpoint webhook indicato ( URL ) e informa l'utente su tutti i dettagli di un evento che si sta verificando. Vedi il seguente esempio:

{
  "account_id": "2dd2d2de4add4a098ebd0999be5cc555",
  "body": [
    {
      "language": "en",
      "text": "<p><br />SERVICES/COMPONENTS AFFECTED:<br />- Cloudant NoSQL DB<br />- Code Engine<br />- DNS Services<br />- App ID<br />- IBM Watson Machine Learning<br />- Continuous Delivery - Toolchain<br />- MQ in IBM Cloud<br />- Hyper Protect Crypto Services<br /><br />IMPACT:<br />- Users may experience connectivity issues when trying to connect to Cloudant services.<br /><br />STATUS:<br />- 2021-05-25 14:54 UTC - INVESTIGATING - We are aware of the issue and are currently investigating. More information will be provided as it becomes available.</p>"
    }
  ],
  "category": "Incident",
  "componentNames": "Cloudant",
  "continentNames": [
    "North America",
    "Europe",
    "Asia Pacific"
  ],
  "regionNames": [
    "Washington DC",
    "London",
    "Dallas",
    "Sydney",
    "Tokyo",
    "Frankfurt"
  ],
  "regions": [
    "us-east",
    "eu-gb",
    "us-south",
    "au-syd",
    "jp-tok",
    "eu-de"
  ],
  "severity": "Severity 1",
  "sourceID": "INC3918600",
  "startTime": 1621949594,
  "state": "Investigating",
  "title": [
    {
      "language": "en",
      "text": "INVESTIGATING: IBM Cloudant - selective services  are unavailable"
    }
  ],
  "updateTime": 1621954682
}

Intestazioni

Il payload viene ricevuto con un'intestazione configurata nell'interfaccia utente quando si aggiunge un webhook e con un'intestazione aggiuntiva di versione che contiene un numero di versione semantico. Questa intestazione di versione può essere usata per determinare il formato previsto del payload del webhook.

L'intestazione della versione corrente è '"IBM-Notifications-API-Version": "v2.0.0".

Valori del campo

Le seguenti descrizioni forniscono informazioni sui valori dei campi inviati all'interno del payload:

body: questo campo descrive l'evento che si sta verificando sulla piattaforma e che vi riguarda. Questo campo contiene una descrizione dettagliata e leggibile della notifica e può essere lungo diversi paragrafi. Può anche contenere formattazione html. Questo campo è configurato per supportare più lingue, anche se attualmente è supportato solo l'inglese.

category: Il tipo di evento. Può trattarsi di incidenti, manutenzione, annunci o bollettini di sicurezza.

componentNames: se un servizio è impattato, questo campo lo rappresenta. Può anche essere un valore globale come " Component: IBM Cloud, non solo un servizio specifico. Vedere i servizi nella pagina del catalogoIBM Cloud.

regions: Questo campo indica la località dell'evento.

severity: questo campo si riferisce alla gravità dell'evento. La gravità può essere 1, 2, 3 o 4 per gli incidenti, alta, media o bassa per la manutenzione e maggiore o minore per gli annunci. Vedere le seguenti descrizioni dettagliate dei livelli di gravità:

  • Incidenti
    • Severity 1: la funzionalità critica per l'azienda è inutilizzabile o l'interferenza critica è fallita. Questa severità di solito si applica all'ambiente di produzione e l'impossibilità di accedere ai servizi sta causando un impatto critico sulle operazioni.
    • Severity 2: La funzionalità principale è compromessa. Il servizio è operativo ma provoca un impatto notevole sull'utilizzo.
    • Severity 3: Interruzione parziale o non critica della funzionalità con impatto minimo o isolato.
    • Severity 4: Un problema minore che richiede un intervento, ma che non influisce sulla funzionalità o sull'utilizzo.
  • Manutenzione
    • High impact: La manutenzione causerà, o è probabile che causerà, interruzioni del servizio e disservizi.
    • Medium impact: La manutenzione causerà, o è probabile che causerà, un degrado misurabile del servizio, ma non un'effettiva interruzione.
    • Low impact: La manutenzione non causerà alcuna interruzione del servizio durante o dopo la finestra di manutenzione.
  • Annunci
    • Major: Episodi importanti come avvisi legali, deprezzamento di servizi o patch di sicurezza.
    • Minor: Annunci informativi come miglioramenti dei prodotti.

state: questo campo serve solo per la manutenzione e le notifiche. Vedere i seguenti valori possibili:

  • Valori per gli stati di manutenzione: Pianificato, In corso, Completato, Annullato, Fallito
  • Valori per gli stati degli incidenti: Nuovo problema, Indagine, Risolto

title: Il campo del titolo indica l'oggetto della notifica. Questo campo è configurato per supportare più lingue, anche se attualmente è supportato solo l'inglese.

startTime, 'endTime: è possibile controllare quando l'evento inizia e quando finisce.

I campi " startTime e " endTime indicano l'ora di inizio e di fine dell'evento in tempo universale coordinato Unix.

I campi inviati nel payload possono essere obbligatori o facoltativi. I campi opzionali, ad esempio " startTime, vengono passati se la notifica ha questo tipo di informazioni e non vengono passati se la notifica non le ha. I campi obbligatori, ad esempio " category, vengono passati in ogni caso. La tabella seguente elenca i campi obbligatori e quelli facoltativi:

Campi di un carico utile
Campo Richiesto o facoltativo
ID conto: ID conto Richiesta
** categoria**: notification.category
** titolo**: notification.title
** startTime**: notification.startTime
** endTime**: notification.endTime
** updateTime**: notification.updateTime
** body**: notification.body
Stato: notification.state
SourceID: notification.sourceID Optional
** regioni**: notification.regions
Nomi dei continenti: notification.continentNames Optional
Nomi delle regioni: notification.regionNames Optional
** nomi** componenti: notification.componentNames
Sottocategoria: notification.subCategory Optional
Severity: notification.severity

In futuro potrebbero essere aggiunti altri campi senza una modifica sostanziale della versione. Ciò significa che il codice che elabora le notifiche deve essere pronto a ignorare i campi che non riconosce.

Invio di notifiche di test a un webhook

Se si è pronti con i passaggi precedenti e si dispone di un webhook configurato, è possibile testarlo facilmente. Inviare una notifica di prova al webhook e verificare che l'integrazione del webhook funzioni correttamente e riceva la notifica.

Completare i seguenti passaggi per inviare una notifica di prova a un webhook:

  1. Andare su Gestione > Account > Elenco di distribuzione delle notifiche nella console IBM Cloud.
  2. Selezionare il webhook a cui si desidera inviare una notifica di prova e fare clic sull'icona Azioni Azioni.
  3. Fare clic su Test > Invia test.
  4. Per inviare nuovamente la notifica del test, fare clic su Invia nuovamente il test.

Aggiunta di webhook Slack a una lista di distribuzione

È possibile aggiungere i webhook di Slack alla propria lista di distribuzione e ricevere le notifiche dell'intero account IBM Cloud attraverso di essi.

Per creare un webhook, prima di tutto bisogna impostare un'app in Slack e creare il webhook in entrata, che fornisce l'indirizzo URL unico a cui inviare il testo del messaggio di notifica sotto forma di payload JSON. Riceverete le notifiche nel canale Slack selezionato in cui avete installato l'applicazione. Per ulteriori informazioni, vedere Invio di messaggi tramite Webhook in entrata.

Per aggiungere un webhook Slack nella console IBM Cloud, completare i seguenti passaggi:

  1. Andare su Gestione > Account > Elenco di distribuzione delle notifiche nella console IBM Cloud.
  2. Fate clic su Aggiungi e selezionate Slack.
  3. Inserite un nome per il webhook e un webhook Slack URL. Le notifiche vengono inviate a questo unico URL.

Aggiunta di webhook di Microsoft Teams a una lista di distribuzione

L'aggiunta di webhook di Microsoft Teams alla lista di distribuzione è disponibile anche per ricevere notifiche a livello di account IBM Cloud.

Per creare un webhook nella console IBM Cloud, creare prima il webhook in entrata in Microsoft Teams. Questo permette alle app esterne di condividere contenuti nei canali Teams e fornisce l'unico URL dove è possibile inviare il testo del messaggio di notifica sotto forma di payload JSON. Si ricevono le notifiche nel canale Teams selezionato in cui è stato aggiunto il webhook in entrata. Per ulteriori informazioni, vedere Creazione di webhook in entrata.

Per aggiungere un webhook di Microsoft Teams nella console IBM Cloud, completare i seguenti passaggi:

  1. Andare su Gestione > Account > Elenco di distribuzione delle notifiche nella console IBM Cloud.
  2. Fare clic su Aggiungi e selezionare Microsoft Teams.
  3. Immettere un nome per il webhook e un webhook di Microsoft Teams URL. Le notifiche vengono inviate a questo unico URL.

Impostazione dei webhook di ServiceNow

A differenza delle integrazioni webhook di Microsoft Teams e Slack, l'impostazione di un webhook di ServiceNow richiede una configurazione da effettuare sul lato della destinazione del webhook.

Innanzitutto, è necessario creare un'API REST scriptata sul sito Web di ServiceNow. Dopo aver configurato l'API REST scriptata, è necessario creare una risorsa API REST scriptata. Il metodo di richiesta deve essere impostato su HTTP POST. Quindi, è necessario fornire un codice per l'esecuzione della risorsa.

Quando si è pronti con il processo e si dispone di URL per la propria API REST scriptata, si può iniziare a utilizzarla nella pagina dell'elenco di distribuzione delle notifiche di IBM Cloud e creare webhook.

Per conoscere il processo completo di integrazione dei webhook di ServiceNow, seguite le istruzioni contenute nel post del blog Come integrare i webhook in ServiceNow. Questo blog vi illustra i passaggi in dettaglio.