Wysyłanie do Google pliku danych alertów

Ta sekcja zawiera instrukcje wysyłania alertów do Google na potrzeby testów. Jest to proces iteracyjny. W tym kroku implementacji nie zostaną opublikowane żadne alerty.

Bezpieczeństwo danych

Aby zapewnić autentyczność najważniejszych informacji, Zanim wyślesz jakiekolwiek dane, musisz opracować plan zabezpieczeń i plan konserwacji.

Możesz używać protokołu HTTP, pod warunkiem podpisania alertów, w takim przypadku możesz użyć protokołu HTTPS. W takim przypadku nie musisz ich podpisywać.

Zalecamy korzystanie z protokołu HTTPS.

HTTPS z protokołem TLS (Transport Layer Security)

HTTPS pozwala uniknąć konieczności wymiany nowych certyfikatów cyfrowych po wygaśnięciu poprzednich.

Musisz uzyskać certyfikat SSL wystawiony przez zaufany urząd certyfikacji Google Chrome. Zobacz przykładowe instytucje.

Zalecamy używanie protokołu HTTP/TLS ("https://...") zamiast tradycyjnego kanału SSL.

HTTP z podpisami cyfrowymi

Jeśli używasz podpisu cyfrowego HTTP, możesz wygenerować klucz do podpisywania samodzielnie. Komunikaty alarmowe w Google wymagają:

  • podać swój klucz publiczny i późniejsze aktualizacje klucza publicznego co najmniej 30 dni przed wygaśnięciem starego klucza. Zapobiegnie to nieoczekiwanym przerwom w aktualizacji danych.
  • wygaśnie i zostaną utworzone nowe klucze przynajmniej co 2 lata.
  • podpisz swoje alerty podpisem zgodnie z zaleceniami dotyczącymi CAP.

Konfigurowanie pliku danych

Aby hostować i dostarczać wiadomości CAP, podaj je w publicznie dostępnym kanale, np. w jednym z tych adresów:

Wskazówki dotyczące dostarczania alertów CAP w pliku danych znajdziesz w artykule Przykładowe praktyki CAP: pliki danych CAP. Wskazówki dotyczące konfigurowania kanałów Atom lub RSS pod kątem alertów CAP znajdziesz w artykule Przykładowe praktyki CAP: kanały CAP. W pliku danych umieść link do pełnego alertu CAP jak pokazano tutaj.

Weryfikowanie kanału

Użyj narzędzia do weryfikacji CAP, aby sprawdzić plik danych.

Aktualizowanie alertów i plików danych

Gdy zmieni się alert, wygeneruj nowy alert, który będzie odnosił się do poprzedniego, zamiast zmieniać lub usuwać istniejący alert z pliku danych. Po odpowiednim czasie (np. 24–48 godzin) usuń anulowane, zaktualizowane lub wygasłe alerty z pliku danych.

<msgType> ZAKTUALIZUJ lub ANULUJ musi zawierać co najmniej 1 element <references>. Zgodnie ze standardem CAP każda wiadomość, która wymaga zaktualizowania poprzedniego alertu, powinna używać wartości <msgType>Update</msgType> i ustawić w polu <references>code</references> wszystkie wcześniejsze wiadomości, które nie osiągnęły daty <expires>. Link „AKTUALIZUJ” lub „ANULUJ” musi dotyczyć alertu, którego ważność nie wygasła.

Wydarzenia możesz anulować na 3 sposoby:

  1. Ustaw sygnaturę czasową <expires> dla każdego wydarzenia z opisem komunikatu, który zakłada, że ten alert wygaśnie.
  2. Wywołaj nowe <alert> z: <msgType>UPDATE, <responseType>"All Clear" i <expires>, za chwilę.
  3. Wyemituj nowy znaczek <alert> (<msgType>CANCEL).

Przykłady znajdziesz w przykładowych alertach dotyczących anulowania i anulowania.

Następny krok: testowanie integracji alertów