Mengirim feed Notifikasi Anda ke Google

Bagian ini berisi petunjuk untuk mengirimkan pemberitahuan ke Google untuk tujuan pengujian. Ini adalah proses yang berulang-ulang. Tidak ada pemberitahuan yang akan dipublikasikan di langkah penerapan ini.

Mengamankan data

Untuk memastikan keaslian informasi pemberitahuan penting Anda, menjaga kredibilitas sistem kami, dan menyampaikan data yang tepat kepada publik, kami mengharuskan Anda mengamankan data Anda. Desain pemeliharaan dan rencana pemeliharaan Anda harus diterapkan sebelum Anda mengirimkan data apa pun.

Anda dapat menggunakan HTTP asalkan Anda menggunakan tanda tangan digital untuk menandatangani notifikasi; atau Anda dapat menggunakan HTTPS, dalam hal ini Anda tidak perlu menandatangani notifikasi.

Sebaiknya Anda menggunakan HTTPS.

HTTPS dengan Transport Layer Security (TLS)

HTTPS menghindari kebutuhan untuk menukar sertifikat digital baru saat masa berlaku sertifikat sebelumnya berakhir.

Anda harus mendapatkan sertifikat SSL yang diterbitkan oleh otoritas sertifikat tepercaya Google Chrome. Lihat contoh otoritas ini.

Sebaiknya gunakan HTTP/TLS ("https://...") daripada saluran SSL tradisional.

HTTP dengan tanda tangan digital

Jika menggunakan HTTP dengan tanda tangan digital, Anda dapat membuat kunci untuk menandatanganinya sendiri. Google Siap Siaga mengharuskan Anda:

  • memberikan kunci publik Anda, dan update berikutnya pada kunci publik Anda, setidaknya 30 hari sebelum kunci lama berakhir. Tindakan ini akan mencegah gangguan yang tidak terduga pada pembaruan data Anda.
  • habis masa berlakunya dan buat kunci baru setidaknya setiap dua tahun.
  • tanda tangani peringatan Anda dengan tanda tangan sesuai dengan rekomendasi keamanan CAP ini.

Menyiapkan feed

Untuk menghosting dan mengirim pesan CAP Anda, berikan pesan tersebut di feed yang dapat diakses secara publik, seperti salah satu dari berikut:

Lihat Praktik contoh CAP: Feed CAP untuk mendapatkan panduan tentang cara mengirimkan notifikasi CAP dalam feed. Untuk mendapatkan panduan cara menyiapkan feed Atom atau RSS ke notifikasi CAP, lihat Praktik contoh CAP: Feed CAP. Sertakan link di feed web Anda ke pemberitahuan CAP lengkap seperti yang ditampilkan di sini.

Memvalidasi feed

Gunakan alat Validator CAP untuk memvalidasi feed.

Memperbarui notifikasi dan feed

Jika ada perubahan notifikasi, keluarkan notifikasi baru yang merujuk ke notifikasi sebelumnya, bukan mengubah atau menghapus notifikasi yang ada dari feed Anda. Setelah jangka waktu yang sesuai (misalnya 24-48 jam), hapus notifikasi yang dibatalkan, diperbarui, atau tidak berlaku lagi dari feed Anda.

UPDATE atau CANCEL <msgType> harus menyertakan setidaknya satu elemen <references>. Seperti yang ditentukan dalam standar CAP, setiap pesan notifikasi yang memperbarui notifikasi sebelumnya harus menggunakan <msgType>Update</msgType> dan menetapkan <references>code</references> ke semua pesan terkait sebelumnya yang belum mencapai tanggal <expires>. UPDATE atau CANCEL harus diterapkan pada pemberitahuan yang masih berlaku.

Ada tiga cara untuk MEMBATALKAN acara, dalam urutan preferensi:

  1. Tetapkan tanggal waktu <expires> untuk setiap peristiwa, dengan deskripsi pesan yang menentukan bahwa pemberitahuan ini akan berakhir sendiri.
  2. Kirim <alert> baru dengan <msgType>UPDATE, <responseType>"All Clear", dan <expires> dalam waktu singkat di masa mendatang.
  3. Publikasikan <alert> baru dengan <msgType>CANCEL.

Lihat Contoh Notifikasi untuk info terbaru dan pembatalan sebagai contoh.

Langkah berikutnya: Uji integrasi Notifikasi