Inviare a Google il feed Avvisi

Questa sezione fornisce istruzioni per l'invio di avvisi a Google a scopo di test. Si tratta di una procedura iterativa. In questo passaggio dell'implementazione non verrà pubblicato alcun avviso.

Proteggi i tuoi dati

Per garantire l'autenticità delle informazioni critiche relative agli avvisi, mantenere la credibilità del nostro sistema e fornire i dati giusti al pubblico, ti chiediamo di proteggere i tuoi dati. Il progetto di sicurezza e il piano di manutenzione devono essere in vigore prima di inviare qualsiasi dato.

Puoi utilizzare HTTP purché utilizzi le firme digitali per firmare gli avvisi oppure puoi utilizzare HTTPS, nel qual caso non è necessario firmare gli avvisi.

Preferiamo che utilizzi HTTPS.

HTTPS con Transport Layer Security (TLS)

HTTPS evita la necessità di scambiare nuovi certificati digitali alla scadenza di quelli precedenti.

Devi ottenere un certificato SSL emesso da un'autorità di certificazione attendibile di Google Chrome. Consulta queste autorità di esempio.

È consigliabile utilizzare HTTP/TLS ("https://...") sul canale SSL tradizionale.

HTTP con firme digitali

Se utilizzi HTTP con firme digitali, puoi generare la chiave per firmare autonomamente. Google Public Alert richiede:

  • fornisci la tua chiave pubblica e i relativi aggiornamenti almeno 30 giorni prima della scadenza della chiave precedente. In questo modo si eviteranno interruzioni impreviste agli aggiornamenti dei dati.
  • scadono e creare una nuova chiave almeno ogni due anni.
  • Firma gli avvisi con la tua firma seguendo questi consigli sulla sicurezza CAP.

Configurare il feed

Per ospitare e recapitare i tuoi messaggi CAP, forniscili in un feed accessibile pubblicamente, come uno dei seguenti:

Consulta le pratiche di esempio CAP: feed CAP per indicazioni sulla pubblicazione di avvisi CAP in un feed. Per istruzioni su come configurare i feed Atom o RSS per gli avvisi CAP, consulta le pratiche di esempio CAP: feed CAP. Includi nel tuo feed web un link all'avviso CAP completo come mostrato qui.

Convalidare il feed

Utilizza il nostro Strumento di convalida CAP per convalidare il feed.

Aggiornamento di avvisi e feed

Quando un avviso cambia, emetti un nuovo avviso che faccia riferimento all'avviso precedente, anziché modificare o rimuovere l'avviso esistente dal feed. Dopo un determinato periodo di tempo (ad es. 24-48 ore), rimuovi gli avvisi annullati, aggiornati o scaduti dal tuo feed.

L'opzione <msgType> AGGIORNA o ANNULLA deve includere almeno un elemento <references>. Come specificato nello standard CAP, i messaggi di avviso che aggiornano un avviso precedente devono utilizzare <msgType>Update</msgType> e impostare <references>code</references> su tutti i messaggi correlati precedenti che non hanno raggiunto la loro data di <expires>. L'opzione AGGIORNA o ANNULLA deve essere applicata a un avviso non scaduto.

Esistono tre modi per ANNULLARE eventi, in ordine di preferenza:

  1. Imposta una data e un'ora <expires> per ogni evento, con la descrizione del messaggio in cui si prevede che questo avviso terminerà da solo.
  2. Rilascia un nuovo <alert> con <msgType>UPDATE, <responseType>"All Clear" e <expires> in breve nel futuro.
  3. Rilascia un nuovo <alert> con <msgType>CANCEL.

Consulta la nostra pagina Esempi di avvisi per aggiornamenti e annullamenti.

Passaggio successivo: testa l'integrazione degli avvisi